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 or pool, 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.

Price Data Token Stream