API: Tokens

Token metadata, holder lists, transfer events, and USD pricing via the 3-tier price engine.

Endpoints

GET /api/tokens

Returns all tracked tokens defined in the protocol configuration.

Response:

{
  "tokens": [
    {
      "symbol": "OEC",
      "name": "Oeconomia",
      "address": "0x00904218319a045a96d776ec6a970f54741208e6",
      "decimals": 18,
      "protocol": "oeconomia",
      "color": "#da1cfe",
      "logo": "https://...",
      "official": true
    }
  ]
}

GET /api/tokens/:address

Returns token metadata with current USD price from the 3-tier price engine.

Response:

circle-info

Token prices are cached for 5 minutes to reduce Alchemy compute unit usage. See Price Engine for details on the 3-tier pricing strategy.

GET /api/tokens/:address/holders

Returns top token holders with cached balances.

Query Parameters:

Parameter
Type
Default
Description

limit

number

25

Number of holders to return

offset

number

0

Pagination offset

Response:

GET /api/tokens/:address/events

Returns Transfer events for the token, decoded from the token_transfers table.

Last updated