Skip to main content
POST
/
get-tokens-v2
Get tokens list with trading metrics (v2)
curl --request POST \
  --url https://api.tokenlayer.network/get-tokens-v2 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "hashtags": [
    "defi",
    "ethereum"
  ],
  "keyword": "bitcoin",
  "chains": [
    "base",
    "solana",
    "ethereum"
  ],
  "order_by": "volume_24h",
  "order_direction": "DESC",
  "limit": 20,
  "offset": 0,
  "verified_only": false
}
'
{
  "success": true,
  "tokens": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "symbol": "<string>",
      "slug": "<string>",
      "logo": "<string>",
      "banner_url": "<string>",
      "video_url": "<string>",
      "description": "<string>",
      "token_layer_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "holders_count": 1,
      "market_cap": 123,
      "price": 123,
      "volume_1m": 123,
      "volume_5m": 123,
      "volume_1h": 123,
      "volume_24h": 123,
      "price_change_24h": 123,
      "price_change_24h_percent": 123,
      "trx": 1,
      "token_addresses": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "token_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "address": "<string>",
          "address_display": "<string>",
          "address_type": "evm",
          "chain": "<string>",
          "platform_name": "<string>",
          "is_registered": true,
          "dex_name": "<string>",
          "dex_address": "<string>",
          "created_at": "2023-11-07T05:31:56Z"
        }
      ]
    }
  ],
  "pagination": {
    "limit": 1,
    "offset": 1,
    "total_returned": 1,
    "has_more": true
  }
}

Authorizations

​
Authorization
string
header
required

JWT token or API key

Body

application/json
​
hashtags
string[]

Filter tokens by hashtags (must match ALL hashtags provided - AND logic)

Example:
["defi", "ethereum"]
​
keyword
string

Search keyword to filter by token name, symbol, or description (case-insensitive)

Example:

"bitcoin"

​
chains
string[]

Filter tokens by chain slugs (returns tokens available on any of the specified chains)

Example:
["base", "solana", "ethereum"]
​
order_by
enum<string>
default:created_at

Field to order results by

Available options:
volume_1m,
volume_5m,
volume_1h,
volume_24h,
market_cap,
price_change_24h,
trx,
holders,
created_at
Example:

"volume_24h"

​
order_direction
enum<string>
default:DESC

Sort direction

Available options:
ASC,
DESC
Example:

"DESC"

​
limit
integer
default:20

Maximum number of tokens to return

Required range: 1 <= x <= 100
Example:

20

​
offset
integer
default:0

Number of tokens to skip for pagination

Required range: x >= 0
Example:

0

​
verified_only
boolean
default:false

Only return tokens with token_layer_id (verified)

Example:

false

Response

Successful response

​
success
enum<boolean>
required
Available options:
true,
false
​
tokens
object[]
required
​
pagination
object
required

Pagination information