curl "https://api.metastreams.io/v1/trades?tokens=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&chains=solana&limit=50" \
-H "Authorization: Bearer $API_KEY"
curl "https://api.metastreams.io/v1/trades?wallets=7YttLkHDoNj9wyDur5pM1ejNaAvT9X4eqaYcHQqtj2G5&side=buy" \
-H "Authorization: Bearer $API_KEY"
curl "https://api.metastreams.io/v1/trades?identity=kol&chains=solana,bsc" \
-H "Authorization: Bearer $API_KEY"
const url = new URL("https://api.metastreams.io/v1/trades");
url.searchParams.set("tokens", "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263");
url.searchParams.set("chains", "solana");
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.metastreams.io/v1/trades")
.query(&[
("tokens", "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"),
("chains", "solana"),
("limit", "50"),
])
.bearer_auth(std::env::var("API_KEY")?)
.send()
.await?
.error_for_status()?
.json()
.await?;
let trades = &page["trades"];
{
"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
Trades
Returns recent trades, newest first, for a set of tokens, a set of wallets, or a feed of notable wallets.
GET
/
v1
/
trades
curl "https://api.metastreams.io/v1/trades?tokens=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&chains=solana&limit=50" \
-H "Authorization: Bearer $API_KEY"
curl "https://api.metastreams.io/v1/trades?wallets=7YttLkHDoNj9wyDur5pM1ejNaAvT9X4eqaYcHQqtj2G5&side=buy" \
-H "Authorization: Bearer $API_KEY"
curl "https://api.metastreams.io/v1/trades?identity=kol&chains=solana,bsc" \
-H "Authorization: Bearer $API_KEY"
const url = new URL("https://api.metastreams.io/v1/trades");
url.searchParams.set("tokens", "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263");
url.searchParams.set("chains", "solana");
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.metastreams.io/v1/trades")
.query(&[
("tokens", "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"),
("chains", "solana"),
("limit", "50"),
])
.bearer_auth(std::env::var("API_KEY")?)
.send()
.await?
.error_for_status()?
.json()
.await?;
let trades = &page["trades"];
{
"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
}
Returns recent trades, newest first, merged across every chain and token in scope. Each trade includes its own
chain and token.
What to read
Choose one of these reads:tokens, a comma-separated list of 1 to 10 token addresses, reads the trades on those tokens.wallets, a comma-separated list of 1 to 100 wallet addresses, reads the trades those wallets made.tokensandwalletstogether read the named wallets’ trades on the named tokens.identityalone reads one feed of notable wallets across every token.kolcovers wallets labelled as key opinion leaders, andfomocovers wallets with a fomo.family profile.
wallets returns only the last 90 days of trades.
chains limits results to a comma-separated list of chain slugs, such as solana,bsc. Omit it to include every chain. An address reads on every chain in scope of its format, so an EVM address reads on each EVM chain.
Filters
flagstakes a comma-separated list of wallet classifications, such asbundler,insider. A trade is included when its trader has at least one of them.fomomatches traders flaggedfomoand trades routed through the fomo.family terminal.flagsapplies only to a read bytokens.sidekeeps onlybuyorselltrades. It applies only to a read bywallets.
Response
A page containstrades, nextCursor and hasMore. nextCursor is the cursor for the next page, or null on the last page, and hasMore is true while more pages remain. An unknown token or wallet returns an empty page, not a 404.
Pagination
- Opaque cursors. The cursor must not be constructed, modified or parsed. Send it back exactly as received.
- Stable pages. The cursor marks a position in the list, not an offset, so trades that arrive during pagination do not cause duplicated or skipped results.
- One query per cursor. A cursor continues only the query that made it. Send the same parameters with each page.
- Invalid cursors. An unreadable cursor returns
400 VALIDATION_ERRORon thecursorfield rather than silently restarting from the first page.
const url = "https://api.metastreams.io/v1/trades";
const headers = { Authorization: `Bearer ${process.env.API_KEY}` };
let cursor: string | null = null;
do {
const params = new URLSearchParams({ tokens: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263", chains: "solana", limit: "100" });
if (cursor) params.set("cursor", cursor);
const response = await fetch(`${url}?${params}`, { headers });
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const page = await response.json();
for (const trade of page.trades) console.log(trade.id, trade.side, trade.volume.usd);
cursor = page.hasMore ? page.nextCursor : null;
} while (cursor);
use serde_json::Value;
let url = "https://api.metastreams.io/v1/trades";
let key = std::env::var("API_KEY")?;
let client = reqwest::Client::new();
let mut cursor: Option<String> = None;
loop {
let mut request = client.get(url).bearer_auth(&key).query(&[
("tokens", "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"),
("chains", "solana"),
("limit", "100"),
]);
if let Some(cursor) = &cursor {
request = request.query(&[("cursor", cursor)]);
}
let page: Value = request.send().await?.error_for_status()?.json().await?;
for trade in page["trades"].as_array().into_iter().flatten() {
println!("{} {} {}", trade["id"].as_str().unwrap_or_default(), trade["side"].as_str().unwrap_or_default(), trade["volume"]["usd"].as_str().unwrap_or("null"));
}
if page["hasMore"] != true {
break;
}
cursor = page["nextCursor"].as_str().map(String::from);
}
Errors
| Code | When |
|---|---|
UNSUPPORTED_CHAIN | A slug in chains is not supported |
VALIDATION_ERROR | A combination of tokens, wallets, identity, flags and side that the rules above do not allow, such as flags with identity; more than 10 tokens or 100 wallets; a malformed address; an unknown flag or feed; a cursor that does not decode or that another query made; or an unknown parameter |
curl "https://api.metastreams.io/v1/trades?tokens=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&chains=solana&limit=50" \
-H "Authorization: Bearer $API_KEY"
curl "https://api.metastreams.io/v1/trades?wallets=7YttLkHDoNj9wyDur5pM1ejNaAvT9X4eqaYcHQqtj2G5&side=buy" \
-H "Authorization: Bearer $API_KEY"
curl "https://api.metastreams.io/v1/trades?identity=kol&chains=solana,bsc" \
-H "Authorization: Bearer $API_KEY"
const url = new URL("https://api.metastreams.io/v1/trades");
url.searchParams.set("tokens", "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263");
url.searchParams.set("chains", "solana");
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.metastreams.io/v1/trades")
.query(&[
("tokens", "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"),
("chains", "solana"),
("limit", "50"),
])
.bearer_auth(std::env::var("API_KEY")?)
.send()
.await?
.error_for_status()?
.json()
.await?;
let trades = &page["trades"];
{
"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
}
Authorizations
Query Parameters
Response
Recent trades, newest first; a token or wallet with no trades adds none.