Skip to main content
GET
/
token
/
metadata
Get Token Metadata
curl --request GET \
  --url https://api-test.uniblock.dev/uni/v1/token/metadata \
  --header 'X-API-KEY: <api-key>'
{
  "name": "Tether",
  "symbol": "USDT",
  "logo": "https://static.alchemyapi.io/images/assets/825.png",
  "decimals": "6",
  "address": "So11111111111111111111111111111111111111112",
  "chainId": "solana"
}

Authorizations

​
X-API-KEY
string
header
required

API key to access the API (optional)

Query Parameters

​
chainId
enum<string>
default:1
required

Unique identifier for a blockchain network.

Available options:
1,
10,
100,
10143,
10200,
1028,
1088,
1101,
11011,
1111,
1112,
11124,
11155111,
11155420,
11235,
11297108099,
11297108109,
1135,
122,
1284,
1285,
1287,
130,
1301,
1313161554,
1329,
137,
14,
143,
146,
151,
1666600000,
167000,
167009,
168587773,
1868,
1923,
1924,
1946,
199,
2020,
2021,
204,
2222,
23888,
2442,
248,
25,
250,
252,
2522,
2741,
2810,
2818,
288,
30,
300,
31,
321,
322,
324,
32769,
33101,
33111,
33139,
360,
369,
37111,
37714555429,
398,
4002,
4157,
4202,
42161,
421614,
42170,
42220,
42261,
42262,
43113,
43114,
4326,
4352,
43521,
44787,
4689,
480,
4801,
50,
5000,
5003,
50104,
51,
531050104,
534351,
534352,
5371,
5373,
54211,
545,
56,
5611,
57054,
57073,
59141,
59144,
592,
61,
66,
660279,
690,
7000,
7001,
7070,
7332,
763373,
7777777,
7887,
80002,
80069,
80094,
81457,
8217,
8453,
84532,
88,
88882,
88888,
9001,
97,
9745,
9746,
98866,
999,
99999,
999999999,
aptos,
bitcoin,
bitcoin-testnet,
bitcoin-testnet4,
celestia,
osmosis,
pokt,
polkadot,
radix,
solana,
solana-devnet,
starknet-sepolia,
stellar,
stellar-soroban,
stellar-soroban-testnet,
stellar-testnet,
toncoin
Example:

1

​
tokenAddress
string
default:0xdAC17F958D2ee523a2206206994597C13D831ec7
required

The token address to query, or comma-separated token addresses for batch queries. Use native for the native token. Batch mode currently applies one shared chainId to all provided token addresses.

Example:

"native,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

​
includeRaw
boolean

Returns the raw data given by the provider. WARNING: removes backup feature, and raw data returned is not normalized which might make switching providers difficult

Example:

null

​
provider
enum<string>

Overrides our autorouting. Only specify this parameter if you would like to specify only a single provider to use for this request.

Available options:
Alchemy,
GoldRush,
Moralis,
Tatum,
Helius,
SolScan,
Shyft,
Uniblock

Response

200 - application/json
​
name
object
required
Example:

"Tether"

​
symbol
object
required
Example:

"USDT"

Example:

"https://static.alchemyapi.io/images/assets/825.png"

​
decimals
object
required
Example:

"6"

​
address
object
Example:

"So11111111111111111111111111111111111111112"

​
chainId
enum<string>
Available options:
4326,
6343,
2741,
36900,
33139,
787,
81,
336,
3068,
964,
945,
2031,
222222,
13371,
169,
2043,
943,
88,
69000,
42161,
42170,
592,
1313161554,
43114,
223,
5165,
8453,
80094,
199,
200901,
81457,
60808,
288,
3637,
56,
42220,
88888,
1116,
21000000,
25,
388,
4158,
7560,
666666666,
52014,
1,
61,
42793,
9001,
314,
14,
747,
252,
250,
9889,
122,
100,
2345,
71402,
1625,
11235,
1666600000,
128,
7332,
6985385,
43111,
999,
57073,
8822,
4689,
2222,
7887,
8217,
321,
613419,
232,
59144,
1135,
994873017,
5000,
698,
137,
4352,
1088,
34443,
143,
1284,
1285,
2818,
2810,
3073,
397,
42262,
248,
66,
204,
10,
11297108109,
7070,
9745,
98866,
8008,
1101,
369,
1380012617,
151,
690,
570,
2020,
30,
534352,
5371,
360,
1514,
1329,
5031,
1868,
146,
50104,
988,
5330,
1923,
510,
57,
239,
167000,
6122,
4217,
40,
1559,
130,
1111,
480,
869,
323432,
196,
1952,
660279,
50,
24132016,
543210,
16661,
7000,
32769,
320,
810180,
324,
7777777,
747474,
42018,
4114,
4153,
685689,
5042002,
510525,
1776,
1439,
5734951,
2019775,
1672,
688689,
3343,
33431,
allora,
aptos,
atleta,
avail,
bitcoin,
celestia,
iota,
kusama,
midnight,
movement,
nervos,
osmosis,
pokt,
polkadot,
radix,
secret-network,
solana,
sui,
starknet,
stellar-soroban,
toncoin,
tron,
ripple,
stellar,
celestiabridge,
eth-mainnet-beacon,
eth-sepolia-beacon,
eth-holesky-beacon,
eth-hoodi-beacon,
gnosis-mainnet-beacon,
11124,
99999,
33111,
6900,
421614,
43113,
84532,
80069,
1028,
168587773,
23888,
97,
808813,
28882,
3636,
44787,
11142220,
88882,
5115,
4157,
560048,
545,
2522,
4002,
843843,
685685,
10200,
54211,
7080969,
743111,
998,
763373,
1001,
322,
37111,
59141,
4202,
2030232745,
5003,
80002,
43521,
919,
10143,
1287,
398,
266,
42261,
11155420,
5611,
11297108099,
9746,
2442,
11155931,
2021,
31,
534351,
1328,
5373,
11011,
53302,
1315,
11155111,
1946,
14601,
57054,
531050104,
1924,
167009,
10218,
42431,
2201,
1301,
1112,
4801,
37714555429,
51,
241320161,
351243127,
7001,
33101,
300,
999999999,
737373,
46630,
bitcoin-testnet,
bitcoin-testnet4,
solana-devnet,
starknet-sepolia,
stellar-soroban-testnet,
tron-testnet,
stellar-testnet,
aptos-testnet,
celestiabridge-mocha
Example:

"solana"