Token Data

Token endpoints available now cover: metadata, audits (single and batch), real-time price + market data, all-time-high, top holders, search, and recently graduated tokens. Use them to build token pages and discovery surfaces with current supply, liquidity, market cap, and holder distribution data.

Get Metadata for Token

get

Returns the metadata for a given token address stored in the database. Social fields are omitted.

Path parameters

tokenAddressstringRequired

The token's address (e.g., a Solana address)

Responses

200

Token metadata returned successfully

application/json

400

Missing token address path parameter

application/json

404

Token not found

application/json

500

Unexpected server error

application/json

get

/tokens/{tokenAddress}/metadata

GET /tokens/{tokenAddress}/metadata HTTP/1.1
Host: 
Accept: */*

{
  "data": {
    "tokenName": "Token Name",
    "tokenSymbol": "TOKEN",
    "tokenDescription": "Example token",
    "tokenImage": "https://example.com/token.png",
    "tokenSupply": 1000000,
    "tokenDecimals": 9,
    "devWallet": "ABC123...",
    "createdAt": "2025-07-15T00:00:00Z",
    "graduatedAt": "2025-07-16T00:00:00Z",
    "basePool": "BasePoolAddress",
    "quotePool": "QuotePoolAddress",
    "pairAddresses": [
      "0xPairA",
      "0xPairB"
    ]
  },
  "meta": {
    "tokenAddress": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump"
  }
}

Get Real-Time Market Data for a Token

get

Returns real-time metrics including price, market capitalization, FDV, liquidity, total and circulating supply, and current holder count. This endpoint does not use time windows and does not include trade statistics.

Path parameters

tokenAddressstringRequired

The token's mint address (e.g., a Solana SPL token address)

Responses

200

Real-time market data returned successfully

application/json

400

Missing or invalid token address

application/json

404

Token or its trading pairs not found

application/json

500

Unexpected server error

application/json

get

/tokens/{tokenAddress}/market-data

GET /tokens/{tokenAddress}/market-data HTTP/1.1
Host: 
Accept: */*

{
  "data": {
    "price": 0.1234,
    "marketCap": 5000000,
    "fdv": 20000000,
    "liquidity": 120000,
    "totalSupply": 1000000000,
    "remainingSupply": 420000000,
    "holdersCount": 340
  },
  "meta": {
    "tokenAddress": "So11111111111111111111111111111111111111112"
  }
}

Get Token Holders

get

Returns ranked holder wallets, amounts, and percentage ownership for a given token address.

Path parameters

tokenAddressstringRequired

The token's mint address (e.g., Solana token address)

Query parameters

limitinteger · max: 100Optional

Optional limit on number of holders returned (default: 25, max: 100)

Default: 25

Responses

200

List of holders returned successfully

application/json

400

Missing or invalid token address

application/json

404

Token or holders not found

application/json

500

Unexpected server error

application/json

get

/tokens/{tokenAddress}/holders

GET /tokens/{tokenAddress}/holders HTTP/1.1
Host: 
Accept: */*

{
  "data": {
    "holders": [
      {
        "rank": 1,
        "walletAddress": "Dgj8w1YxzHCnfg7rzZkRzZkd1oEM2HaxX6Rfvi7eKnBX",
        "percentageOwned": 99.9294,
        "tokenSupply": 999293962.873546
      }
    ]
  },
  "meta": {
    "tokenAddress": "So11111111111111111111111111111111111111112",
    "limit": 25,
    "count": 1,
    "totalSupply": 1000000000
  }
}

get

Returns a list of trending tokens ordered by transaction count for a given interval.

Query parameters

intervalstring · enumOptional

Time interval window for counting transactions (default: 5m)

Default: 5mExample: {"value":"5m"}Possible values:

Responses

200

List of trending tokens

application/json

400

Invalid interval specified

application/json

500

Unexpected server error

application/json

get

/tokens/trending

GET /tokens/trending HTTP/1.1
Host: 
Accept: */*

[
  {
    "address": "text",
    "symbol": "text",
    "txns": 1,
    "mcap": 1,
    "price": 1,
    "holdersCount": 1
  }
]

Search Tokens

get

Performs a flexible search for tokens by name, symbol, or address, with optional filters, sorting, and symbol-only mode.

Query parameters

searchQuerystringOptional

Query text to search in name, symbol, or address

limitinteger · min: 1 · max: 25Optional

Number of results to return (1–25)

Default: 10

sortBystring · enumOptional

Field to sort results by

Default: createdPossible values:

sortOrderstring · enumOptional

Sort order direction

Default: descPossible values:

Responses

200

List of matching tokens

application/json

400

Invalid input (e.g., sortBy not allowed)

application/json

500

Unexpected server error

application/json

get

/tokens/search

