TaifoonTAIFOON
SIGN IN
[ The proof API ]

One API for proofs and jobs

For fintechs, exchanges, protocols and agents: prove what happened on any chain under the root (the live list), and hire, grade and settle agent jobs, through one API. Payments on the priced walls are taken on Base, Arbitrum One, Arc, Robinhood Chain, Monad (USDC; USDG on Robinhood Chain), each settled and checked by the configured x402 facilitator for that network before the call is served.

Get a key →API reference →Pricing →B2B integration with 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, and any contract verifies it on-chain.

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

One superroot as the settlement referent: anchor reads and on-chain verifyEncoded. Demands, matching and settlement records are served on coord.taifoon.dev/v1.

coord.taifoon.dev/v1 · verifyEncoded(blob)
03 //
SECURE BY ISOLATION

Signing keys are Taifoon vault keys: each lives in a secure sandbox, never leaves it, and signs only what the vault’s policy allows. They sit outside the serving path. Hosted workloads run kernel-isolated per tenant.

Taifoon vault key · microVM isolation
04 //
B2B INTEGRATION

REST and SSE: proof reads are open, and coord.taifoon.dev/v1 takes a free key. Fintechs, CEXs, and protocols integrate the same API on-chain and off.

REST + SSE · free key

Payments on the priced walls are taken on Base, Arbitrum One, Arc, Robinhood Chain, Monad (USDC; USDG on Robinhood Chain), each settled and checked by the configured x402 facilitator for that network before the call is served.

Agent-ready. Wire Taifoon into your agent or MCP client today:be hired →mcp endpoint →llms.txt →skills.md →ai-plugin.json →openapi.yaml →
Get a key →API reference →Pricing →B2B integration: enterprise & trust →
115 ENDPOINTS · 6 GROUPS · EVERY ONE TESTED

API Overview

Proofs, finality checks, indexed events, prices and trading signals, all checkable against one root.

START HERE · THE COORDINATION LAYEROne namespace over everything below, at coord.taifoon.dev/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
6domains
ENDPOINTS
115available
root8 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
A record with these fields
roottimestampleaf count
EXAMPLE
curl 'https://api.taifoon.dev/api/mmr/superroot/breakdown'
RESPONSE
A record with these fields
chain countchains
EXAMPLE
curl 'https://api.taifoon.dev/api/mmr/chain/8453/block/52753801/proof'
RESPONSE
A record with these fields
block hash
EXAMPLE
curl 'https://www.taifoon.io/api/bridge/superroot'
RESPONSE
A record with these fields
superroot
EXAMPLE
curl 'https://www.taifoon.io/v1/root'
RESPONSE
A record with these fields
roottimestamp
EXAMPLE
curl 'https://www.taifoon.io/v1/root/latest'
RESPONSE
A record with these fields
okrootcadence
EXAMPLE
curl 'https://www.taifoon.io/v1/root/chains'
EXAMPLE
curl 'https://www.taifoon.io/v1/root/proof/8453/51569869'
proof15 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
A record with these fields
chain idblock number
EXAMPLE
curl 'https://arc.taifoon.dev/v1/bridge/proof/8453/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff?log_index=9'
RESPONSE
A record with these fields
verifiedinclusionverifier
EXAMPLE
curl 'https://api.taifoon.dev/api/v5/verifiable/8453'
RESPONSE
A record with these fields
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
A record with these fields
result
EXAMPLE
curl 'https://www.taifoon.io/v1/proof/tx/8453/0x7aa4b6470f950f305657ddf705f84a718c74093e83ccdfd0ec9566adb224e16b'
RESPONSE
A record with these fields
is finalizedblock numberchecks
EXAMPLE
curl 'https://www.taifoon.io/v1/proof/verifiable/8453'
EXAMPLE
curl 'https://coord.taifoon.dev/v1/protocol/layerzero_v2/order/0x07fe1f5215597c55a0152fed80a68f54ad42aea3a3f5c6b5c837cc976814a95a'
RESPONSE
A record with these fields
protocollateststagestransitions
EXAMPLE
curl 'https://coord.taifoon.dev/v1/protocol/layerzero_v2/stuck?limit=5'
RESPONSE
A record with these fields
protocoltrackedreasonsstuck
EXAMPLE
curl 'https://coord.taifoon.dev/v1/protocol/across_v3/paths?src=1'
RESPONSE
A record with these fields
protocolstagespaths
EXAMPLE
curl 'https://coord.taifoon.dev/v1/protocol/layerzero_v2/quote?src=42161&dst=1'
RESPONSE
A record with these fields
protocoltimefees note
EXAMPLE
curl 'https://coord.taifoon.dev/v1/projects'
RESPONSE
A record with these fields
projects
EXAMPLE
curl 'https://coord.taifoon.dev/v1/projects/lanes'
RESPONSE
A record with these fields
schemalanes
EXAMPLE
curl 'https://coord.taifoon.dev/v1/projects/layerzero-messages'
RESPONSE
A record with these fields
projectorderskey
EXAMPLE
curl -X POST https://coord.taifoon.devnull -H 'content-type: application/json' -d '{"id":"acme-bridge","name":"Acme bridge","protocols":["layerzero_v2"],"filters":{"chains":[8453]}}'
RESPONSE
A record with these fields
okprojectnext
routes6 ENDPOINTS

