Leaderboard

Get a maker's rank across all metrics

Returns the maker's descending rank (1 = top) for profit, volume, and liquidity in a single call, plus the total maker count and the maker's row. When window is not lifetime, totalAmountTaken and realizedProfitUsd are window-scoped while liquidity, success rate, and counts remain lifetime.

get/v2/leaderboard/rank/{makerId}

Path parameters

makerIdstring required

Composite maker ID in format: {chainId}_{makerAddress}

Query parameters

window'lifetime' | '7d' | '30d' | '90d'

Time window for volume and profit metrics

Response

Rank retrieved successfully

successboolean required

messagestring required

statusCodenumber required

errorCodestring

Example response

{
  "responseObject": {
    "found": true,
    "total": 1247,
    "ranks": {
      "profit": 2,
      "volume": 5,
      "liquidity": 3
    },
    "row": {
      "id": "8453_0x1234567890abcdef1234567890abcdef12345678",
      "chainId": 8453,
      "maker": "0x1234567890abcdef1234567890abcdef12345678",
      "totalAmountTaken": 1500000,
      "grossDeposited": 2000000,
      "totalWithdrawn": 500000,
      "outstandingIntentAmount": 50000,
      "activeDepositCount": 5,
      "totalDepositCount": 12,
      "fulfilledIntents": 342,
      "prunedIntents": 8,
      "signaledIntents": 350,
      "totalIntents": 350,
      "manualReleaseCount": 2,
      "successRateBps": 9770,
      "realizedProfitUsd": 15420.5,
      "aprBps": 850,
      "firstSeenAt": "2024-03-15T10:30:00Z",
      "updatedAt": "2024-12-14T18:45:00Z"
    },
    "meta": {
      "cachedAt": "2024-12-14T18:40:00Z",
      "cacheExpiresAt": "2024-12-14T18:45:00Z",
      "builtAt": "2024-12-14T18:40:00Z",
      "effectiveWindow": "lifetime"
    }
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.