Skip to main content
POST
/
get-tokens-v2
Get tokens list with trading metrics (v2)
curl --request POST \
  --url https://api.tokenlayer.network/functions/v1/get-tokens-v2 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "hashtags": [
    "defi",
    "ethereum"
  ],
  "keyword": "bitcoin",
  "chains": [
    "base",
    "solana",
    "ethereum"
  ],
  "builder_code": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "stage": "graduating",
  "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,
      "launchpad_supply": 123,
      "launchpad_tokens_left": 123,
      "launchpad_progress_pct": 123,
      "trx": 1,
      "token_addresses": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "token_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "address": "<string>",
          "address_display": "<string>",
          "chain": "<string>",
          "platform_name": "<string>",
          "is_registered": true,
          "dex_name": "<string>",
          "dex_address": "<string>",
          "created_at": "2023-11-07T05:31:56Z"
        }
      ],
      "stage": "graduating",
      "token_uri": "<string>",
      "hashtags": [
        "<string>"
      ],
      "indexer_metadata": {
        "token_uri": "<string>",
        "resolved_metadata_url": "<string>",
        "image_url": "<string>",
        "image_storage_path": "<string>",
        "image_storage_url": "<string>",
        "banner_url": "<string>",
        "name": "<string>",
        "symbol": "<string>",
        "description": "<string>",
        "created_on": "<string>",
        "token_layer_id": "<string>",
        "hashtags": [
          "<string>"
        ],
        "token": "<string>",
        "website": "<string>",
        "twitter_url": "<string>",
        "discord_url": "<string>",
        "telegram_url": "<string>",
        "farcaster_url": "<string>",
        "github_url": "<string>",
        "fetched_at": "2023-11-07T05:31:56Z",
        "immutable": true,
        "addresses": null,
        "socials": null,
        "attributes": null,
        "raw_json": null
      }
    }
  ],
  "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
enum<string>[]

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

Blockchain identifier. Supported chains: solana, solana-devnet, arbitrum, base, base-sepolia, avalanche, op-bnb, bnb, bnb-testnet, ethereum, monad, unichain, unichain-testnet, abstract, polygon, zksync, zksync-testnet

Available options:
solana,
solana-devnet,
arbitrum,
base,
base-sepolia,
avalanche,
op-bnb,
bnb,
bnb-testnet,
ethereum,
monad,
unichain,
unichain-testnet,
abstract,
polygon,
zksync,
zksync-testnet
Example:
["base", "solana", "ethereum"]
​
builder_code
string

Filter tokens by builder address (case-insensitive). Returns only tokens deployed by this builder.

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

​
stage
enum<string> | null

Filter tokens by launch stage. Defaults to stage-specific ordering when provided without an explicit order_by.

Available options:
new,
graduating,
graduated
Example:

"graduating"

​
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
​
tokens
object[]
required
​
pagination
object
required

Pagination information