Bridge Protocol Ranking

GET/gateway/v1/onchain/bridge/ranking

List bridge protocols ranked by USD volume over a time range. Example: use this when you need bridge leaderboard data instead of raw SQL.

Query Parameters

time_rangeenum<string>

Window to aggregate bridge volume over: `7d`, `30d`, `90d`, `180d`, `1y`, or `all`. Returns a single ranked snapshot (not a time-series). This endpoint uses `time_range` only — it does NOT accept `interval`.

Available options:7d30d90d180d1yall

Example: 30d

limitinteger

Results per page

Example: 20

offsetinteger

Pagination offset

Example: 0

Bridge Protocol Ranking

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/onchain/bridge/ranking?time_range=30d&limit=20&offset=0', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseBridgeRankingItem.json",
  "data": [
    {
      "project": "<string>",
      "tx_count": 123,
      "volume_usd": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}