GET /tokens/search HTTP/1.1
Host: 
Accept: */*

{
  "data": {
    "tokens": [
      {
        "tokenAddress": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump",
        "tokenSymbol": "CAT",
        "tokenName": "Cat Token",
        "createdAt": "2024-01-12T04:12:55Z",
        "marketCap": null
      },
      {
        "tokenAddress": "9xbK31Ae4MNEXAMPLE...",
        "tokenSymbol": "DOGE",
        "tokenName": "DogeFi",
        "createdAt": "2023-12-05T18:22:11Z",
        "marketCap": 12400000
      }
    ]
  },
  "meta": {
    "count": 2,
    "searchQuery": "dog",
    "limit": 10,
    "sortBy": "created",
    "sortOrder": "DESC"
  }
}

Get Latest Graduated Tokens

get

Fetches the most recently graduated tokens, ordered by graduation time (descending).

Query parameters

limitinteger · min: 1 · max: 100Optional

Number of results to return (1–100). Defaults to 25.

Default: 25

Responses

200

List of graduated tokens

application/json

500

Unexpected server error

application/json

get

/tokens/graduated

GET /tokens/graduated HTTP/1.1
Host: 
Accept: */*

{
  "data": {
    "tokens": [
      {
        "tokenAddress": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump",
        "tokenName": "DogWater",
        "tokenSymbol": "DWTR",
        "createdAt": "2025-08-21T11:12:30.000Z",
        "graduatedAt": "2025-08-21T12:34:56.000Z"
      },
      {
        "tokenAddress": "9xbK31Ae4MN...",
        "tokenName": "MemeTron",
        "tokenSymbol": "TRON",
        "createdAt": "2025-08-21T10:58:00.000Z",
        "graduatedAt": "2025-08-21T11:59:00.000Z"
      }
    ]
  },
  "meta": {
    "count": 2,
    "limit": 25
  }
}

Get Token ATH

get

Returns the all-time-high (ATH) market cap and the timestamp when it occurred, based on all historical trades for the token.

Path parameters

tokenAddressstringRequired

The token's mint address (Solana SPL token).

Responses

200

ATH data returned successfully

application/json

400

Missing or invalid token address

application/json

404

No trades found for token, so ATH cannot be calculated

application/json

500

Unexpected server error

application/json

get

/tokens/{tokenAddress}/ath

GET /tokens/{tokenAddress}/ath HTTP/1.1
Host: 
Accept: */*

{
  "data": {
    "ath": 1834000.45,
    "timestamp": "2025-08-21T14:12:00.000Z"
  },
  "meta": {
    "tokenAddress": "So11111111111111111111111111111111111111112"
  }
}

Get Historical Token Price

post

Fetches historical price, market cap, or liquidity snapshots for a token across multiple time windows.

Body

tokenstringRequired

The token's address

Responses

200

Historical data returned successfully

application/json

400

Missing token or invalid metrics

application/json

500

Unexpected server error

application/json

post

/tokens/{tokenAddress}/history

POST /tokens/{tokenAddress}/history HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "token": "text",
  "metrics": [
    "price"
  ]
}

{
  "ANY_ADDITIONAL_PROPERTY": {
    "current": 1,
    "1d": 1,
    "3d": 1,
    "5d": 1,
    "7d": 1,
    "14d": 1,
    "30d": 1
  }
}

Get Token Performance

post

Returns percentage performance change for selected metrics over multiple time windows compared to the current value.

Body

tokenstringRequired

Token address to fetch performance data for

Responses

200

Performance data showing % change from current value across time windows.

application/json

400

Invalid or missing request body

application/json

500

Unexpected server error

application/json

post

/tokens/{tokenAddress}/performance

POST /tokens/{tokenAddress}/performance HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "token": "text",
  "metrics": [
    "price"
  ]
}

{
  "price": {
    "1d": 12.5,
    "3d": -8.2,
    "5d": null,
    "7d": 25.7,
    "14d": 40.1,
    "30d": -3.9
  },
  "mcap": {
    "1d": 15,
    "3d": -10.5,
    "5d": null,
    "7d": 30,
    "14d": 45.3,
    "30d": -5.1
  }
}

Get Token Price

get

Returns the latest price, market cap, and liquidity for a specific token address.

Path parameters

tokenAddressstringRequired

The token's contract address

Responses

200

Token pricing information

application/json

400

Missing or invalid token address

application/json

404

Token or trade data not found

application/json

500

Server error

application/json

get

/tokens/{tokenAddress}/price

GET /tokens/{tokenAddress}/price HTTP/1.1
Host: 
Accept: */*

{
  "data": {
    "price": 0.0025,
    "marketCap": 125000,
    "liquidity": 34000
  },
  "meta": {
    "tokenAddress": "So11111111111111111111111111111111111111112"
  }
}

Get Token History Range

post

Returns the lowest and highest values of selected metrics (price, market cap, liquidity) within a specified time range for a token.

Path parameters

tokenAddressstringRequired

The token's contract address

Body

time_fromnumberRequired

Unix timestamp (seconds) for range start

time_tonumberRequired

Unix timestamp (seconds) for range end

modestring · enumOptional

Behavior when requested range falls outside token lifespan

Default: clampPossible values:

Responses

200

Range results for the token

application/json

400

Invalid parameters or body

404

No data available for token

422

Requested range falls completely outside token lifespan (mode=error)

500

Internal server error

post

