[ The proof API ]

Proof sourcing, as a running service

The coordination layer behind this site is the product: 61+ chains resolved to one verifiable root, served to fintechs, CEXs, and protocols — on-chain and off — through one agentic, machine-payable API.

Get a key →API reference →Pricing →B2B integration — partners →

01 //

PROOF SOURCING

V5 blobs on demand: six layers from block to superroot, finality-typed per chain, refreshed every 10 seconds. The proof is portable — an agent carries it off-chain, any contract verifies it on-chain.

GET /api/v5/proof/blob/:chain/:block

02 //

COORDINATION

One superroot as the settlement referent: anchor reads, on-chain verifyEncoded, and the x402 payout gateway that releases escrow only when work proves. Coordination by construction, not by trust.

docs/x402-gateway · verifyEncoded(blob)

03 //

SECURE BY ISOLATION

Signing keys live behind an approval-gated enclave signer — never in the serving path. Hosted workloads run kernel-isolated per tenant with hash-chained audit logs anchored to the root.

enclave signer · microVM isolation · audit anchoring

04 //

B2B INTEGRATION

REST, SSE, and gRPC streaming under one key. USDC-metered on Base — machine-payable, no procurement cycle. Fintechs, CEXs, and protocols integrate the same rail on-chain and off.

REST + SSE + gRPC · USDC on Base

Agent-ready — wire Taifoon into your agent or MCP client today:agent quickstart →mcp endpoint →llms.txt →skills.md →ai-plugin.json →openapi.yaml →

Get a key →API reference →Pricing →B2B integration: enterprise & trust →

102 ENDPOINTS · 5 GROUPS · EVERY ONE TESTED

API Overview

Cryptographic proofs, finality verification, event indexing, oracle pricing, and trading signals — all under one SuperRoot.

START HERE · THE COORDINATION LAYEROne namespace over everything below, at taifoon.io/v1. The root that commits every chain, proofs that a transaction happened, what every route costs, and the transfers themselves. The list further down is the services behind it →

CHAINS

—live

BLOCKS

—indexed

GRIDS

5domains

ENDPOINTS

102available

root9 ENDPOINTS

ROOT

One root every proof resolves to

The root — what every proof resolves to

EXAMPLE

curl 'https://api.taifoon.dev/api/spinner/superroot'

RESPONSE

{ "root": …, "timestamp": …, "leaf_count": … }

EXAMPLE

curl 'https://api.taifoon.dev/api/mmr/superroot/breakdown'

RESPONSE

{ "chain_count": …, "chains": … }

EXAMPLE

curl 'https://api.taifoon.dev/api/mmr/chain/8453/block/51419742/proof'

RESPONSE

{ "block_hash": … }

EXAMPLE

curl 'https://www.taifoon.io/api/bridge/superroot'

RESPONSE

{ "superroot": … }

EXAMPLE

curl 'https://api.taifoon.dev/api/intel/now'

RESPONSE

