---
title: "Get Tokens"
method: POST
path: "/api/v1/developer/tokens/chain-address"
tags: ["TOKENS", "DEVELOPER"]
---

# Get Tokens

`POST /api/v1/developer/tokens/chain-address`

## Request body

- PayloadTokenAddress[]
  - `token_address` string, required — Token contract address
  - `chain` string, required — Lowercase chain name

## Response `200`

Successful Response

- union[]
  - union
    - Token
      - `object` 'token'
      - `chain` string, required — Lowercase chain name
      - `address` string, required — Token contract address
      - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — 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)
      - `price` number, nullable — Current price (USD)
      - `decimals` integer, nullable — Token decimal places
      - `info` TokenInfo
        - `name` string, required — Token name
        - `symbol` string, required — Token symbol
      - `attributes` TokenAttributes
        - `total_liquidity_usd` LiquidityResults
          - `amount` number, nullable — Liquidity amount (USD)
          - `details` string, nullable — Status when amount unavailable (e.g. LIQUIDITY_TOO_HIGH)
        - `price_diff_1d` number, nullable — Price change (USD) over last 24h
        - `price_diff_pct_1d` number, nullable — Price change (%) over last 24h
        - `price_diff_1h` number, nullable — Price change (USD) over last 1h
        - `price_diff_pct_1h` number, nullable — Price change (%) over last 1h
        - `total_supply` number, nullable — Total token supply
        - `fully_diluted_valuation_usd` number, nullable — Fully diluted valuation (USD)
        - `volume_1h` number, nullable — Trading volume over last 1h
        - `volume_1d` number, nullable — Trading volume over last 24h
        - `volume_usd_1h` number, nullable — Trading volume (USD) over last 1h
        - `volume_usd_1d` number, nullable — Trading volume (USD) over last 24h
        - `volume_24h` number, nullable — Trading volume over last 24h
        - `volume_usd_24h` number, nullable — Trading volume (USD) over last 24h
        - `trade_count_1h` integer, nullable — Trade count over last 1h
        - `trade_count_1d` integer, nullable — Trade count over last 24h
        - `all_time_high` number, nullable — All-time high price (USD)
        - `all_time_low` number, nullable — All-time low price (USD)
        - `image_url` string, nullable — Token logo URL
        - `token_creation_time` string, date-time, nullable — Token creation timestamp (UTC)
        - `holders_count` integer, nullable — Number of token holders
        - `stellar_fields` object, nullable — Stellar-specific metadata
    - TokenNotFoundError
      - `error` string, required — Error message
      - `address` string, required — Token contract address
      - `chain` string, required — Lowercase chain name

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/allium/apis/allium-account-api.md) · [All operations](https://skmtc.net/allium/apis/allium-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/allium/allium-account-api/versions/6c79c032c85d/schema)