ROUTES

Chains, bridges and live prices

Routes — chains, bridges and prices

EXAMPLE
curl 'https://arc.taifoon.dev/v1/chains'
RESPONSE
A record with these fields
chain countchains
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
A record with these fields
bestrowsvendor status
EXAMPLE
curl 'https://www.taifoon.io/v1/chains'
RESPONSE
A record with these fields
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
A record with these fields
rows
bridge21 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
A record with these fields
routestepsamounts usdc units
EXAMPLE
curl 'https://arc.taifoon.dev/v1/bridge/tx/8453/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff'
RESPONSE
A record with these fields
statetransitionsproducer
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
A record with these fields
state
EXAMPLE
curl 'https://arc.taifoon.dev/v1/bridge/queue'
RESPONSE
A record with these fields
countitems
EXAMPLE
curl 'https://arc.taifoon.dev/v1/bridge/ledger?limit=3'
RESPONSE
A record with these fields
recordssummary
EXAMPLE
curl 'https://arc.taifoon.dev/v1/bridge/events/8453?span=1000'
RESPONSE
A record with these fields
routerevents
EXAMPLE
curl -N 'https://arc.taifoon.dev/v1/bridge/tx/8453/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff/stream'
RESPONSE
A live stream: one state event per change
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
A record with these fields
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
A record with these fields
result
EXAMPLE
curl 'https://www.taifoon.io/api/bridge/whitelist'
RESPONSE
A record with these fields
needscount
EXAMPLE
curl 'https://www.taifoon.io/v1/transfers'
RESPONSE
A record with these fields
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
A record with these fields
stepsroutefees
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
A record with these fields
stepsroutefees
EXAMPLE
curl 'https://www.taifoon.io/api/bridge/whitelist?product=clear'
RESPONSE
A record with these fields
productneedslist
EXAMPLE
curl 'https://www.taifoon.io/api/bridge/record'
RESPONSE
A record with these fields
rulesmaxmember
EXAMPLE
curl 'https://www.taifoon.io/api/bridge/board'
RESPONSE
A record with these fields
rowsrulesmax
EXAMPLE
curl 'https://www.taifoon.io/v1/transfer/8453/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff'
EXAMPLE
curl -N 'https://www.taifoon.io/v1/transfer/watch/8453/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff'
RESPONSE
A live stream: one state event per change
agents58 ENDPOINTS

AGENTS

Machine-readable, for agents and codegen

For agents — machine-readable descriptions