{ "concentration": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/root'

RESPONSE

{ "root": …, "timestamp": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/root/latest'

RESPONSE

{ "ok": …, "root": …, "cadence": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/root/chains'

EXAMPLE

curl 'https://www.taifoon.io/v1/root/proof/8453/51569869'

proof7 ENDPOINTS

PROOF

A transaction or a log, provable on-chain

Proofs — a transaction or a log, provable on-chain

EXAMPLE

curl 'https://api.taifoon.dev/v5/proof/tx/8453/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff'

RESPONSE

{ "chain_id": …, "block_number": … }

EXAMPLE

curl 'https://arc.taifoon.dev/v1/bridge/proof/8453/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff?log_index=9'

RESPONSE

{ "verified": …, "inclusion": …, "verifier": … }

EXAMPLE

curl 'https://api.taifoon.dev/api/v5/verifiable/8453'

RESPONSE

{ "verifiableBlock": … }

EXAMPLE

curl 'https://www.taifoon.io/proof/tx/8453/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff'

EXAMPLE

curl -X POST https://www.taifoon.io/api/proof/evidence/8453 -H 'content-type: application/json' -d '{"method":"eth_getTransactionReceipt","params":["0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff"]}'

RESPONSE

{ "result": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/proof/tx/8453/0x7aa4b6470f950f305657ddf705f84a718c74093e83ccdfd0ec9566adb224e16b'

RESPONSE

{ "is_finalized": …, "block_number": …, "checks": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/proof/verifiable/8453'

routes8 ENDPOINTS

ROUTES

Chains, bridges and live prices

Routes — chains, bridges and prices

EXAMPLE

curl 'https://arc.taifoon.dev/v1/chains'

RESPONSE

{ "chain_count": …, "chains": … }

EXAMPLE

curl 'https://arc.taifoon.dev/v1/catalogue'

EXAMPLE

curl -X POST https://arc.taifoon.dev/v1/compare -H 'content-type: application/json' -d '{"src_chain_id":8453,"dst_chain_id":5042,"dst_kind":"evm","src_token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","dst_token":"0x3600000000000000000000000000000000000000","input_amount":"100000000","asset":"USDC","recipient":"0x5808980304CaF94C512884a6D1299664913E218E"}'

RESPONSE

{ "best": …, "rows": …, "vendor_status": … }

EXAMPLE

curl 'https://api.taifoon.dev/api/lambda/t3rn/orders/stats'

RESPONSE

{ "total_orders": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/chains'

RESPONSE

{ "chains": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/protocols'

EXAMPLE

curl -X POST https://www.taifoon.io/v1/compare -H 'content-type: application/json' -d '{"src_chain_id":8453,"dst_chain_id":5042,"dst_kind":"evm","asset":"USDC","src_token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","dst_token":"0x3600000000000000000000000000000000000000","input_amount":"2000000"}'

RESPONSE

{ "rows": … }

EXAMPLE

curl -X POST https://www.t3rn.io/api/arc/v1/compare -H 'content-type: application/json' -d '{"src_chain_id":8453,"dst_chain_id":5042,"dst_kind":"evm","asset":"USDC","src_token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","dst_token":"0x3600000000000000000000000000000000000000","input_amount":"2000000"}'

RESPONSE

{ "rows": …, "best": … }

bridge22 ENDPOINTS

BRIDGE

Plan, send, follow, prove

Bridge — plan, send, follow, prove

EXAMPLE

curl -X POST https://arc.taifoon.dev/v1/bridge/plan -H 'content-type: application/json' -d '{"src_chain_id":8453,"dst_chain_id":5042,"amount":1000000,"recipient":"0x5808980304CaF94C512884a6D1299664913E218E","speed":"standard"}'

RESPONSE

{ "route": …, "steps": …, "amounts_usdc_units": … }

EXAMPLE

curl 'https://arc.taifoon.dev/v1/bridge/tx/8453/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff'

RESPONSE

{ "state": …, "transitions": …, "producer": … }

EXAMPLE

curl -X POST https://arc.taifoon.dev/v1/bridge/track -H 'content-type: application/json' -d '{"chain_id":8453,"tx_hash":"0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff","via":"router"}'

RESPONSE

{ "state": … }

EXAMPLE

curl 'https://arc.taifoon.dev/v1/bridge/queue'

RESPONSE

{ "count": …, "items": … }

EXAMPLE

curl 'https://arc.taifoon.dev/v1/bridge/ledger?limit=3'

RESPONSE

{ "records": …, "summary": … }

EXAMPLE

curl 'https://arc.taifoon.dev/v1/bridge/events/8453?span=1000'

RESPONSE

{ "router": …, "events": … }

EXAMPLE

curl -N 'https://arc.taifoon.dev/v1/bridge/tx/8453/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff/stream'

RESPONSE

event: state
data: { … }

EXAMPLE

curl 'https://arc.taifoon.dev/v1/bridge/metrics'

RESPONSE

# Prometheus text exposition

EXAMPLE

curl -X POST https://arc.taifoon.dev/v1/bridge/select -H 'content-type: application/json' -d '{"src_chain_id":8453,"dst_chain_id":5042,"asset":"USDC","protocol_slug":"cctp","kind":"auto","best":true}'

RESPONSE

{ "ok": … }

EXAMPLE

curl -X POST https://arc.taifoon.dev/v1/rpc/8453 -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

RESPONSE

{ "result": … }

EXAMPLE

curl 'https://www.taifoon.io/api/bridge/whitelist'

RESPONSE

{ "needs": …, "count": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/transfers'

RESPONSE

{ "summary": … }

EXAMPLE

curl 'https://www.taifoon.io/bridge'

EXAMPLE

curl 'https://www.taifoon.io/bridge/board'

EXAMPLE

curl -X POST https://www.taifoon.io/v1/transfer/plan -H 'content-type: application/json' -d '{"src_chain_id":8453,"dst_chain_id":5042,"recipient":"0x4b10444b6f144a8766d850eb3e7bd3afcacc5e68","amount":"2000000","speed":"standard"}'

RESPONSE

{ "steps": …, "route": …, "fees": … }

EXAMPLE

curl -X POST https://www.taifoon.io/v1/transfer/plan -H 'content-type: application/json' -d '{"src_chain_id":8453,"dst_chain_id":5042,"recipient":"0x4b10444b6f144a8766d850eb3e7bd3afcacc5e68","amount":"2000000","speed":"standard","via":"lifi"}'

RESPONSE

{ "steps": …, "route": …, "fees": … }

EXAMPLE

curl 'https://www.taifoon.io/api/bridge/whitelist?product=clear'

RESPONSE

{ "product": …, "needs": …, "list": … }

EXAMPLE

curl 'https://www.taifoon.io/api/bridge/record'

RESPONSE

{ "rules": …, "max": …, "tiers": … }

EXAMPLE

curl 'https://www.taifoon.io/api/bridge/board'

RESPONSE

{ "board": …, "rules": …, "max": … }

EXAMPLE

curl 'https://www.t3rn.io/bridge'

EXAMPLE

curl 'https://www.taifoon.io/v1/transfer/8453/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff'

EXAMPLE

curl -N 'https://www.taifoon.io/v1/transfer/watch/8453/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff'

RESPONSE

event: state
data: { … }

agents56 ENDPOINTS

AGENTS

Machine-readable, for agents and codegen

For agents — machine-readable descriptions

EXAMPLE

curl 'https://arc.taifoon.dev/v1/bridge/openapi.json'

RESPONSE

{ "openapi": …, "paths": … }

EXAMPLE

curl 'https://arc.taifoon.dev/v1/bridge/tools.json'

RESPONSE

{ "tools": … }

EXAMPLE

curl 'https://www.taifoon.io/api/registry'

RESPONSE

{ "endpoints": … }

EXAMPLE

curl 'https://www.taifoon.io/api/acp/all-time'

RESPONSE

{ "jobs_created": … }

EXAMPLE

curl 'https://www.taifoon.io/api/acp/agents'

RESPONSE

{ "ok": …, "count": … }

EXAMPLE

curl 'https://www.taifoon.io/api/acp/market-report'

RESPONSE

{ "ok": … }

EXAMPLE

curl 'https://www.taifoon.io/api/acp/state'

RESPONSE

{ "contracts": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/openapi.json'

RESPONSE

{ "openapi": …, "paths": … }

EXAMPLE

curl 'https://www.taifoon.io/docs/coordination-api'

EXAMPLE

curl 'https://www.taifoon.io/api-overview'

EXAMPLE

curl 'https://www.taifoon.io/clear'

EXAMPLE

curl 'https://www.taifoon.io/v1/agents/ledger?limit=5'

RESPONSE

{ "ok": …, "jobs": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/agents/market'

RESPONSE

{ "ok": …, "observed_jobs": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/agents/contracts'

RESPONSE

{ "contracts": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/agents/who/0xccf57d593aa2cf8f8329e5e8353f69f2b21e34e9'

RESPONSE

{ "ok": …, "as_provider": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/agents/ledger?limit=2&client=0x22cbc8b546978fd414fc02cbb91d0981cf94ae40'

RESPONSE

{ "ok": …, "filters": … }

EXAMPLE

curl 'https://www.taifoon.io/integrations/n8n-unchecked-agent-work.json'

RESPONSE

{ "name": …, "nodes": …, "connections": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/agents/ledger?state=completed&verify=self&limit=5'

RESPONSE

{ "ok": …, "jobs": …, "filters": … }

EXAMPLE

curl 'https://www.taifoon.io/docs/n8n'

EXAMPLE

curl 'https://www.taifoon.io/v1/jobs?limit=5'

RESPONSE

{ "ok": …, "endings": …, "jobs": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/pools?limit=5'

RESPONSE

{ "ok": …, "pools": …, "sellers": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/protocols/agents'

RESPONSE

{ "ok": …, "protocols": …, "count": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/standards'

RESPONSE

{ "ok": …, "deployments": …, "events": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/scan?blocks=500'

RESPONSE

{ "ok": …, "observations": …, "by_event": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/directory?blocks=2000&cards=4'

RESPONSE

{ "ok": …, "protocols": … }

EXAMPLE

curl -X POST https://www.taifoon.io/v1/attest/hire -H 'content-type: application/json' -d '{"agentAddress":"0xA17d...9f3C","jobsClaimed":214,"txHash":"0x8fd3c2a1b7e94506d21f8ac0e35b9147de620ff4a9c318bb5027e1d4f6a90c72","chainId":8453}'

RESPONSE

{ "ok": …, "verdict": …, "checks": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/ecosystems'

RESPONSE

{ "ok": …, "ecosystems": …, "overlap": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/n8n/catalog'

RESPONSE

{ "ok": …, "tools": …, "n8n_library": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/agents/cards?limit=5&blocks=4000'

RESPONSE

{ "ok": …, "cards": …, "counted": … }

EXAMPLE

curl -X POST https://www.taifoon.io/v1/match -H 'content-type: application/json' -d '{"required_skills":["chain-analytics"],"budget_usdc":1}'

RESPONSE

{ "ok": …, "candidates": …, "searched": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/vault/policy'

RESPONSE

{ "ok": …, "policy": …, "status": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/agents/jobs'

RESPONSE

{ "ok": …, "jobs_created": …, "funded_usdc": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/agents/providers'

RESPONSE

{ "ok": …, "count": … }

EXAMPLE

curl -X POST https://www.taifoon.io/v1/vault/policy -H 'content-type: application/json' -d '{"action":"register-agent","to":"0x8004a169fb4a3325136eb29fa0ceb6d2e539a432","chainId":8453}'

RESPONSE

{ "ok": …, "decision": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/jobs?since=0&limit=2'

RESPONSE

{ "ok": …, "cursor": …, "jobs": …, "available_now": …, "more": … }

EXAMPLE

curl -X POST https://www.taifoon.io/v1/jobs -H 'content-type: application/json' -d '{"chainId":8453,"seller":"0xccf57d593aa2cf8f8329e5e8353f69f2b21e34e9","price":"10000"}'

RESPONSE

{ "ok": …, "jobId": …, "terms": …, "calls": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/relayer/whoami'

RESPONSE

{ "error": … }

EXAMPLE

curl -X POST https://www.taifoon.io/v1/jobs/0x1111111111111111111111111111111111111111111111111111111111111111/complete -H 'content-type: application/json' -d '{}'

RESPONSE

{ "error": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/jobs/0x1111111111111111111111111111111111111111111111111111111111111111/complete?nonce=probe'

RESPONSE

{ "error": … }

EXAMPLE

curl -X POST https://www.taifoon.io/v1/handshake -H 'content-type: application/json' -d '{}'

RESPONSE

{ "error": …, "problems": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/handshake/hs_b5b4477af4586bfc869073c9'

RESPONSE

{ "ok": …, "handshake_id": …, "state": …, "events": … }

EXAMPLE

curl -X POST https://www.taifoon.io/v1/handshake/hs_b5b4477af4586bfc869073c9 -H 'content-type: application/json' -d '{}'

RESPONSE

{ "error": … }

EXAMPLE

curl -X POST https://www.taifoon.io/v1/agents/register -H 'content-type: application/json' -d '{}'

RESPONSE

{ "error": …, "card_shape": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/agents/registered'

RESPONSE

{ "ok": …, "count": …, "agents": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/harvest'

RESPONSE

{ "ok": …, "agentCounts": …, "coverage": …, "ageSeconds": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/harvest?view=candidates'

RESPONSE

{ "ok": …, "candidates": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/harvest?view=coverage'

RESPONSE

{ "ok": …, "coverage": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/capabilities'

RESPONSE

{ "ok": …, "hireable": …, "sources": …, "templates": …, "nodes": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/capabilities/skills'

RESPONSE

{ "ok": …, "hireable": …, "skills": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/assurance'

RESPONSE

{ "ok": …, "chains": …, "rules": … }

EXAMPLE

curl -X POST https://www.taifoon.io/v1/assurance/quote -H 'content-type: application/json' -d '{"chainId":8453,"seller":"0xccf57d593aa2cf8f8329e5e8353f69f2b21e34e9","price":"10000"}'

RESPONSE

{ "ok": …, "premium": …, "terms": …, "record": … }

EXAMPLE

curl -X POST https://www.taifoon.io/v1/assurance/call -H 'content-type: application/json' -d '{"chainId":8453,"action":{"kind":"complete","jobId":"0x1111111111111111111111111111111111111111111111111111111111111111"}}'

RESPONSE

{ "ok": …, "calls": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/capabilities/search?q=telegram&limit=2'

RESPONSE

{ "ok": …, "hireable": …, "matching": …, "results": … }

EXAMPLE

curl -X POST https://www.taifoon.io/v1/enroll/plan -H 'content-type: application/json' -d '{}'

RESPONSE

{ "error": …, "example": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/our-card'

RESPONSE

{ "address": …, "kind": …, "skills": …, "endpoint": … }

EXAMPLE

curl 'https://www.taifoon.io/v1/agents/payments?limit=2'

RESPONSE

{ "ok": …, "verified": …, "rollup": …, "agents": … }

BASE URL

api.taifoon.dev

AUTHENTICATION

X-Taifoon-Key header

100 req/min (no key) · 5,000 req/min (paid)

RESPONSE FORMAT

JSON + V5 proof anchors

Merkle siblings for trustless verification

FULL API DOCS→QUICKSTART GUIDE→PRICING TIERS→