Get assets

Get assets by ID, slug, or (chain, address).

POST /api/v1/developer/assets/batch

Get Assets Batch

cURL

curl --request POST \
  --url https://api.allium.so/api/v1/developer/assets/batch \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
[
  {
    "id": 123,
    "slug": "<string>",
    "chain": "<string>",
    "address": "<string>"
  }
]
'

200

[
  {
    "id": 123,
    "slug": "<string>",
    "source": "<string>",
    "chain_specific_data": {},
    "name": "<string>",
    "symbol": "<string>",
    "image_url": "<string>",
    "circulating_supply": 123,
    "token_creation_time": "2023-11-07T05:31:56Z"
  }
]

This endpoint returns assets by ID, slug, or (chain, address).

This is a beta endpoint currently under active development. We’re working to stabilize the API and will minimize breaking changes wherever possible, but they may still occur as we refine the interface.

For production support or migration assistance, reach out at [e-mail].

Supported Chains

Authorizations

X-API-KEY · string · header · required

Body

application/json

id · integer | null

Asset ID to look up

slug · string | null

Asset slug to look up

chain · string | null

Lowercase chain name (required with address)

address · string | null

Token contract address

Response

200

application/json

(AssetResponse · object | null)[]

Successful Response

id · integer · required

Unique asset identifier

slug · string · required

URL-friendly asset identifier

source · string · required

Data source (e.g. allium)

chain_specific_data · Chain Specific Data · object · required

Per-chain contract addresses and decimals

Show child attributes

name · string · required

Token name

symbol · string · required

Token symbol

image_url · string | null · required

Token logo URL

circulating_supply · number | null · required

Circulating token supply

token_creation_time · string<date-time> | null · required

Token creation timestamp (UTC)