Skip to main content
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 '
[
  {
    "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "chain": "ethereum"
  },
  {
    "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "chain": "solana"
  }
]
'
[
  {
    "chain": "<string>",
    "address": "<string>",
    "object": "token",
    "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,
      "price_diff_1h": 123,
      "price_diff_pct_1h": 123,
      "total_supply": 123,
      "fully_diluted_valuation_usd": 123,
      "volume_1h": 123,
      "volume_1d": 123,
      "volume_usd_1h": 123,
      "volume_usd_1d": 123,
      "volume_24h": 123,
      "volume_usd_24h": 123,
      "trade_count_1h": 123,
      "trade_count_1d": 123,
      "all_time_high": 123,
      "all_time_low": 123,
      "image_url": "<string>",
      "token_creation_time": "2023-11-07T05:31:56Z",
      "holders_count": 123,
      "stellar_fields": {}
    }
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.allium.so/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint returns detailed token information for specific token addresses. Use query parameters to request additional attributes.

Supported Chains

Authorizations

X-API-KEY
string
header
required

Body

application/json
Required array length: 1 - 200 elements
token_address
string
required

Token contract address

chain
string
required

Lowercase chain name

Response

Successful Response

chain
string
required

Lowercase chain name

address
string
required

Token contract address

object
string
default:token
Allowed value: "token"
type
enum<string> | null

Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)

Available options:
native,
non_native,
evm_erc20,
evm_erc721,
evm_erc1155,
sol_spl,
sui_token,
near_nep141,
near_nep245,
stellar_classic,
stellar_sac,
stellar_wasm
price
number | null

Current price (USD)

decimals
integer | null

Token decimal places

info
TokenInfo · object

Token name and symbol

attributes
TokenAttributes · object

Token market attributes