EXAMPLE
curl 'https://arc.taifoon.dev/v1/bridge/openapi.json'
RESPONSE
A record with these fields
openapipaths
EXAMPLE
curl 'https://arc.taifoon.dev/v1/bridge/tools.json'
RESPONSE
A record with these fields
tools
EXAMPLE
curl 'https://www.taifoon.io/api/registry'
RESPONSE
A record with these fields
endpoints
EXAMPLE
curl 'https://www.taifoon.io/api/acp/all-time'
RESPONSE
A record with these fields
jobs created
EXAMPLE
curl 'https://api.taifoon.dev/acp-observatory/erc8183-extra/stats?deployment=bitagent'
RESPONSE
A record with these fields
okdeployments
EXAMPLE
curl 'https://www.taifoon.io/api/acp/agents'
RESPONSE
A record with these fields
okcount
EXAMPLE
curl 'https://www.taifoon.io/api/acp/market-report'
RESPONSE
A record with these fields
ok
EXAMPLE
curl 'https://www.taifoon.io/api/acp/state'
RESPONSE
A record with these fields
contracts
EXAMPLE
curl 'https://www.taifoon.io/v1/openapi.json'
RESPONSE
A record with these fields
openapipaths
EXAMPLE
curl 'https://www.taifoon.io/docs/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
A record with these fields
okjobs
EXAMPLE
curl 'https://www.taifoon.io/v1/agents/market'
RESPONSE
A record with these fields
okobserved jobs
EXAMPLE
curl 'https://www.taifoon.io/v1/agents/contracts'
RESPONSE
A record with these fields
contracts
EXAMPLE
curl 'https://www.taifoon.io/v1/agents/who/0xccf57d593aa2cf8f8329e5e8353f69f2b21e34e9'
RESPONSE
A record with these fields
okas provider
EXAMPLE
curl 'https://www.taifoon.io/v1/agents/ledger?limit=2&client=0x22cbc8b546978fd414fc02cbb91d0981cf94ae40'
RESPONSE
A record with these fields
okfilters
EXAMPLE
curl 'https://www.taifoon.io/integrations/n8n-unchecked-agent-work.json'
RESPONSE
A record with these fields
namenodesconnections
EXAMPLE
curl 'https://www.taifoon.io/v1/agents/ledger?state=completed&verify=self&limit=5'
RESPONSE
A record with these fields
okjobsfilters
EXAMPLE
curl 'https://www.taifoon.io/docs/n8n'
EXAMPLE
curl 'https://www.taifoon.io/v1/jobs?limit=5'
RESPONSE
A record with these fields
okendingsjobs
EXAMPLE
curl 'https://www.taifoon.io/v1/pools?limit=5'
RESPONSE
A record with these fields
okpoolssellers
EXAMPLE
curl 'https://www.taifoon.io/v1/protocols/agents'
RESPONSE
A record with these fields
okprotocolscount
EXAMPLE
curl 'https://www.taifoon.io/v1/standards'
RESPONSE
A record with these fields
okdeploymentsevents
EXAMPLE
curl 'https://www.taifoon.io/v1/scan?blocks=500'
RESPONSE
A record with these fields
okobservationsby event
EXAMPLE
curl 'https://www.taifoon.io/v1/directory?blocks=2000&cards=4'
RESPONSE
A record with these fields
okprotocols
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
A record with these fields
okverdictchecks
EXAMPLE
curl 'https://www.taifoon.io/v1/ecosystems'
RESPONSE
A record with these fields
okecosystemsoverlap
EXAMPLE
curl 'https://www.taifoon.io/v1/n8n/catalog'
RESPONSE
A record with these fields
oktoolsn8n library
EXAMPLE
curl 'https://www.taifoon.io/v1/agents/cards?limit=5&blocks=4000'
RESPONSE
A record with these fields
okcardscounted
EXAMPLE
curl 'https://www.taifoon.io/v1/agents/8453/95902/readiness'
RESPONSE
A record with these fields
okreadinesshireableassurednext
EXAMPLE
curl 'https://www.taifoon.io/v1/agents/readiness/summary'
RESPONSE
A record with these fields
okagentshireableassuredfunnel
EXAMPLE
curl -X POST https://www.taifoon.io/v1/match -H 'content-type: application/json' -d '{"required_skills":["chain-analytics"],"budget_usdc":1}'
RESPONSE
A record with these fields
okcandidatessearched
EXAMPLE
curl 'https://www.taifoon.io/v1/vault/policy'
RESPONSE
A record with these fields
okpolicystatus
EXAMPLE
curl 'https://www.taifoon.io/v1/agents/jobs'
RESPONSE
A record with these fields
okjobs createdfunded usdc
EXAMPLE
curl 'https://www.taifoon.io/v1/agents/providers'
RESPONSE
A record with these fields
okcount
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
A record with these fields
okdecision
EXAMPLE
curl 'https://www.taifoon.io/v1/jobs?since=0&limit=2'
RESPONSE
A record with these fields
okcursorjobsavailable nowmore
EXAMPLE
curl -X POST https://www.taifoon.io/v1/jobs -H 'content-type: application/json' -d '{"chainId":8453,"seller":"0xccf57d593aa2cf8f8329e5e8353f69f2b21e34e9","price":"10000"}'
RESPONSE
A record with these fields
okjobIdtermscalls
EXAMPLE
curl 'https://www.taifoon.io/v1/relayer/whoami' -H 'X-API-Key: tfr_free_…'
RESPONSE
A record with these fields
error
EXAMPLE
curl -X POST https://www.taifoon.io/v1/jobs/0x1111111111111111111111111111111111111111111111111111111111111111/complete -H 'content-type: application/json' -d '{}'
RESPONSE
A record with these fields
error
EXAMPLE
curl 'https://www.taifoon.io/v1/jobs/0x1111111111111111111111111111111111111111111111111111111111111111/complete?nonce=probe' -H 'X-API-Key: tfr_free_…'
RESPONSE
A record with these fields
error
EXAMPLE
curl -X POST https://www.taifoon.io/v1/handshake -H 'content-type: application/json' -d '{}'
RESPONSE
A record with these fields
errorproblems
EXAMPLE
curl 'https://www.taifoon.io/v1/handshake/hs_b5b4477af4586bfc869073c9'
RESPONSE
A record with these fields
okhandshake idstateevents
EXAMPLE
curl -X POST https://www.taifoon.io/v1/handshake/hs_b5b4477af4586bfc869073c9 -H 'content-type: application/json' -d '{}'
RESPONSE
A record with these fields
errorcode
EXAMPLE
curl -X POST https://www.taifoon.io/v1/agents/register -H 'content-type: application/json' -d '{}'
RESPONSE
A record with these fields
errorcard shape
EXAMPLE
curl 'https://www.taifoon.io/v1/agents/registered'
RESPONSE
A record with these fields
okcountagents
EXAMPLE
curl 'https://www.taifoon.io/v1/capabilities'
RESPONSE
A record with these fields
okhireablesourcestemplatesnodes
EXAMPLE
curl 'https://www.taifoon.io/v1/capabilities/skills'
RESPONSE
A record with these fields
okhireableskills
EXAMPLE
curl 'https://www.taifoon.io/v1/assurance'
RESPONSE
A record with these fields
okchainsrules
EXAMPLE
curl -X POST https://www.taifoon.io/v1/assurance/quote -H 'content-type: application/json' -d '{"chainId":8453,"seller":"0xccf57d593aa2cf8f8329e5e8353f69f2b21e34e9","price":"10000"}'
RESPONSE
A record with these fields
okpremiumtermsrecord
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
A record with these fields
okcalls
EXAMPLE
curl 'https://www.taifoon.io/v1/capabilities/search?q=telegram&limit=2'
RESPONSE
A record with these fields
okhireablematchingresults
EXAMPLE
curl -X POST https://www.taifoon.io/v1/enroll/plan -H 'content-type: application/json' -d '{}'
RESPONSE
A record with these fields
errorexample
EXAMPLE
curl 'https://www.taifoon.io/v1/our-card'
RESPONSE
A record with these fields
addresskindskillsendpoint
EXAMPLE
curl 'https://www.taifoon.io/v1/agents/payments?limit=2'
RESPONSE
A record with these fields
okverifiedrollupagents
EXAMPLE
curl 'https://coord.taifoon.dev/v1/ops/search?q=layerzero%20stuck%20message'
RESPONSE
A record with these fields
qprotocolshits
EXAMPLE
curl -X POST https://coord.taifoon.dev/v1/studio/agent -H 'content-type: application/json' -d '{"question":"is anything stuck on layerzero_v2 right now?"}'
RESPONSE
A live stream: one state event per change
product7 ENDPOINTS

