Token price · API reference

Base: https://gateway.gelabs.org/market/api/v1. Always send X-API-Key. Envelope: Get started.

Endpoints

Method	Path	Purpose
GET	/chains	Supported chains
GET	/chains/{id_or_name}	One chain by id or name
GET	/quotes/latest	Latest price by token id
POST	/quotes/batch	Price by chain + contract
GET	/tokens	Token list
GET	/tokens/search/{keyword}	Search tokens
POST	/tokens/details	Details by ids
GET	/fiats	Fiat list
GET	/fiats/rates/{base}	FX rates

Latest quotes

GET /quotes/latest?ids=1,1027&fiat=USD

Param	Required	Meaning
ids	yes	Internal token ids, comma-separated
fiat	no	Fiat code, default USD

Main data.items[] fields: token_id, symbol, fiat_code, price, percent_change_24h.

Batch by contract

POST /quotes/batch

{
  "fiat": "USD",
  "token_addrs": [
    {"chain_type": "evm", "chain_id": 1, "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"}
  ]
}

Chains and tokens

curl -H "X-API-Key: $API_KEY" https://gateway.gelabs.org/market/api/v1/chains
curl -H "X-API-Key: $API_KEY" https://gateway.gelabs.org/market/api/v1/tokens/search/usdt

POST /tokens/details body: {"ids":[1,1027]}.

Errors

Typical codes: 20001 bad query, 20002 bad path / not found, 20003 bad body. Handle both HTTP 200 with code != 0 and 5xx.