Token API Reference
The Token API provides access to current token prices, logos, and metadata for Cardano native tokens.
Base URL
/api/v1
Authentication
All endpoints require Bearer token authentication.
Authorization: Bearer YOUR_API_TOKEN
Get Current Token Price
GET /tokens/current
Returns the current price of a token by its policy ID and name, or by pool ID.
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
policy | string | ❌ | Hex encoded policy ID and name concatenated (e.g., {policy_id}{name} ) |
pool | string | ❌ | Hex encoded pool ID |
Note: Provide either
policy
orpool
, but not both. At least one parameter is required.
Example Requests
Using Policy ID:
curl -X GET "https://api.charli3.io/api/v1/tokens/current?policy=279c909f348e533da5808898f87f9a14bb2c3dfbbacccd631d927a3f534e454b" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Using Pool ID:
curl -X GET "https://api.charli3.io/api/v1/tokens/current?pool=f5808c2c990d86da54bfc97d89cee6efa20cd8461616359478d96b4c2ffadbb87144e875749122e0bbb9f535eeaa7f5660c6c4a91bcc4121e477f08d" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Response Format
Successful Response:
{
"current_price": 0.003715032520406023,
"current_tvl": 11282985.911915995,
"hourly_price_change": 15.015171247356946,
"hourly_tvl_change": 1532036.606436044,
"hourly_volume": 16410.217457000086,
"daily_price_change": 13.120142188200369,
"daily_tvl_change": 1162540.1193040386,
"daily_volume": 249903.9572390025
}
The response is an object representing the current stats of the token.
Get Token Logo
GET /tokens/logo/{token}
Returns the base64 encoded PNG logo for a token.
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
token | string | ✅ | Policy ID + name concatenated |
Example Request
curl -X GET "https://api.charli3.io/api/v1/tokens/logo/279c909f348e533da5808898f87f9a14bb2c3dfbbacccd631d927a3f534e454b" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Response Format
Successful Response:
"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg=="
No Logo Available:
null
The response is either a base64 encoded PNG image string or null
if no logo exists for the token.
Common Token Examples
Here are policy IDs and pool IDs (on MinswapV2) for some popular Cardano tokens you can use for testing:
SNEK (Meme Token)
- Policy ID:
279c909f348e533da5808898f87f9a14bb2c3dfbbacccd631d927a3f534e454b
- Pool ID:
f5808c2c990d86da54bfc97d89cee6efa20cd8461616359478d96b4c2ffadbb87144e875749122e0bbb9f535eeaa7f5660c6c4a91bcc4121e477f08d
DJED (Stablecoin)
- Policy ID:
8db269c3ec630e06ae29f74bc39edd1f87c819f1056206e879a1cd61446a65644d6963726f555344
- Pool ID:
f5808c2c990d86da54bfc97d89cee6efa20cd8461616359478d96b4ca939812d08cfb6066e17d2914a7272c6b8c0197acdf68157d02c73649cc3efc0
AGIX (SingularityNET Token)
- Policy ID:
f43a62fdc3965df486de8a0d32fe800963589c41b38946602a0dc53541474958
Optim (DeFi Token)
- Policy ID:
e52964af4fffdb54504859875b1827b60ba679074996156461143dc14f5054494d
HUNT (DEX Aggregator)
- Policy ID:
95a427e384527065f2f8946f5e86320d0117839a5e98ea2c0b55fb0048554e54
IAGON (Storage Token)
- Policy ID:
5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d114494147
- Pool ID:
f5808c2c990d86da54bfc97d89cee6efa20cd8461616359478d96b4c7b12f25ce8d6f424e1edbc8b61f0742fb13252605f31dc40373d6a245e8ec1d1
iBTC (Wrapped Bitcoin)
- Policy ID:
f66d78b4a3cb3d37afa0ec36461e51ecbde00f26c8f0a68f94b6988069425443
NTX (NuNet Token)
- Policy ID:
edfd7a1d77bcb8b884c474bdc92a16002d1fb720e454fa6e993444794e5458
C3 (Charli3 Token)
- Policy ID:
8e51398904a5d3fc129fbf4f1589701de23c7824d5c90fdb9490e15a434841524c4933
- Pool ID:
f5808c2c990d86da54bfc97d89cee6efa20cd8461616359478d96b4c36ba6613fc391c292c6fc96c50f17b4e7e26d72212d3d07f6e1cd4d4dbe93bbc
WMTX (World Mobile Token)
- Pool ID:
f5808c2c990d86da54bfc97d89cee6efa20cd8461616359478d96b4c686db0c143a3a2cc19099d8909e315c4ed761a6ac5a3c5998c651d5e9d3cb253
USDM (USD Stablecoin)
- Pool ID:
f5808c2c990d86da54bfc97d89cee6efa20cd8461616359478d96b4c7dd6988c5a86693c76aeec1ea94afa41770be0de21a775ca7a2a1eabdb6a0171
IUSD (Indigo USD)
- Pool ID:
f5808c2c990d86da54bfc97d89cee6efa20cd8461616359478d96b4c452089abb5bf8cc59b678a2cd7b9ee952346c6c0aa1cf27df324310a70d02fc3
Example Usage
Refer to Use Cases section how-to guide.
Error Responses
Token API endpoints may return standard HTTP error codes:
- 200: Success
- 404: Token not found
- 422: Validation error (invalid policy/pool format, or both parameters provided)
- 401: Authentication required
- 429: Rate limit exceeded
Error responses follow this format:
{
"detail": [
{
"loc": ["query", "policy"],
"msg": "Invalid policy format",
"type": "value_error"
}
]
}
Policy ID Format
Policy IDs in Cardano follow this format:
- Policy ID: 56-character hexadecimal string (28 bytes)
- Asset Name: Variable length hexadecimal string
- Combined: Policy ID + Asset Name concatenated
For native ADA, use an empty string ""
as the policy ID.
Pool ID Format
Pool IDs are hex-encoded strings that uniquely identify liquidity pools on Cardano DEXs (for example MinswapV2).
Rate Limiting
Please refer to your API plan for rate limiting information. The token endpoints are typically rate-limited to ensure fair usage across all users. If you don’t have a subscription yet choose the plan.