Token trades

curl "https://{{API_HOST}}/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/trades?limit=50" \
  -H "Authorization: Bearer $API_KEY"

curl "https://{{API_HOST}}/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/trades?flags=bundler,insider" \
  -H "Authorization: Bearer $API_KEY"

const url = new URL(
  "https://{{API_HOST}}/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/trades",
);
url.searchParams.set("limit", "50");

const response = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { trades, nextCursor, hasMore } = await response.json();

use serde_json::Value;

let page: Value = reqwest::Client::new()
    .get("https://{{API_HOST}}/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/trades")
    .query(&[("limit", "50")])
    .bearer_auth(std::env::var("API_KEY")?)
    .send()
    .await?
    .error_for_status()?
    .json()
    .await?;

for trade in page["trades"].as_array().into_iter().flatten() {
    println!("{} {}", trade["side"], trade["volume"]["usd"]);
}

{
  "trades": [
    {
      "id": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h:2",
      "chain": "solana",
      "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "name": "Bonk",
      "symbol": "Bonk",
      "trader": "7YttLkHDoNj9wyDur5pM1ejNaAvT9X4eqaYcHQqtj2G5",
      "transactionHash": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h",
      "side": "buy",
      "amount": "12500000",
      "price": { "native": "0.000000121", "usd": "0.0000216" },
      "volume": { "native": "1.51", "usd": "270.12" },
      "marketCap": { "native": "10741962.1", "usd": "1917440000" },
      "timestamp": 1789632015120
    }
  ],
  "nextCursor": "eyJ0cyI6MTc4OTYzMjAxNTEyMCwiaWQiOiI0eFFtVmI4ZTJrVDFuUjdwWmNXM3NMZEhmQTlq",
  "hasMore": true
}

{
  "trades": [],
  "nextCursor": null,
  "hasMore": false
}

curl "https://{{API_HOST}}/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/trades?limit=50" \
  -H "Authorization: Bearer $API_KEY"

curl "https://{{API_HOST}}/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/trades?flags=bundler,insider" \
  -H "Authorization: Bearer $API_KEY"

const url = new URL(
  "https://{{API_HOST}}/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/trades",
);
url.searchParams.set("limit", "50");

const response = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { trades, nextCursor, hasMore } = await response.json();

use serde_json::Value;

let page: Value = reqwest::Client::new()
    .get("https://{{API_HOST}}/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/trades")
    .query(&[("limit", "50")])
    .bearer_auth(std::env::var("API_KEY")?)
    .send()
    .await?
    .error_for_status()?
    .json()
    .await?;

for trade in page["trades"].as_array().into_iter().flatten() {
    println!("{} {}", trade["side"], trade["volume"]["usd"]);
}

{
  "trades": [
    {
      "id": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h:2",
      "chain": "solana",
      "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "name": "Bonk",
      "symbol": "Bonk",
      "trader": "7YttLkHDoNj9wyDur5pM1ejNaAvT9X4eqaYcHQqtj2G5",
      "transactionHash": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h",
      "side": "buy",
      "amount": "12500000",
      "price": { "native": "0.000000121", "usd": "0.0000216" },
      "volume": { "native": "1.51", "usd": "270.12" },
      "marketCap": { "native": "10741962.1", "usd": "1917440000" },
      "timestamp": 1789632015120
    }
  ],
  "nextCursor": "eyJ0cyI6MTc4OTYzMjAxNTEyMCwiaWQiOiI0eFFtVmI4ZTJrVDFuUjdwWmNXM3NMZEhmQTlq",
  "hasMore": true
}

{
  "trades": [],
  "nextCursor": null,
  "hasMore": false
}

GET /v1/tokens/{chain}/{address}/trades

Recent trades on one token, newest first. The page is cursor-paged; see Pagination.

Path parameters

string

required

The chain slug.

string

required

The token’s address.

Query parameters

integer

default:"20"

Rows per page. A value outside 1–100 is clamped, not refused.

string

The opaque nextCursor from the previous page. Never build one yourself.

string

Keep only this wallet’s trades. The address must match the chain’s format.

