Cross-chain bridges

Query bridge-volume rankings, covered chains and snapshot times.

GET/api/v1/onchain/bridges
Domain
Network & Protocol
Level
Bridge ranking arrays inside a data object.
MCP tool
bridge_flows

Available data

Returns
Query bridge-volume rankings, covered chains and snapshot times.
What each request returns
Bridge ranking arrays inside a data object.

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Bridge query

bridge_rankings is callable. chain_flows is coming soon and cannot be executed; its API currently returns 501

scopestringqueryExamplebridge_rankingsoptional

bridge_rankings (default); chain_flows is unavailable. all is not supported. · bridge_rankings / chain_flows · Default: bridge_rankings

Filters
chain_idstringqueryoptional

Canonical chain_* ID, for example chain_ethereum

bridge_idstringqueryoptional

Bridge identifier from a returned bridge row; for example 73

Sort order
bridge_sortstringqueryoptional

Ranking sort field. · volume_24h_usd / volume_7d_usd / volume_30d_usd

orderstringqueryoptional

Sort direction. · asc / desc · Default: desc

Return options
limitintegerqueryExample2optional

Maximum rows returned. · Default: 20 · ≥ 1 · ≤ 100

Response

dataobject

Business data; shape is specific to this endpoint

bridge_rankingsobject[]

Array of bridge ranking rows; there is no items wrapper

chain_netflow_rankingsobject[]

Currently unavailable; do not interpret an empty array as zero net inflow

bridge_rankings[]array[object]
bridge_idstring

Bridge identifier; reuse the returned ID for filtering

namestring

Display name

display_namestring

Display name

slugstring

Source slug

urlstring

Official website

chainsstring[]

Covered chain names

covered_chain_countinteger

Number of covered chains

last_24h_volumestring

Rolling 24-hour bridge volume in USD; not chain net inflow

last_daily_volumestring

Latest daily bridge volume in USD; distinct from rolling 24-hour volume

weekly_volumestring

Weekly bridge volume in USD

monthly_volumestring

Monthly bridge volume in USD

snapshot_timestring

Business snapshot time of this record, distinct from response time

data_statusDataStatus

Business status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage

errornull | string | object

Null on success; otherwise an error string or object

empty_reasonstring

Reason for an empty or unavailable result; may be absent

missing_fieldsstring[]

Fields not supplied by the source

coverage_fromstring

First date actually returned, not the requested start

coverage_tostring

Last date actually returned, not a guarantee of continuous coverage

coverage_notestring

Coverage and methodology notes

request_idstring

Request trace identifier

operation_idstring

Operation identifier

route_codestring

Response route identifier

observed_atstring

Response observation time; not the business snapshot date

metadataobject

Response metadata

updated_atstring

Metadata update time; not the business data time

object_refsobject[]

Matched object references

limitationsstring[]

Coverage or source limitations

Errors & fallback

200
Only part of the requested data is available. Inspect missing_fields, limitations and actual coverage.
400
Invalid parameter format, time range, scope, sorting or limit. Use the endpoint-specific rules above.
400
Conflicting parameters: pool_id with protocol_id, or a sort field for a different bridge scope.
501
The requested chain_flows scope is not implemented.
401
Check the API key.
403
Check data-domain permissions for the key.