Input Schema
{
"method": "GET",
"queryParams": {
"blockchain": {
"description": "The blockchain network to query.",
"enum": [
"ethereum",
"base"
],
"required": true,
"type": "string"
},
"category": {
"description": "Filters to a specific subset of tokens. Currently only 'virtuals' on Base is supported.",
"type": "string"
},
"date": {
"description": "The calendar date to query popularity. Format: MM-DD-YYYY",
"required": true,
"type": "string"
},
"estimate_cost": {
"description": "When true, returns the SLAM token cost for this query. Does not return any data or incur actual charges.",
"type": "boolean"
},
"num": {
"description": "The maximum number of tokens to return. Max is 250.",
"format": "int32",
"type": "integer"
}
},
"type": "http"
}
Output Schema
{
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"properties": {
"block": {
"description": "The block number at which this data snapshot was generated",
"format": "int32",
"type": "integer"
},
"chain": {
"description": "The name of the blockchain network (e.g., 'base')",
"type": "string"
},
"slam": {
"description": "The SLAM token cost for this API call",
"format": "double",
"type": "number"
},
"tokens": {
"description": "List of trending tokens for the specified activity window and category",
"items": {
"properties": {
"address": {
"description": "The token contract address",
"type": "string"
},
"fdv": {
"description": "The token’s fully diluted valuation in USD",
"format": "double",
"type": "number"
},
"first_minted": {
"properties": {
"block": {
"description": "The block number of the first mint",
"format": "int32",
"type": "integer"
},
"hash": {
"description": "The transaction hash of the first mint",
"type": "string"
},
"utc": {
"description": "The UTC timestamp of the mint (ISO 8601 format)",
"type": "string"
}
},
"type": "object"
},
"liquidity": {
"description": "The liquidity value for the token in USD",
"format": "double",
"type": "number"
},
"name": {
"description": "The full name of the token",
"type": "string"
},
"rank": {
"description": "The token’s popularity rank, determined by number of active wallets.",
"format": "int32",
"type": "integer"
},
"symbol": {
"description": "The token’s symbol (e.g., 'SLAM')",
"type": "string"
},
"usd": {
"properties": {
"cur": {
"description": "The current token price in USD",
"format": "double",
"type": "number"
},
"prev": {
"description": "Previous price data for comparison",
"items": {
"properties": {
"change": {
"description": "Price change percentage.",
"type": "string"
},
"minutes": {
"description": "Lookback period in minutes.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
"type": "object"
},
"type": "array"
},
"utc": {
"description": "The UTC timestamp of the block used for the response (ISO 8601 format)",
"type": "string"
}
},
"type": "object"
},
{
"properties": {
"slam": {
"format": "double",
"type": "number"
}
},
"type": "object"
}
]
}
}
},
"description": "OK",
"status": 200
}