curl -X POST "https://api.metastreams.dev/v1/trending" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"chains": ["solana", "base"],
"window": "1h",
"limit": 50,
"filters": { "marketCapUsd": { "min": "100000" } }
}'
const response = await fetch("https://api.metastreams.dev/v1/trending", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
chains: ["solana", "base"],
window: "1h",
limit: 50,
}),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { deltas } = await response.json();
use serde_json::{Value, json};
let response: Value = reqwest::Client::new()
.post("https://api.metastreams.dev/v1/trending")
.bearer_auth(std::env::var("API_KEY")?)
.json(&json!({
"chains": ["solana", "base"],
"window": "1h",
"limit": 50,
}))
.send()
.await?
.error_for_status()?
.json()
.await?;
let deltas = &response["deltas"];
{
"deltas": [
{
"chain": "solana",
"address": "TokenMint1111111111111111111111111111111pump",
"rank": 1,
"data": {
"chain": "solana",
"address": "TokenMint1111111111111111111111111111111pump",
"name": "Example",
"symbol": "EXAMPLE",
"decimals": 6,
"logo": {
"small": "https://cdn.example.com/TokenMint1111111111111111111111111111111pump_16x16.webp",
"medium": "https://cdn.example.com/TokenMint1111111111111111111111111111111pump_60x60.webp",
"large": "https://cdn.example.com/TokenMint1111111111111111111111111111111pump.webp"
},
"price": { "native": "0.0000031", "usd": "0.00055" },
"marketCap": { "native": "3100", "usd": "552000" },
"liquidity": { "native": "410.2", "usd": "73100" },
"updatedAt": 1789632012345
}
}
]
}
REST
Trending
Returns tokens ranked by trending score across one or more chains.
POST
/
v1
/
trending
curl -X POST "https://api.metastreams.dev/v1/trending" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"chains": ["solana", "base"],
"window": "1h",
"limit": 50,
"filters": { "marketCapUsd": { "min": "100000" } }
}'
const response = await fetch("https://api.metastreams.dev/v1/trending", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
chains: ["solana", "base"],
window: "1h",
limit: 50,
}),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { deltas } = await response.json();
use serde_json::{Value, json};
let response: Value = reqwest::Client::new()
.post("https://api.metastreams.dev/v1/trending")
.bearer_auth(std::env::var("API_KEY")?)
.json(&json!({
"chains": ["solana", "base"],
"window": "1h",
"limit": 50,
}))
.send()
.await?
.error_for_status()?
.json()
.await?;
let deltas = &response["deltas"];
{
"deltas": [
{
"chain": "solana",
"address": "TokenMint1111111111111111111111111111111pump",
"rank": 1,
"data": {
"chain": "solana",
"address": "TokenMint1111111111111111111111111111111pump",
"name": "Example",
"symbol": "EXAMPLE",
"decimals": 6,
"logo": {
"small": "https://cdn.example.com/TokenMint1111111111111111111111111111111pump_16x16.webp",
"medium": "https://cdn.example.com/TokenMint1111111111111111111111111111111pump_60x60.webp",
"large": "https://cdn.example.com/TokenMint1111111111111111111111111111111pump.webp"
},
"price": { "native": "0.0000031", "usd": "0.00055" },
"marketCap": { "native": "3100", "usd": "552000" },
"liquidity": { "native": "410.2", "usd": "73100" },
"updatedAt": 1789632012345
}
}
]
}
Returns tokens ranked by trending score across the requested chains. Tokens from every requested chain are ranked as one set.
Request body
chains is required and must list at least one chain. A repeated chain slug counts once.
windowsets the period the score covers:1m,5m,30m,1h,6hor24h. The default is24h.limitsets the number of tokens on the board. The default is 100, and out-of-range values are clamped to 1–100.filterstakes the same filters as Discovery boards. A token must match every filter to be ranked.
400 VALIDATION_ERROR.
Ranking
The trending score combines USD volume, trade count and volume growth over the window. Tokens created in the last 24 hours receive a bonus. On24h, the score also includes holder growth and favors tokens with recent activity.
The score is not returned. rank gives the order, and tokens with equal scores are returned in a stable order. The board can contain fewer tokens than limit.
Response
deltas lists the board, with one item per rank starting from 1. Each item’s data is the same token object that Token details returns.
The spot.trending channel streams changes to the same board.
Errors
| Code | When |
|---|---|
UNSUPPORTED_CHAIN | A slug in chains is not supported |
VALIDATION_ERROR | An empty chains list, an unknown field or filter name, or a malformed body |
curl -X POST "https://api.metastreams.dev/v1/trending" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"chains": ["solana", "base"],
"window": "1h",
"limit": 50,
"filters": { "marketCapUsd": { "min": "100000" } }
}'
const response = await fetch("https://api.metastreams.dev/v1/trending", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
chains: ["solana", "base"],
window: "1h",
limit: 50,
}),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { deltas } = await response.json();
use serde_json::{Value, json};
let response: Value = reqwest::Client::new()
.post("https://api.metastreams.dev/v1/trending")
.bearer_auth(std::env::var("API_KEY")?)
.json(&json!({
"chains": ["solana", "base"],
"window": "1h",
"limit": 50,
}))
.send()
.await?
.error_for_status()?
.json()
.await?;
let deltas = &response["deltas"];
{
"deltas": [
{
"chain": "solana",
"address": "TokenMint1111111111111111111111111111111pump",
"rank": 1,
"data": {
"chain": "solana",
"address": "TokenMint1111111111111111111111111111111pump",
"name": "Example",
"symbol": "EXAMPLE",
"decimals": 6,
"logo": {
"small": "https://cdn.example.com/TokenMint1111111111111111111111111111111pump_16x16.webp",
"medium": "https://cdn.example.com/TokenMint1111111111111111111111111111111pump_60x60.webp",
"large": "https://cdn.example.com/TokenMint1111111111111111111111111111111pump.webp"
},
"price": { "native": "0.0000031", "usd": "0.00055" },
"marketCap": { "native": "3100", "usd": "552000" },
"liquidity": { "native": "410.2", "usd": "73100" },
"updatedAt": 1789632012345
}
}
]
}
Authorizations
Body
application/json
A trending board request: the chains, the window and the filters.