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

ParameterTypeRequiredDescription
policystringHex encoded policy ID and name concatenated (e.g., {policy_id}{name})
poolstringHex 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 /tokens/logo/{token}

Returns the base64 encoded PNG logo for a token.

Parameters

ParameterTypeRequiredDescription
tokenstringPolicy 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.