Tokens

Metadata of a known token

GET/v1/tokens/{chain_id}/{address}

Tokens of Aicscan's reference list (source: reference) or already seen by the service (source: observed). Unknown tokens return 404: the chain is not queried on demand.

Authentication: API key (Authorization: Bearer)
Required scope: read

Path parameters#

chain_idinteger · int64required
addressstringrequired
Token contract, 0x… (EIP-55 checked when mixed case) or T… on TRON.

Responses#

200Token.

Object fields

chain_idinteger
chain_namestring
addressstring
Lowercase hex.
display_addressstring
EIP-55 (base58 on TRON).
symbolstring
namestringnullable
decimalsinteger
sourcestring
Values reference observed

4xx · 5xxError.

Standard error format: see Errors.

Request

cURL

curl "https://aicscan.io/v1/tokens/56/0x55d398326f99059ff775485246999027b3197955" \
  -H "Authorization: Bearer $AICSCAN_API_KEY"

JavaScript

const res = await fetch('https://aicscan.io/v1/tokens/56/0x55d398326f99059ff775485246999027b3197955', {
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os
import requests

resp = requests.get(
    "https://aicscan.io/v1/tokens/56/0x55d398326f99059ff775485246999027b3197955",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Response 200

JSON

{
  "chain_id": 56,
  "chain_name": "BNB Chain",
  "address": "0x55d398326f99059ff775485246999027b3197955",
  "display_address": "0x55d398326f99059fF775485246999027B3197955",
  "symbol": "USDT",
  "name": null,
  "decimals": 18,
  "source": "reference"
}