Identity trades

curl "https://{{API_HOST}}/v1/trades?identity=kol&limit=50" \
  -H "Authorization: Bearer $API_KEY"

curl "https://{{API_HOST}}/v1/trades?identity=fomoscan&chains=solana,base" \
  -H "Authorization: Bearer $API_KEY"

const url = new URL("https://{{API_HOST}}/v1/trades");
url.searchParams.set("identity", "kol");
url.searchParams.set("chains", "solana,base");

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/trades")
    .query(&[("identity", "kol"), ("chains", "solana,base")])
    .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["chain"], trade["symbol"], 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" },
      "identities": [
        {
          "source": "fomoscan",
          "handle": "degenspartan",
          "displayName": "Degen Spartan",
          "avatar": "https://cdn.example.com/avatars/degenspartan.png",
          "twitter": "degenspartan",
          "telegram": null,
          "farcaster": null
        }
      ],
      "timestamp": 1789632015120
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "One or more parameters are invalid.",
    "details": [{ "field": "identity", "message": "Must be one of: kol, fomoscan." }]
  }
}

curl "https://{{API_HOST}}/v1/trades?identity=kol&limit=50" \
  -H "Authorization: Bearer $API_KEY"

curl "https://{{API_HOST}}/v1/trades?identity=fomoscan&chains=solana,base" \
  -H "Authorization: Bearer $API_KEY"

const url = new URL("https://{{API_HOST}}/v1/trades");
url.searchParams.set("identity", "kol");
url.searchParams.set("chains", "solana,base");

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/trades")
    .query(&[("identity", "kol"), ("chains", "solana,base")])
    .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["chain"], trade["symbol"], 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" },
      "identities": [
        {
          "source": "fomoscan",
          "handle": "degenspartan",
          "displayName": "Degen Spartan",
          "avatar": "https://cdn.example.com/avatars/degenspartan.png",
          "twitter": "degenspartan",
          "telegram": null,
          "farcaster": null
        }
      ],
      "timestamp": 1789632015120
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "One or more parameters are invalid.",
    "details": [{ "field": "identity", "message": "Must be one of: kol, fomoscan." }]
  }
}

GET /v1/trades

Recent trades by one identity feed, newest first, across every token. This is the only trade read not scoped to a token.

Query parameters

string

required

Which feed to read. kol covers wallets labelled as key opinion leaders. fomoscan covers wallets with a fomo.family profile.

string

Comma-separated chain slugs to scope to, such as solana,base. Absent means every spot chain. A list that names nothing is refused.

integer

default:"20"

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

string

The opaque nextCursor from the previous page.

Response

The page shape of Token trades: trades, nextCursor and hasMore. Each trade names its own chain and token, because one page spans both.

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`	A slug in `chains` is not supported
`VALIDATION_ERROR`	An unknown `identity`, an empty `chains` list, a cursor that does not decode, or an unknown parameter

curl "https://{{API_HOST}}/v1/trades?identity=kol&limit=50" \
  -H "Authorization: Bearer $API_KEY"

curl "https://{{API_HOST}}/v1/trades?identity=fomoscan&chains=solana,base" \
  -H "Authorization: Bearer $API_KEY"

const url = new URL("https://{{API_HOST}}/v1/trades");
url.searchParams.set("identity", "kol");
url.searchParams.set("chains", "solana,base");

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/trades")
    .query(&[("identity", "kol"), ("chains", "solana,base")])
    .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["chain"], trade["symbol"], 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" },
      "identities": [
        {
          "source": "fomoscan",
          "handle": "degenspartan",
          "displayName": "Degen Spartan",
          "avatar": "https://cdn.example.com/avatars/degenspartan.png",
          "twitter": "degenspartan",
          "telegram": null,
          "farcaster": null
        }
      ],
      "timestamp": 1789632015120
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "One or more parameters are invalid.",
    "details": [{ "field": "identity", "message": "Must be one of: kol, fomoscan." }]
  }
}

REST

Streams

Query parameters

Response

Trade object

Errors

​Query parameters

​Response

​Trade object

​Errors

Query parameters

Response

Trade object

Errors