Sign in

v8

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-01124480.3 KB
V1

Find one token by chain and address or symbol

Returns metadata for a single token on a specific chain. The token query parameter can be a token address or symbol.

get/v1/token

Query parameters

chainstring required
Example:8453

Chain ID or chain key, for example 8453 or sol.

tokenstring required
Example:USDC

Token address or symbol.

Headers

x-api-keystring

Optional API key for higher rate limits and fee rules.

Response

Token metadata response.

addressstring required
symbolstring required
decimalsnumber required
chainIdnumber required
namestring required
coinKeystring required
priceUSDstring

Cached USD price as a decimal string, when available.

priceUpdatedAtstring

Timestamp of the cached token price, when available.

priceSourcestring

Price source used for the cached token price, when available.

priceStaleboolean

Whether the cached token price is outside Delora's freshness window.

priceTier'hot' | 'cold'

Price refresh tier. hot tokens are prioritized for fresher cached prices; cold tokens refresh less aggressively.

logoURIstring

Example response

{
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "symbol": "USDC",
  "decimals": 6,
  "chainId": 8453,
  "name": "USD Coin",
  "coinKey": "USDC",
  "priceUSD": "1.00",
  "priceUpdatedAt": "2026-06-22T12:00:00.000Z",
  "priceSource": "dexscreener",
  "priceTier": "cold",
  "logoURI": "https://example.com/usdc.png"
}