POST
/
api
/
v1
/
developer
/
tokens
Get Tokens
curl --request POST \
  --url https://api.allium.so/api/v1/developer/tokens \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '[
  {
    "chain": "string",
    "token_address": "string"
  }
]'
[
  {
    "object": "token",
    "chain": "<string>",
    "address": "<string>",
    "type": "native",
    "price": 123,
    "decimals": 123,
    "info": {
      "name": "<string>",
      "symbol": "<string>"
    },
    "attributes": {
      "total_liquidity_usd": 123,
      "price_diff_1d": 123,
      "price_diff_pct_1d": 123,
      "total_supply": 123,
      "total_market_cap_usd": 123,
      "volume_1h": 123,
      "volume_24h": 123,
      "volume_usd_1h": 123,
      "volume_usd_24h": 123
    }
  }
]
This endpoint returns token details. Here are the attributes you can request for:
  • prices (?with_price_info=true)
  • decimals (?with_price_info=true)
  • total liquidity (?with_liquidity_info=true)
  • total supply (?with_supply_info=true)
  • market cap (?with_supply_info=true)
  • 1h and 24h volume (?with_volume=true)
Supported Chains

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
with_price_info
boolean
default:false

If true, returns price data.

​
with_liquidity_info
boolean
default:false

If true, returns total_liquidity_usd. See https://docs.allium.so/developer/data-tips#token-liquidity for more details.

​
with_supply_info
boolean
default:false

If true, returns total supply.

​
with_volume
boolean
default:false

If true, returns 1h and 24h volume data.

Body

application/json · PayloadTokenAddress · object[]

The body is of type PayloadTokenAddress · object[].

Response

200
application/json

Successful Response

The response is of type Token · object[].