string

Comma-separated wallet classifications to keep, such as bundler,insider. A trade is kept when its trader carries at least one. Absent or empty keeps every trade.

Response

object[]

required

Trades on this page, newest first.

string | null

required

Cursor for the next page; null on the last page.

boolean

required

Whether a next page exists.

Trade object

string

required

A stable, opaque ID for the trade. One transaction can hold several trades, so this is not the transaction hash. Never parse it.

string

required

The chain slug the trade executed on.

string

required

The traded token’s address.

string

required

The token’s name. Empty until the token’s metadata resolves.

string

required

The token’s symbol. Empty until the token’s metadata resolves.

string

required

The wallet that sent the swap.

string

required

The on-chain transaction hash.

string

required

buy or sell.

decimal string

required

Token units traded.

money object

required

The token’s price at execution.

money object

required

The trade’s value.

money object

required

The token’s market cap at execution.

string[]

The trader’s wallet classifications, such as sniper or bundler. Left out when empty. New values can appear; keep ones you do not recognize.

object[]

The trading terminals the trade routed through. Left out when empty.

Show platform

string

required

The terminal, such as axiom, bananaGun, bullX, gmgn, maestro, photon, trojan or fomo. New values can appear.

object[]

The trader’s resolved public profiles, one per source. Left out when empty. Every field of a profile is present, and any field except source can be null.

Show identity

string

required

Who resolved the profile, such as codex or fomoscan. New values can appear.

string | null

required

The wallet’s handle on the source.

string | null

required

A name to display.

string | null

required

An avatar image URL. null until the image is available.

string | null

required

The linked X handle.

string | null

required

The linked Telegram handle.

string | null

required

The linked Farcaster handle.

integer

required

When the trade executed, in milliseconds.

Errors

Code	When
`UNSUPPORTED_CHAIN`	`chain` is not a supported slug
`VALIDATION_ERROR`	A malformed address, a `trader` that does not match the chain’s format, an unknown flag, a cursor that does not decode, or an unknown parameter

An unknown token answers an empty page, not a 404.

curl "https://{{API_HOST}}/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/trades?limit=50" \
  -H "Authorization: Bearer $API_KEY"

curl "https://{{API_HOST}}/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/trades?flags=bundler,insider" \
  -H "Authorization: Bearer $API_KEY"

const url = new URL(
  "https://{{API_HOST}}/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/trades",
);
url.searchParams.set("limit", "50");

const response = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { trades, nextCursor, hasMore } = await response.json();

use serde_json::Value;

let page: Value = reqwest::Client::new()
    .get("https://{{API_HOST}}/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/trades")
    .query(&[("limit", "50")])
    .bearer_auth(std::env::var("API_KEY")?)
    .send()
    .await?
    .error_for_status()?
    .json()
    .await?;

for trade in page["trades"].as_array().into_iter().flatten() {
    println!("{} {}", trade["side"], trade["volume"]["usd"]);
}

{
  "trades": [
    {
      "id": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h:2",
      "chain": "solana",
      "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "name": "Bonk",
      "symbol": "Bonk",
      "trader": "7YttLkHDoNj9wyDur5pM1ejNaAvT9X4eqaYcHQqtj2G5",
      "transactionHash": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h",
      "side": "buy",
      "amount": "12500000",
      "price": { "native": "0.000000121", "usd": "0.0000216" },
      "volume": { "native": "1.51", "usd": "270.12" },
      "marketCap": { "native": "10741962.1", "usd": "1917440000" },
      "timestamp": 1789632015120
    }
  ],
  "nextCursor": "eyJ0cyI6MTc4OTYzMjAxNTEyMCwiaWQiOiI0eFFtVmI4ZTJrVDFuUjdwWmNXM3NMZEhmQTlq",
  "hasMore": true
}

{
  "trades": [],
  "nextCursor": null,
  "hasMore": false
}

REST

Streams

Path parameters

Query parameters

Response

Trade object

Errors

​Path parameters

​Query parameters

​Response

​Trade object

​Errors

Path parameters

Query parameters

Response

Trade object

Errors