POST
/
api
/
v1
/
developer
/
tokens
/
chain-address
Get Tokens
curl --request POST \
  --url https://api.allium.so/api/v1/developer/tokens/chain-address \
  --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": {
        "amount": 123,
        "details": "<string>"
      },
      "price_diff_1d": 123,
      "price_diff_pct_1d": 123,
      "total_supply": 123,
      "fully_diluted_valuation_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[]
token_address
string
required
chain
string
required

Response

Successful Response

chain
string
required
address
string
required
object
string
default:token
Allowed value: "token"
type
enum<string> | null
Available options:
native,
evm_erc20,
evm_erc721,
evm_erc1155,
sol_spl,
sui_token
price
number | null
decimals
integer | null
info
object | null
attributes
object | null