/tokens/{tokenAddress}/history/range

POST /tokens/{tokenAddress}/history/range HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "time_from": 1712100000,
  "time_to": 1712700000,
  "metrics": [
    "price",
    "mcap"
  ],
  "mode": "clamp"
}

{
  "token": "So11111111111111111111111111111111111111112",
  "requested_range": {
    "from": 1712100000,
    "to": 1712700000
  },
  "available_range": {
    "from": 1712000000,
    "to": 1712800000
  },
  "effective_range": {
    "from": 1712100000,
    "to": 1712700000
  },
  "clamped": false,
  "price": {
    "lowest": {
      "price": 0.85,
      "time": 1712200000
    },
    "highest": {
      "price": 1.12,
      "time": 1712500000
    }
  },
  "mcap": {
    "lowest": {
      "price": 2000000,
      "time": 1712205000
    },
    "highest": {
      "price": 2500000,
      "time": 1712505000
    }
  }
}

Get Token Audit

get

Returns audit data for a given token address, including developer, top holder, insider, bundler, sniper, and LP burn distributions.

Path parameters

tokenAddressstringRequired

The token's address (e.g., a Solana mint address)

Responses

200

Token audit data returned successfully

application/json

get

/tokens/{tokenAddress}/audit

GET /tokens/{tokenAddress}/audit HTTP/1.1
Host: 
Accept: */*

200

Token audit data returned successfully

{
  "data": {
    "tokenSupply": 1000000,
    "developer": {
      "tokenSupply": 102000,
      "percent": 10.2,
      "walletAddress": "C9fjP4xqM2k8PnRftz1234abcXYZ..."
    },
    "top10Holders": {
      "tokenSupply": 705000,
      "percent": 70.5
    },
    "insiders": {
      "tokenSupply": 19000,
      "percent": 1.9
    },
    "bundlers": {
      "tokenSupply": 28000,
      "percent": 2.8
    },
    "snipers": {
      "tokenSupply": 11000,
      "percent": 1.1
    },
    "lpBurn": {
      "tokenSupply": 40000,
      "percent": 4
    }
  },
  "meta": {
    "tokenAddress": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump"
  }
}

Get Token Audit (Multiple)

get

Returns audit data for multiple tokens in a single batch call. Accepts up to 10 token addresses via a comma-separated addresses query parameter. Each entry includes developer, top holder, insider, bundler, sniper, and LP burn distributions.

Cost: 10 credits per request.

Query parameters

addressesstringRequired

Comma-separated list of up to 10 token mint addresses

Example: address1,address2

Responses

200

Batch token audit data returned successfully

application/json

400

Missing or invalid query parameter

application/json

500

Internal server error

application/json

get

/tokens/audit

GET /tokens/audit?addresses=address1%2Caddress2 HTTP/1.1
Host: 
Accept: */*

{
  "data": {
    "addresses": [
      "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump",
      "7Yt5uF3r9cTdxP5vsmg8JXbK8svDqY1N9aEz21X4vhsXc"
    ],
    "tokens": [
      {
        "tokenAddress": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump",
        "tokenSupply": 1000000,
        "developer": {
          "tokenSupply": 105000,
          "percent": 10.5,
          "walletAddress": "F7Rk2x3PT6ZC3XnKk9bAopYfM1s4W8JZTqgA1Yj2uCVZ"
        },
        "top10Holders": {
          "tokenSupply": 720000,
          "percent": 72
        },
        "bundlers": {
          "tokenSupply": 23000,
          "percent": 2.3
        },
        "insiders": {
          "tokenSupply": 18000,
          "percent": 1.8
        },
        "snipers": {
          "tokenSupply": 9000,
          "percent": 0.9
        },
        "lpBurn": {
          "tokenSupply": 35000,
          "percent": 3.5
        }
      },
      {
        "tokenAddress": "7Yt5uF3r9cTdxP5vsmg8JXbK8svDqY1N9aEz21X4vhsXc",
        "tokenSupply": 2500000,
        "developer": {
          "tokenSupply": 200000,
          "percent": 8,
          "walletAddress": "C4HkR5aN2dF3V8JZTqgA1Yj2uCVZ..."
        },
        "top10Holders": {
          "tokenSupply": 1850000,
          "percent": 74
        },
        "bundlers": {
          "tokenSupply": 30000,
          "percent": 3
        },
        "insiders": {
          "tokenSupply": 22000,
          "percent": 2.2
        },
        "snipers": {
          "tokenSupply": 15000,
          "percent": 1.5
        },
        "lpBurn": {
          "tokenSupply": 41000,
          "percent": 4.1
        }
      }
    ]
  },
  "meta": {
    "count": 2
  }
}

PreviousAuthentication NextWallet Data

Last updated 2 hours ago

Get Metadata for Token

Get Real-Time Market Data for a Token

Get Token Holders

Get Trending Tokens

Search Tokens

Get Latest Graduated Tokens

Get Token ATH

Get Historical Token Price

Get Token Performance

Get Token Price

Get Token History Range

Get Token Audit

Get Token Audit (Multiple)