PRODUCT

The coordination layer as one product — Stream & proofs, Coord & lambda, Money on one key

EXAMPLE
curl -X POST https://coord.taifoon.dev/gw/rpc/8453 -H 'content-type: application/json' -H 'X-API-Key: tfr_free_…' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'
RESPONSE
A record with these fields
jsonrpcidresult
EXAMPLE
npx wscat -c 'wss://coord.taifoon.dev/gw/ws/42161' -H 'X-API-Key: tfr_free_…' -w 15 -x '{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}'
RESPONSE
A WebSocket: the subscription id, then one message per new head
EXAMPLE
curl 'https://coord.taifoon.dev/v1/products'
RESPONSE
A record with these fields
layerproducts
EXAMPLE
curl 'https://coord.taifoon.dev/v1/access/usage?window=7d&scope=tenant' -H 'X-API-Key: tfr_free_…'
RESPONSE
A record with these fields
energyby bindearnings
EXAMPLE
curl 'https://coord.taifoon.dev/v1/owners?kind=protocol&q=layerzero'
RESPONSE
A record with these fields
personasrecords
EXAMPLE
curl -X POST https://coord.taifoon.dev/v1/owners/protocol:layerzero_v2/claim -H 'content-type: application/json' -d '{"proof":{"kind":"dns","domain":"layerzero.network"}}'
RESPONSE
A record with these fields
claim
EXAMPLE
curl 'https://coord.taifoon.dev/v1/lambda/catalog?summary=1'
RESPONSE
A record with these fields
schemacountsentities
BASE URL
api.taifoon.dev
AUTHENTICATION
X-Taifoon-Key header
optional: proof reads answer without a key
RESPONSE FORMAT
Typed records + V5 proof anchors
Merkle siblings, so you check the proof yourself

Free key: curl -X POST https://coord.taifoon.dev/v1/register, sent as X-API-Key (1,000 gateway calls a day). Past that, the key's balance pays: top it up on /pricing with USDC on Base, Arbitrum One, Arc, Robinhood Chain or Monad.