Tokens API

Query the list of tokens available on Kroko DEX, ranked by trading activity.

GET /api/v1/tokens2

Returns the token list ranked by trading activity (total transaction count across V2 pairs and V3 pools).

Parameters

Parameter	Type	Required	Description
`limit`	`number`	No	Number of tokens to return (1–500, default: `100`)

Response

{
  "tokens": [
    {
      "address": "0x2c2Ae87Ba178F48637acAe54B87c3924F544a83e",
      "symbol": "WKAS",
      "name": "Wrapped KAS",
      "decimals": 18,
      "logoURI": "https://..."
    },
    {
      "address": "0xB190a6A7fC2873f1Abf145279eD664348d5Ef630",
      "symbol": "HUB",
      "name": "Hub Token",
      "decimals": 18,
      "logoURI": null
    }
  ]
}

Field	Description
`address`	Token contract address (checksummed)
`symbol`	Token ticker symbol
`name`	Full token name
`decimals`	Number of decimal places
`logoURI`	Token icon URL (nullable)

Ranking Logic

Tokens are ranked by total txCount aggregated across all V2 pairs and V3 pools they participate in. Pinned tokens (with admin-set priority) appear first regardless of activity.

GET /api/v1/tokens2/search

Search tokens by symbol or name. Useful for token selector UIs.

Parameters

Parameter	Type	Required	Description
`q`	`string`	Yes	Search query (case-insensitive)
`limit`	`number`	No	Max results (default: `10`)

Response

Same format as /api/v1/tokens2. Searches both symbol and name fields using substring matching.

Example

# Search for tokens with "SUN" in the name or symbol
curl "https://dex.kasplex.org/api/v1/tokens2/search?q=SUN&limit=10"

{
  "tokens": [
    {
      "address": "0x1234...",
      "symbol": "SUN",
      "name": "Sun Token",
      "decimals": 18,
      "logoURI": "https://..."
    }
  ]
}

Token Address Discovery

If you have a token contract address but it’s not in the API:

Search by address is not currently supported via the API
Read on-chain: Call symbol(), name(), and decimals() on the ERC-20 contract directly
Import: Contact the team to have the token added to the official list

Overview

Endpoints

Tokens

Tokens API

GET /api/v1/tokens2

Parameters

Response

Ranking Logic

GET /api/v1/tokens2/search

Parameters

Response

Example

Token Address Discovery

​Tokens API

​GET /api/v1/tokens2

​Parameters

​Response

​Ranking Logic

​GET /api/v1/tokens2/search

​Parameters

​Response

​Example

​Token Address Discovery

Tokens API

GET /api/v1/tokens2

Parameters

Response

Ranking Logic

GET /api/v1/tokens2/search

Parameters

Response

Example

Token Address Discovery