API · 3 of 5
Chains, RPC, gas and routes
The chains the layer reads, an RPC endpoint per chain, gas per chain, and what every way of moving value between two chains costs, priced at once.
THE COORDINATION LAYER · one namespace at https://coord.taifoon.dev/v1 · 8 operations on this page · machine-readable at /v1/openapi.json (see Reference)
Try it
The chains and the protocols that move value between them, an RPC endpoint ranked by health, and gas on Base.
curl https://coord.taifoon.dev/v1/chains
curl https://coord.taifoon.dev/v1/rpc/8453
curl https://coord.taifoon.dev/v1/gas/8453Price 2 USDC from Base to Arc across every route at once. Amounts are in the token's smallest units.
curl -X POST https://coord.taifoon.dev/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"}'Each row says how it was priced. source: "vendor" is the protocol's own quote; source: "synthetic" is an estimate from the protocol's fee model, not a price. When priced is false, a fee of 0 means unknown, not free.
The same route reads are served by the bridge gateway directly at https://arc.taifoon.dev/v1/ (v1/compare, v1/chains, v1/catalogue, v1/health). A browser calls them through the same-origin proxy /api/arc/, for example https://www.taifoon.io/api/arc/v1/chains. Filling a route spends solver funds and is not a public endpoint.
To send JSON-RPC calls through the layer, see Use it as an RPC.
Every operation (8)
Each row is generated from the table that routes /v1. The answer of each operation, field by field, is in the OpenAPI document; see Reference.
| Operation | What it does | Auth |
|---|---|---|
GET /v1/chains | Every chain the layer can move value between. | none |
GET /v1/rpc | Every chain the RPC gateway serves (chain-agnostic JSON-RPC at /gw/rpc/{chainId}: the same methods on every chain), with the warmbed rotation’s current best endpoint and its health. Prices and limits: GET /v1/access. | none |
GET /v1/rpc/:chain | One chain’s RPC rotation as warmbed measured it: every endpoint, best first, with its health. | none |
GET /v1/gas | What gas costs now on every chain the layer prices: Base, Arbitrum, Arc, Robinhood Chain, Monad and Solana, from razor. | none |
GET /v1/gas/:chain | One chain’s gas reading from razor: base fee, priority-fee percentiles, the L1 data fee, the native USD price and the p95 rise of the fee over a horizon. | none |
GET /v1/gas/:chain/quote | What N transactions of one shape cost on a chain now, in wei (or lamports), the native token and USD. | none |
GET /v1/protocols | Every bridge and protocol we can price. | none |
POST /v1/compare | Price one transfer across every protocol at once. | none |
