{ "meta": { "attribution": "Anchor Terminal (https://www.anchorterminal.com)", "docs": "https://www.anchorterminal.com/docs/", "generatedAt": "2026-10-05", "license": "CC-BY-4.0", "method": "https://www.anchorterminal.com/benchmark/", "methodology": "0.3", "openapi": "https://www.anchorterminal.com/openapi.json", "preview": false, "run": "2026-10-01", "runLabel": "October 2026 research run" }, "tool": { "category": "", "endpoint": "https://mcp.dexpaprika.com/streamable-http", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/dexpaprika.json", "kind": "mcp", "listed": "indexed", "liveUrl": "https://www.anchorterminal.com/api/v1/live/dexpaprika.json", "markdownUrl": "https://www.anchorterminal.com/tools/dexpaprika.md", "mcpTools": { "check": { "checker": "anchor-check/1.0", "totalTokens": 17052, "counts": { "error": 0, "note": 0, "warn": 7 }, "findings": [ { "rule": "TC14", "severity": "warn", "tool": "getPoolOHLCV", "message": "allowed values are in the description, not an enum: start", "fix": "Move them into enum." }, { "rule": "TC14", "severity": "warn", "tool": "getTokenOHLCV", "message": "allowed values are in the description, not an enum: start", "fix": "Move them into enum." }, { "rule": "TC21", "severity": "warn", "tool": "getNetworkPoolsFilter", "message": "described almost the same as filterNetworkTokens (81% of the same words)", "fix": "Say in each description when to use it instead of the other." }, { "rule": "TC22", "severity": "warn", "tool": "getDexPools", "message": "the definition is about 1,598 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "getNetworkPoolsFilter", "message": "the definition is about 1,795 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "getTokenPools", "message": "the definition is about 1,501 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC23", "severity": "warn", "message": "18 tools, about 16,879 tokens of definitions", "fix": "Split the server by job, or offer a smaller default toolset (a read-only set, or a search-then-call pattern)." } ] }, "checkedAt": "2026-10-04T22:22:34Z", "count": 18, "schemaTokens": 17052, "status": "ok", "tools": [ { "name": "getNetworks", "description": "List every blockchain network DexPaprika indexes, each row carrying its network id (slug), 24h volume, transaction count, and pool count. Read-only and keyless. Start here (or getCapabilities) to get the exact network slug that nearly every other tool requires as its 'network' argument. Use for 'which chains do you support?', 'is Base/Solana/Arbitrum covered?', or 'what is the slug for Polygon?'. Returns the full array with no pagination or sorting; takes no parameters beyond a short rationale. For platform-wide totals rather than a per-network list use getStats.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" } }, "required": [ "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "networks": { "description": "All supported blockchain networks with current 24h volume + indexing stats.", "items": { "additionalProperties": true, "properties": { "display_name": { "description": "Human-readable network name (e.g. 'Ethereum').", "type": "string" }, "id": { "description": "Network slug for use in other endpoints (e.g. 'ethereum').", "type": "string" }, "pools_count": { "description": "Number of indexed pools on this network.", "type": "number" }, "txns_24h": { "description": "Total transactions in the last 24h on this network.", "type": "number" }, "volume_usd_24h": { "description": "Total 24h trading volume across all pools on this network, USD.", "type": "number" } }, "type": "object" }, "type": "array" } }, "required": [ "networks" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getNetworkDexes", "description": "List the DEXes (exchanges) operating on one network, such as Uniswap on ethereum or Raydium on solana, returned under 'dexes' with page_info (page, total_pages). Read-only and keyless. Use for 'which DEXes are on Base?', 'does Solana have Orca?', or to get a dex id to feed into getDexPools. Scope is a single network; call getNetworks first for the slug. Params: network (required slug); limit (default 10, max 100); page (default 1, 1-indexed); sort_by (only 'pool'; legacy alias order_by); sort_dir 'asc' or 'desc' (default 'desc'; legacy alias sort).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "limit": { "default": 10, "description": "OPTIONAL: Number of items per page (default: 10, max: 100)", "type": "number" }, "network": { "description": "REQUIRED: Network ID from getNetworks (e.g., 'ethereum', 'solana')", "type": "string" }, "order_by": { "description": "OPTIONAL: alias of sort_by; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes order_by, so use this name when calling the REST API directly.", "enum": [ "pool" ], "type": "string" }, "page": { "default": 1, "description": "OPTIONAL: Page number, 1-indexed. Server accepts page=0 (treated as page=1) for backward compatibility.", "type": "number" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" }, "sort": { "description": "OPTIONAL: alias of sort_dir; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes sort, so use this name when calling the REST API directly.", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "description": "OPTIONAL: Sort field. Canonical parameter name; older tools used order_by. The REST API calls this parameter order_by.", "enum": [ "pool" ], "type": "string" }, "sort_dir": { "description": "OPTIONAL: Sort direction (asc/desc). Canonical parameter name. Defaults to 'desc' if neither sort_dir nor sort is provided. The REST API calls this parameter sort.", "enum": [ "asc", "desc" ], "type": "string" } }, "required": [ "network", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "dexes": { "items": { "additionalProperties": true, "properties": { "chain": { "type": "string" }, "dex_id": { "type": "string" }, "dex_name": { "type": "string" }, "display_name": { "type": "string" }, "id": { "type": "string" }, "network_id": { "type": "string" }, "pools_count": { "type": "number" }, "protocol": { "type": "string" }, "txns_24h": { "type": "number" }, "volume_usd_24h": { "type": "number" } }, "type": "object" }, "type": "array" }, "page_info": { "additionalProperties": true, "properties": { "limit": { "description": "Items per page in the request.", "type": "number" }, "page": { "description": "Current page number (1-indexed).", "type": "number" }, "total_items": { "description": "Total number of items across all pages.", "type": "number" }, "total_pages": { "description": "Total number of pages available.", "type": "number" } }, "type": "object" } }, "required": [ "dexes", "page_info" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getNetworkPools", "description": "Get the top liquidity pools across a whole network, ranked by 24h volume by default, returned under 'results' with has_next_page and next_cursor. Read-only and keyless. This is the primary chain-wide pool discovery tool. Use for 'biggest pools on ethereum', 'top trading pairs on Base', or 'most active pools on Solana'. Narrow to one exchange with getDexPools, or apply numeric/time filters with getNetworkPoolsFilter. Params: network (required slug); limit (default 10, max 100); cursor (pass previous next_cursor to page); sort_by (default 'volume_usd_24h', canonical *_24h fields, alias order_by); sort_dir 'asc' or 'desc' (default 'desc', alias sort).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "cursor": { "description": "OPTIONAL: Pagination cursor. Pass `next_cursor` from a previous response to fetch the next page (read `has_next_page` to know if more remain). Replaces the old page number.", "type": "string" }, "limit": { "default": 10, "description": "OPTIONAL: Number of items per page (default: 10, max: 100)", "type": "number" }, "network": { "description": "REQUIRED: Network ID from getNetworks (e.g., 'ethereum', 'solana')", "type": "string" }, "order_by": { "description": "OPTIONAL: alias of sort_by; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes order_by, so use this name when calling the REST API directly.", "enum": [ "volume_usd_24h", "volume_usd_7d", "volume_usd_30d", "liquidity_usd", "txns_24h", "created_at", "price_usd", "price_change_percentage_24h", "price_change_percentage_6h", "price_change_percentage_1h", "price_change_percentage_5m", "volume_usd", "transactions", "last_price_change_usd_24h", "volume_24h", "volume_7d", "volume_30d", "liquidity" ], "type": "string" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" }, "sort": { "description": "OPTIONAL: alias of sort_dir; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes sort, so use this name when calling the REST API directly.", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "description": "OPTIONAL: Sort field. Canonical parameter name. Defaults to 'volume_usd_24h'. Prefer the canonical *_24h names; short legacy names (volume_usd, transactions, last_price_change_usd_24h) are still accepted. The REST API calls this parameter order_by.", "enum": [ "volume_usd_24h", "volume_usd_7d", "volume_usd_30d", "liquidity_usd", "txns_24h", "created_at", "price_usd", "price_change_percentage_24h", "price_change_percentage_6h", "price_change_percentage_1h", "price_change_percentage_5m", "volume_usd", "transactions", "last_price_change_usd_24h", "volume_24h", "volume_7d", "volume_30d", "liquidity" ], "type": "string" }, "sort_dir": { "description": "OPTIONAL: Sort direction (asc/desc). Canonical parameter name. Defaults to 'desc' if neither sort_dir nor sort is provided. The REST API calls this parameter sort.", "enum": [ "asc", "desc" ], "type": "string" } }, "required": [ "network", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "has_next_page": { "description": "True if more results are available; fetch them by passing next_cursor as `cursor`.", "type": "boolean" }, "next_cursor": { "description": "Opaque pagination cursor. Pass back as the `cursor` argument to fetch the next page; null/absent on the last page.", "type": [ "string", "null" ] }, "query": { "additionalProperties": {}, "description": "Echo of the resolved query and filters the API applied.", "type": "object" }, "results": { "items": { "additionalProperties": true, "properties": { "chain": { "description": "Network slug (e.g. 'ethereum'). Note: also exposed as 'network' on some endpoints.", "type": "string" }, "created_at": { "description": "ISO 8601 pool-creation timestamp.", "type": "string" }, "created_at_block_number": { "type": "number" }, "dex_id": { "type": "string" }, "dex_name": { "type": "string" }, "fee": { "description": "Pool fee (units depend on DEX; null for some DEXes).", "type": [ "number", "null" ] }, "id": { "description": "Pool contract address.", "type": "string" }, "last_price": { "type": [ "number", "null" ] }, "last_price_usd": { "type": [ "number", "null" ] }, "tokens": { "items": { "additionalProperties": true, "properties": { "added_at": { "description": "ISO 8601 timestamp when DexPaprika first indexed this token.", "type": "string" }, "chain": { "type": "string" }, "decimals": { "type": "number" }, "fdv": { "description": "Fully-diluted valuation in USD.", "type": [ "number", "null" ] }, "id": { "description": "Token contract address (chain-canonical form).", "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": "array" } }, "required": [ "results" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getDexPools", "description": "Get the pools belonging to one specific DEX on one network, e.g. all Uniswap v3 pools on ethereum, returned under 'results' with has_next_page and next_cursor. Read-only and keyless. Proxies /networks/{network}/pools/search with a dex_name filter; the old /networks/{network}/dexes/{dex}/pools endpoint was removed, so the 24h volume field is now volume_usd_24h and there is no page_info. Narrower than getNetworkPools (a single exchange, not the whole chain). Use for 'show me Raydium pools', 'top pairs on PancakeSwap', or 'liquidity on Orca'. Get the dex id from getNetworkDexes or search first, and pass that response's dex_id field ('uniswap_v3'), matched case-insensitively. Do not pass its dex_name field ('Uniswap V3'): a human display name returns HTTP 200 with an empty results[] rather than an error, so an empty answer here usually means the wrong form of the name was sent. Params: network (required slug); dex (required id, e.g. 'uniswap_v3'; the REST API calls this query parameter dex_name); limit (default 10, max 100); cursor (pass the previous next_cursor to page); sort_by (default 'volume_usd_24h', canonical *_24h fields, short legacy names still accepted, alias order_by); sort_dir 'asc'/'desc' (default 'desc', alias sort). The old page number is superseded: page 2 and above return an error pointing at cursor.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "cursor": { "description": "OPTIONAL: Pagination cursor. Pass `next_cursor` from a previous response to fetch the next page (read `has_next_page` to know if more remain). Replaces the old page number.", "type": "string" }, "dex": { "description": "REQUIRED: the dex_id field from getNetworkDexes (e.g., 'uniswap_v3'), matched case-insensitively. Do not pass that response's dex_name field, the human display name (e.g., 'Uniswap V3'): it returns an empty results[] instead of an error, so a wrong value looks like a real but empty answer. The REST API calls this parameter dex_name.", "type": "string" }, "limit": { "default": 10, "description": "OPTIONAL: Number of items per page (default: 10, max: 100)", "type": "number" }, "network": { "description": "REQUIRED: Network ID from getNetworks (e.g., 'ethereum', 'solana')", "type": "string" }, "order_by": { "description": "OPTIONAL: alias of sort_by; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes order_by, so use this name when calling the REST API directly.", "enum": [ "volume_usd_24h", "volume_usd_7d", "volume_usd_30d", "liquidity_usd", "txns_24h", "created_at", "price_usd", "price_change_percentage_24h", "price_change_percentage_6h", "price_change_percentage_1h", "price_change_percentage_5m", "volume_usd", "transactions", "last_price_change_usd_24h", "volume_24h", "volume_7d", "volume_30d", "liquidity" ], "type": "string" }, "page": { "description": "SUPERSEDED: the replacement endpoint is cursor-paginated and ignores page. page=1 (or 0) still returns the first page as before; page=2 or above returns an error telling you to use cursor.", "type": "number" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" }, "sort": { "description": "OPTIONAL: alias of sort_dir; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes sort, so use this name when calling the REST API directly.", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "description": "OPTIONAL: Sort field. Canonical parameter name. Defaults to 'volume_usd_24h'. Prefer the canonical *_24h names; short legacy names (volume_usd, transactions, last_price_change_usd_24h) are still accepted and normalized. The REST API calls this parameter order_by.", "enum": [ "volume_usd_24h", "volume_usd_7d", "volume_usd_30d", "liquidity_usd", "txns_24h", "created_at", "price_usd", "price_change_percentage_24h", "price_change_percentage_6h", "price_change_percentage_1h", "price_change_percentage_5m", "volume_usd", "transactions", "last_price_change_usd_24h", "volume_24h", "volume_7d", "volume_30d", "liquidity" ], "type": "string" }, "sort_dir": { "description": "OPTIONAL: Sort direction (asc/desc). Canonical parameter name. Defaults to 'desc' if neither sort_dir nor sort is provided. The REST API calls this parameter sort.", "enum": [ "asc", "desc" ], "type": "string" } }, "required": [ "network", "dex", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "has_next_page": { "description": "True if more results are available; fetch them by passing next_cursor as `cursor`.", "type": "boolean" }, "next_cursor": { "description": "Opaque pagination cursor. Pass back as the `cursor` argument to fetch the next page; null/absent on the last page.", "type": [ "string", "null" ] }, "query": { "additionalProperties": {}, "description": "Echo of the resolved query and filters the API applied.", "type": "object" }, "results": { "items": { "additionalProperties": true, "properties": { "chain": { "description": "Network slug (e.g. 'ethereum'). Note: also exposed as 'network' on some endpoints.", "type": "string" }, "created_at": { "description": "ISO 8601 pool-creation timestamp.", "type": "string" }, "created_at_block_number": { "type": "number" }, "dex_id": { "type": "string" }, "dex_name": { "type": "string" }, "fee": { "description": "Pool fee (units depend on DEX; null for some DEXes).", "type": [ "number", "null" ] }, "id": { "description": "Pool contract address.", "type": "string" }, "last_price": { "type": [ "number", "null" ] }, "last_price_usd": { "type": [ "number", "null" ] }, "tokens": { "items": { "additionalProperties": true, "properties": { "added_at": { "description": "ISO 8601 timestamp when DexPaprika first indexed this token.", "type": "string" }, "chain": { "type": "string" }, "decimals": { "type": "number" }, "fdv": { "description": "Fully-diluted valuation in USD.", "type": [ "number", "null" ] }, "id": { "description": "Token contract address (chain-canonical form).", "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": "array" } }, "required": [ "results" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getNetworkPoolsFilter", "description": "Get pools on one network filtered by numeric thresholds, returned under 'results' with has_next_page and next_cursor. Read-only and keyless. Choose this over getNetworkPools when the user gives numeric constraints or a time window. Use for 'pools over $1M liquidity on Base', 'pools created in the last 24h', or 'high-volume low-liquidity pairs'. Optional filters (AND-combined): volume_24h_min/max, volume_7d_min/max, liquidity_usd_min/max, txns_24h_min, price_change_percentage_{24h,6h,1h,5m}_min/max (percent, negatives allowed), created_after/created_before (a relative offset such as '-24h', Unix seconds, RFC3339 or YYYY-MM-DD). Also network (required); limit (default 50, max 100); cursor to page; sort_by (default 'volume_usd_24h', alias order_by); sort_dir asc/desc (default 'desc', alias sort).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "created_after": { "description": "OPTIONAL: Only pools created at or after this time: a relative offset such as '-24h' or '-7d', Unix seconds, RFC3339 or YYYY-MM-DD", "type": "string" }, "created_before": { "description": "OPTIONAL: Only pools created at or before this time, same formats as created_after (e.g. '-1h')", "type": "string" }, "cursor": { "description": "OPTIONAL: Pagination cursor. Pass `next_cursor` from a previous response to fetch the next page. Replaces the old page number.", "type": "string" }, "limit": { "default": 50, "description": "OPTIONAL: Items per page (default: 50, max: 100)", "type": "number" }, "liquidity_usd_max": { "description": "OPTIONAL: Maximum pool liquidity in USD", "type": "number" }, "liquidity_usd_min": { "description": "OPTIONAL: Minimum pool liquidity in USD", "type": "number" }, "network": { "description": "REQUIRED: Network ID from getNetworks (e.g., 'ethereum', 'solana')", "type": "string" }, "order_by": { "description": "OPTIONAL: alias of sort_by; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes order_by, so use this name when calling the REST API directly.", "enum": [ "volume_usd_24h", "volume_usd_7d", "volume_usd_30d", "liquidity_usd", "txns_24h", "created_at", "price_usd", "price_change_percentage_24h", "price_change_percentage_6h", "price_change_percentage_1h", "price_change_percentage_5m", "volume_usd", "transactions", "last_price_change_usd_24h", "volume_24h", "volume_7d", "volume_30d", "liquidity" ], "type": "string" }, "price_change_percentage_1h_max": { "description": "OPTIONAL: Maximum 1h price change, in percent", "type": "number" }, "price_change_percentage_1h_min": { "description": "OPTIONAL: Minimum 1h price change, in percent", "type": "number" }, "price_change_percentage_24h_max": { "description": "OPTIONAL: Maximum 24h price change, in percent", "type": "number" }, "price_change_percentage_24h_min": { "description": "OPTIONAL: Minimum 24h price change, in percent. Negatives are allowed, so -20 finds pools down at least 20%.", "type": "number" }, "price_change_percentage_5m_max": { "description": "OPTIONAL: Maximum 5m price change, in percent", "type": "number" }, "price_change_percentage_5m_min": { "description": "OPTIONAL: Minimum 5m price change, in percent. The shortest window we carry, so it is the one to reach for on 'what is moving right now'.", "type": "number" }, "price_change_percentage_6h_max": { "description": "OPTIONAL: Maximum 6h price change, in percent", "type": "number" }, "price_change_percentage_6h_min": { "description": "OPTIONAL: Minimum 6h price change, in percent", "type": "number" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" }, "sort": { "description": "OPTIONAL: alias of sort_dir; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes sort, so use this name when calling the REST API directly.", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "description": "OPTIONAL: Sort field. Canonical parameter name. Defaults to 'volume_usd_24h'. Prefer the canonical *_24h names; short legacy names (volume_24h, volume_7d, liquidity) are still accepted. The REST API calls this parameter order_by.", "enum": [ "volume_usd_24h", "volume_usd_7d", "volume_usd_30d", "liquidity_usd", "txns_24h", "created_at", "price_usd", "price_change_percentage_24h", "price_change_percentage_6h", "price_change_percentage_1h", "price_change_percentage_5m", "volume_usd", "transactions", "last_price_change_usd_24h", "volume_24h", "volume_7d", "volume_30d", "liquidity" ], "type": "string" }, "sort_dir": { "description": "OPTIONAL: Sort direction (asc/desc). Canonical parameter name. Defaults to 'desc' if neither sort_dir nor sort is provided. The REST API calls this parameter sort.", "enum": [ "asc", "desc" ], "type": "string" }, "txns_24h_min": { "description": "OPTIONAL: Minimum transactions in 24h", "type": "number" }, "volume_24h_max": { "description": "OPTIONAL: Maximum 24h volume in USD", "type": "number" }, "volume_24h_min": { "description": "OPTIONAL: Minimum 24h volume in USD", "type": "number" }, "volume_7d_max": { "description": "OPTIONAL: Maximum 7d volume in USD", "type": "number" }, "volume_7d_min": { "description": "OPTIONAL: Minimum 7d volume in USD", "type": "number" } }, "required": [ "network", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "has_next_page": { "description": "True if more results are available; fetch them by passing next_cursor as `cursor`.", "type": "boolean" }, "next_cursor": { "description": "Opaque pagination cursor. Pass back as the `cursor` argument to fetch the next page; null/absent on the last page.", "type": [ "string", "null" ] }, "query": { "additionalProperties": {}, "description": "Echo of the resolved query and filters the API applied.", "type": "object" }, "results": { "items": { "additionalProperties": true, "properties": { "chain": { "description": "Network slug (e.g. 'ethereum'). Note: also exposed as 'network' on some endpoints.", "type": "string" }, "created_at": { "description": "ISO 8601 pool-creation timestamp.", "type": "string" }, "created_at_block_number": { "type": "number" }, "dex_id": { "type": "string" }, "dex_name": { "type": "string" }, "fee": { "description": "Pool fee (units depend on DEX; null for some DEXes).", "type": [ "number", "null" ] }, "id": { "description": "Pool contract address.", "type": "string" }, "last_price": { "type": [ "number", "null" ] }, "last_price_usd": { "type": [ "number", "null" ] }, "tokens": { "items": { "additionalProperties": true, "properties": { "added_at": { "description": "ISO 8601 timestamp when DexPaprika first indexed this token.", "type": "string" }, "chain": { "type": "string" }, "decimals": { "type": "number" }, "fdv": { "description": "Fully-diluted valuation in USD.", "type": [ "number", "null" ] }, "id": { "description": "Token contract address (chain-canonical form).", "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": "array" } }, "required": [ "results" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getPoolDetails", "description": "Get the full current snapshot for one pool by address: its two tokens, current price, liquidity/TVL, 24h volume, and transaction counts, returned as a single pool object (not a list). Read-only and keyless. Use after search or getNetworkPools surfaces a pool, or for 'price/TVL of this pool?' or 'details for pool 0x...'. Returns live values only; for historical candles use getPoolOHLCV, and for the raw swap feed use getPoolTransactions. Params: network (required slug); pool_address (required, e.g. '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640'); inversed (optional bool, default false, flips the token price ratio to token1/token0).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "inversed": { "default": false, "description": "OPTIONAL: Whether to invert the price ratio (default: false)", "type": "boolean" }, "network": { "description": "REQUIRED: Network ID from getNetworks (e.g., 'ethereum', 'solana')", "type": "string" }, "pool_address": { "description": "REQUIRED: Pool address or identifier (e.g., '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640')", "type": "string" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" } }, "required": [ "network", "pool_address", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "chain": { "type": "string" }, "created_at": { "type": "string" }, "created_at_block_number": { "type": "number" }, "dex_id": { "type": "string" }, "dex_name": { "type": "string" }, "factory_id": { "type": "string" }, "fee": { "type": [ "number", "null" ] }, "id": { "type": "string" }, "last_price": { "type": [ "number", "null" ] }, "last_price_usd": { "type": [ "number", "null" ] }, "price_stats": {}, "price_time": { "type": "string" }, "token_reserves": { "items": {}, "type": "array" }, "tokens": { "items": { "additionalProperties": true, "properties": { "added_at": { "description": "ISO 8601 timestamp when DexPaprika first indexed this token.", "type": "string" }, "chain": { "type": "string" }, "decimals": { "type": "number" }, "fdv": { "description": "Fully-diluted valuation in USD.", "type": [ "number", "null" ] }, "id": { "description": "Token contract address (chain-canonical form).", "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getPoolOHLCV", "description": "Get historical OHLCV candles (open, high, low, close, volume) for one pool over a time range, returned as a time-series array. Read-only and keyless. Use for 'price history of this pair', 'hourly chart for the last week', 'candles since Jan 1', or backtesting; for the single current price use getPoolDetails instead. Params: network (required); pool_address (required); start (required; easiest as a relative offset from now such as '-24h' or '-7d', so you need not know today's date; also Unix seconds, RFC3339 or yyyy-mm-dd); end (optional); interval one of '1m','5m','10m','15m','30m','1h','6h','12h','24h' (default '24h'); limit (default 100, max 1000 candles); inversed (optional bool, default false).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "end": { "description": "OPTIONAL: End time for historical data, same formats as start (e.g. '-1h')", "type": "string" }, "interval": { "default": "24h", "description": "OPTIONAL: Interval granularity (default: '24h')", "enum": [ "1m", "5m", "10m", "15m", "30m", "1h", "6h", "12h", "24h" ], "type": "string" }, "inversed": { "default": false, "description": "OPTIONAL: Whether to invert the price ratio for alternative pair perspective (default: false)", "type": "boolean" }, "limit": { "default": 100, "description": "OPTIONAL: Number of OHLCV data points to retrieve (default: 100, max: 1000). One row per `interval`.", "type": "number" }, "network": { "description": "REQUIRED: Network ID from getNetworks (e.g., 'ethereum', 'solana')", "type": "string" }, "pool_address": { "description": "REQUIRED: Pool address or identifier", "type": "string" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" }, "start": { "description": "REQUIRED: Start time. A relative offset from now is simplest and needs no knowledge of today's date: '-24h' (last 24 hours), '-7d', '-90m' (units s, m, h, d). Also accepts RFC3339 (e.g. '2024-01-01T00:00:00Z'), Unix epoch seconds and YYYY-MM-DD (treated as 00:00:00 UTC).", "type": "string" } }, "required": [ "network", "pool_address", "start", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "ohlcv": { "description": "Open-High-Low-Close-Volume rows ordered by time_open ascending.", "items": { "additionalProperties": true, "properties": { "close": { "type": "number" }, "high": { "type": "number" }, "low": { "type": "number" }, "open": { "type": "number" }, "time_close": { "description": "ISO 8601 timestamp of bucket close (inclusive at 23:59:59 for 24h).", "type": "string" }, "time_open": { "description": "ISO 8601 timestamp of bucket open.", "type": "string" }, "volume": { "description": "Trade volume in the bucket, in pair-quote units (or USD where applicable).", "type": "number" } }, "type": "object" }, "type": "array" } }, "required": [ "ohlcv" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getPoolTransactions", "description": "Get one pool's recent individual swap transactions, newest first, returned under 'transactions' (paginate with page, or a cursor). Read-only. Runs on the caller's own Dev, Pro or Enterprise API key, set as the Authorization header on the connection to this server; without one it returns DP401_API_KEY_REQUIRED and sends nothing upstream, and a free key gets 403. In either case getPoolDetails still gives the pool's 24h transaction counts and volume. These are per-trade records, not aggregated candles (use getPoolOHLCV) or a summary snapshot (use getPoolDetails). Use for 'recent trades on this pool', 'who swapped in the last hour', or 'raw transaction feed'. Params: network (required); pool_address (required); limit (default 10, max 100); page (default 1, up to 100 pages) or cursor (a transaction id); from (optional, inclusive: a relative offset such as '-1h', Unix seconds, RFC3339 or YYYY-MM-DD; capped to the last 7 days); to (optional, exclusive, same formats, must be after from).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "cursor": { "description": "OPTIONAL: Transaction ID used for cursor-based pagination", "type": "string" }, "from": { "description": "OPTIONAL: Filter transactions starting from this time (inclusive): a relative offset such as '-1h' or '-24h', Unix seconds, RFC3339 or YYYY-MM-DD. Results always capped to last 7 days.", "type": "string" }, "limit": { "default": 10, "description": "OPTIONAL: Number of items per page (default: 10, max: 100)", "type": "number" }, "network": { "description": "REQUIRED: Network ID from getNetworks (e.g., 'ethereum', 'solana')", "type": "string" }, "page": { "default": 1, "description": "OPTIONAL: Page number, 1-indexed. Up to 100 pages. Server accepts page=0 (treated as page=1) for backward compatibility.", "type": "number" }, "pool_address": { "description": "REQUIRED: Pool address or identifier", "type": "string" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" }, "to": { "description": "OPTIONAL: Filter transactions up to this time (exclusive), same formats as from. Must be after 'from'.", "type": "string" } }, "required": [ "network", "pool_address", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "page_info": { "additionalProperties": true, "properties": { "limit": { "description": "Items per page in the request.", "type": "number" }, "page": { "description": "Current page number (1-indexed).", "type": "number" }, "total_items": { "description": "Total number of items across all pages.", "type": "number" }, "total_pages": { "description": "Total number of pages available.", "type": "number" } }, "type": "object" }, "transactions": { "items": { "additionalProperties": true, "properties": { "amount_usd": { "type": "number" }, "block_number": { "type": "number" }, "block_timestamp": { "type": "string" }, "id": { "type": "string" }, "pool_id": { "type": "string" }, "token0": {}, "token1": {} }, "type": "object" }, "type": "array" } }, "required": [ "transactions", "page_info" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getTokenDetails", "description": "Get one token's data and metadata by contract address on one network: multi-timeframe price and volume metrics, plus name, website, Twitter, and Telegram links, returned as a single token object. Read-only and keyless. Use for 'price and volume for 0x... on Base' or 'tell me about this token'. If you only have a symbol like WETH, call search first to resolve the address and network. For many tokens' prices at once use getTokenMultiPrices; for the pools holding this token use getTokenPools. Params: network (required slug); token_address (required contract address, e.g. 'JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN' on solana).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "network": { "description": "REQUIRED: Network ID from getNetworks (e.g., 'ethereum', 'solana')", "type": "string" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" }, "token_address": { "description": "REQUIRED: Token contract address (e.g., 'JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN' for Jupiter on Solana)", "type": "string" } }, "required": [ "network", "token_address", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "added_at": { "type": "string" }, "chain": { "type": "string" }, "decimals": { "type": "number" }, "description": { "type": "string" }, "has_image": { "type": "boolean" }, "id": { "type": "string" }, "name": { "type": "string" }, "price_stats": {}, "summary": {}, "symbol": { "type": "string" }, "total_supply": { "description": "Raw on-chain total supply. Big numbers may overflow JS Number; handle as string for tokens with 18+ decimals.", "type": [ "number", "string" ] }, "website": { "type": "string" } }, "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getTokenPools", "description": "Get the liquidity pools that contain a specific token on one network, returned under 'results' with has_next_page and next_cursor. Read-only and keyless. Use for 'which pools hold WETH on ethereum?' or 'liquidity venues for 0x...'. Network-scoped, so run search first if unsure of the network; unknown addresses return empty results, not an error. For the token's own price use getTokenDetails. Params: network (required); token_address (required); limit (default 10, max 100); cursor to page; sort_by (default 'volume_usd_24h', alias order_by); sort_dir asc/desc (default 'desc', alias sort). Extra params such as inversed or paired_token_address are unsupported and error.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "address": { "description": "REMOVED alias for paired_token_address. No longer supported by the API; supplying it returns an error.", "type": "string" }, "cursor": { "description": "OPTIONAL: Pagination cursor. Pass `next_cursor` from a previous response to fetch the next page (read `has_next_page` to know if more remain). Replaces the old page number.", "type": "string" }, "inversed": { "description": "REMOVED: the pair-perspective flip is no longer supported by the API; the pools/search replacement returns pool-perspective metrics only. Supplying true returns an error. For a single pool, getPoolDetails with inversed=true still flips the perspective.", "type": "boolean" }, "limit": { "default": 10, "description": "OPTIONAL: Number of items per page (default: 10, max: 100)", "type": "number" }, "network": { "description": "REQUIRED: Network ID from getNetworks (e.g., 'ethereum', 'solana')", "type": "string" }, "order_by": { "description": "OPTIONAL: alias of sort_by; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes order_by, so use this name when calling the REST API directly.", "enum": [ "volume_usd_24h", "volume_usd_7d", "volume_usd_30d", "liquidity_usd", "txns_24h", "created_at", "price_usd", "price_change_percentage_24h", "price_change_percentage_6h", "price_change_percentage_1h", "price_change_percentage_5m", "volume_usd", "transactions", "last_price_change_usd_24h", "volume_24h", "volume_7d", "volume_30d", "liquidity" ], "type": "string" }, "paired_token_address": { "description": "REMOVED: the second-token pair filter is no longer supported by the API. Supplying it returns an error. Filter client-side on each result's tokens[] instead.", "type": "string" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" }, "reorder": { "description": "REMOVED alias for inversed. No longer supported by the API; supplying true returns an error.", "type": "boolean" }, "sort": { "description": "OPTIONAL: alias of sort_dir; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes sort, so use this name when calling the REST API directly.", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "description": "OPTIONAL: Sort field. Canonical parameter name. Defaults to 'volume_usd_24h'. Prefer the canonical *_24h names; short legacy names (volume_usd, transactions, last_price_change_usd_24h) are still accepted. The REST API calls this parameter order_by.", "enum": [ "volume_usd_24h", "volume_usd_7d", "volume_usd_30d", "liquidity_usd", "txns_24h", "created_at", "price_usd", "price_change_percentage_24h", "price_change_percentage_6h", "price_change_percentage_1h", "price_change_percentage_5m", "volume_usd", "transactions", "last_price_change_usd_24h", "volume_24h", "volume_7d", "volume_30d", "liquidity" ], "type": "string" }, "sort_dir": { "description": "OPTIONAL: Sort direction (asc/desc). Canonical parameter name. Defaults to 'desc' if neither sort_dir nor sort is provided. The REST API calls this parameter sort.", "enum": [ "asc", "desc" ], "type": "string" }, "token_address": { "description": "REQUIRED: Token contract address", "type": "string" } }, "required": [ "network", "token_address", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "has_next_page": { "description": "True if more results are available; fetch them by passing next_cursor as `cursor`.", "type": "boolean" }, "next_cursor": { "description": "Opaque pagination cursor. Pass back as the `cursor` argument to fetch the next page; null/absent on the last page.", "type": [ "string", "null" ] }, "query": { "additionalProperties": {}, "description": "Echo of the resolved query and filters the API applied.", "type": "object" }, "results": { "items": { "additionalProperties": true, "properties": { "chain": { "description": "Network slug (e.g. 'ethereum'). Note: also exposed as 'network' on some endpoints.", "type": "string" }, "created_at": { "description": "ISO 8601 pool-creation timestamp.", "type": "string" }, "created_at_block_number": { "type": "number" }, "dex_id": { "type": "string" }, "dex_name": { "type": "string" }, "fee": { "description": "Pool fee (units depend on DEX; null for some DEXes).", "type": [ "number", "null" ] }, "id": { "description": "Pool contract address.", "type": "string" }, "last_price": { "type": [ "number", "null" ] }, "last_price_usd": { "type": [ "number", "null" ] }, "tokens": { "items": { "additionalProperties": true, "properties": { "added_at": { "description": "ISO 8601 timestamp when DexPaprika first indexed this token.", "type": "string" }, "chain": { "type": "string" }, "decimals": { "type": "number" }, "fdv": { "description": "Fully-diluted valuation in USD.", "type": [ "number", "null" ] }, "id": { "description": "Token contract address (chain-canonical form).", "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": "array" } }, "required": [ "results" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getTopTokens", "description": "Get the top tokens on one network ranked by volume, liquidity, transactions, FDV, or 24h price change, returned under 'results' with has_next_page and next_cursor. Read-only and keyless. Use for 'top gainers on Solana', 'highest-volume tokens on Base', or 'biggest tokens by FDV on ethereum'. For arbitrary numeric filters or a time window use filterNetworkTokens instead. Params: network (required slug); limit (default 50, max 100); cursor (pass previous next_cursor to page); sort_by (default 'volume_usd_24h', alias order_by), noting that ranking by raw price is unsupported and silently falls back to volume; sort_dir asc/desc (default 'desc', alias sort).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "cursor": { "description": "OPTIONAL: Pagination cursor. Pass `next_cursor` from a previous response to fetch the next page. Replaces the old page number.", "type": "string" }, "limit": { "default": 50, "description": "OPTIONAL: Items per page (default: 50, max: 100)", "type": "number" }, "network": { "description": "REQUIRED: Network ID from getNetworks", "type": "string" }, "order_by": { "description": "OPTIONAL: alias of sort_by; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes order_by, so use this name when calling the REST API directly.", "enum": [ "volume_usd_24h", "volume_usd_7d", "volume_usd_30d", "liquidity_usd", "txns_24h", "fdv_usd", "created_at", "price_change_percentage_24h", "volume_24h", "volume_7d", "volume_30d", "txns", "price_change", "fdv", "price_usd" ], "type": "string" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" }, "sort": { "description": "OPTIONAL: alias of sort_dir; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes sort, so use this name when calling the REST API directly.", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "description": "OPTIONAL: Ranking field. Defaults to 'volume_usd_24h'. Prefer the canonical names (volume_usd_24h, liquidity_usd, txns_24h, fdv_usd, price_change_percentage_24h); short legacy names are still accepted. Note: ordering by price is not supported and falls back to volume. The REST API calls this parameter order_by.", "enum": [ "volume_usd_24h", "volume_usd_7d", "volume_usd_30d", "liquidity_usd", "txns_24h", "fdv_usd", "created_at", "price_change_percentage_24h", "volume_24h", "volume_7d", "volume_30d", "txns", "price_change", "fdv", "price_usd" ], "type": "string" }, "sort_dir": { "description": "OPTIONAL: Sort direction (asc/desc). Canonical parameter name. Defaults to 'desc' if neither sort_dir nor sort is provided. The REST API calls this parameter sort.", "enum": [ "asc", "desc" ], "type": "string" } }, "required": [ "network", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "has_next_page": { "description": "True if more results are available; fetch them by passing next_cursor as `cursor`.", "type": "boolean" }, "next_cursor": { "description": "Opaque pagination cursor. Pass back as the `cursor` argument to fetch the next page; null/absent on the last page.", "type": [ "string", "null" ] }, "query": { "additionalProperties": {}, "description": "Echo of the resolved query and filters the API applied.", "type": "object" }, "results": { "items": { "additionalProperties": true, "properties": { "added_at": { "description": "ISO 8601 timestamp when DexPaprika first indexed this token.", "type": "string" }, "chain": { "type": "string" }, "decimals": { "type": "number" }, "fdv": { "description": "Fully-diluted valuation in USD.", "type": [ "number", "null" ] }, "id": { "description": "Token contract address (chain-canonical form).", "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" } }, "type": "object" }, "type": "array" } }, "required": [ "results" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "filterNetworkTokens", "description": "Get tokens on one network matching numeric thresholds, returned under 'results' with has_next_page and next_cursor. Read-only and keyless. Choose this over getTopTokens when the user gives numeric constraints or a time window. Use for 'tokens with FDV over $10M on Base', 'newly created tokens today', or 'low-liquidity high-volume tokens'. Optional filters (AND-combined): volume_24h_min/max, liquidity_usd_min/max, fdv_min/max, txns_24h_min, price_change_percentage_24h_min/max, created_after/created_before (a relative offset such as '-24h', Unix seconds, RFC3339 or YYYY-MM-DD). Also network (required); limit (default 50, max 100); cursor to page; sort_by (default 'volume_usd_24h', alias order_by); sort_dir asc/desc (default 'desc', alias sort).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "created_after": { "description": "OPTIONAL: Only tokens created at or after this time: a relative offset such as '-24h' or '-7d', Unix seconds, RFC3339 or YYYY-MM-DD", "type": "string" }, "created_before": { "description": "OPTIONAL: Only tokens created at or before this time, same formats as created_after (e.g. '-1h')", "type": "string" }, "cursor": { "description": "OPTIONAL: Pagination cursor. Pass `next_cursor` from a previous response to fetch the next page. Replaces the old page number.", "type": "string" }, "fdv_max": { "description": "OPTIONAL: Maximum FDV in USD", "type": "number" }, "fdv_min": { "description": "OPTIONAL: Minimum FDV in USD", "type": "number" }, "limit": { "default": 50, "description": "OPTIONAL: Items per page (default: 50, max: 100)", "type": "number" }, "liquidity_usd_max": { "description": "OPTIONAL: Maximum token liquidity in USD", "type": "number" }, "liquidity_usd_min": { "description": "OPTIONAL: Minimum token liquidity in USD", "type": "number" }, "network": { "description": "REQUIRED: Network ID from getNetworks", "type": "string" }, "order_by": { "description": "OPTIONAL: alias of sort_by; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes order_by, so use this name when calling the REST API directly.", "enum": [ "volume_usd_24h", "volume_usd_7d", "volume_usd_30d", "liquidity_usd", "txns_24h", "fdv_usd", "created_at", "price_change_percentage_24h", "volume_24h", "volume_7d", "volume_30d", "txns", "price_change", "fdv", "price_usd" ], "type": "string" }, "price_change_percentage_24h_max": { "description": "OPTIONAL: Maximum 24h price change, in percent", "type": "number" }, "price_change_percentage_24h_min": { "description": "OPTIONAL: Minimum 24h price change, in percent. Negatives are allowed, so -20 finds tokens down at least 20%. This is the only price-change window tokens carry; for 6h, 1h or 5m use getNetworkPoolsFilter.", "type": "number" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" }, "sort": { "description": "OPTIONAL: alias of sort_dir; both are accepted. Not deprecated at the REST layer: api.dexpaprika.com itself takes sort, so use this name when calling the REST API directly.", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "description": "OPTIONAL: Sort field. Defaults to 'volume_usd_24h'. Prefer the canonical names; short legacy names are still accepted. The REST API calls this parameter order_by.", "enum": [ "volume_usd_24h", "volume_usd_7d", "volume_usd_30d", "liquidity_usd", "txns_24h", "fdv_usd", "created_at", "price_change_percentage_24h", "volume_24h", "volume_7d", "volume_30d", "txns", "price_change", "fdv", "price_usd" ], "type": "string" }, "sort_dir": { "description": "OPTIONAL: Sort direction (asc/desc). Canonical parameter name. Defaults to 'desc' if neither sort_dir nor sort is provided. The REST API calls this parameter sort.", "enum": [ "asc", "desc" ], "type": "string" }, "txns_24h_min": { "description": "OPTIONAL: Minimum transactions in 24h", "type": "number" }, "volume_24h_max": { "description": "OPTIONAL: Maximum 24h volume in USD", "type": "number" }, "volume_24h_min": { "description": "OPTIONAL: Minimum 24h volume in USD", "type": "number" } }, "required": [ "network", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "has_next_page": { "description": "True if more results are available; fetch them by passing next_cursor as `cursor`.", "type": "boolean" }, "next_cursor": { "description": "Opaque pagination cursor. Pass back as the `cursor` argument to fetch the next page; null/absent on the last page.", "type": [ "string", "null" ] }, "query": { "additionalProperties": {}, "description": "Echo of the resolved query and filters the API applied.", "type": "object" }, "results": { "items": { "additionalProperties": true, "properties": { "added_at": { "description": "ISO 8601 timestamp when DexPaprika first indexed this token.", "type": "string" }, "chain": { "type": "string" }, "decimals": { "type": "number" }, "fdv": { "description": "Fully-diluted valuation in USD.", "type": [ "number", "null" ] }, "id": { "description": "Token contract address (chain-canonical form).", "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" } }, "type": "object" }, "type": "array" } }, "required": [ "results" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getTokenMultiPrices", "description": "Get current USD prices for up to 10 tokens on the same network in one batched call, returned as a prices array plus a missing_tokens list. Read-only and keyless. Tokens that cannot be priced come back in missing_tokens rather than being dropped, so check that list for partial failures. Use for 'prices for these tokens', 'compare the price of X, Y and Z', or building a portfolio/dashboard snapshot. For one token with full metadata and multi-timeframe stats use getTokenDetails. Params: network (required slug, all tokens must share it); tokens (required array of 1 to 10 contract addresses).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "network": { "description": "REQUIRED: Network ID from getNetworks", "type": "string" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" }, "tokens": { "description": "REQUIRED: Up to 10 token contract addresses on the same network.", "items": { "type": "string" }, "maxItems": 10, "minItems": 1, "type": "array" } }, "required": [ "network", "tokens", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "missing_tokens": { "description": "Input tokens that upstream could not price (invalid address, no liquidity, unknown contract). Empty array when all input tokens were resolved.", "items": { "type": "string" }, "type": "array" }, "prices": { "description": "USD prices for the requested tokens, in input order.", "items": { "additionalProperties": true, "properties": { "chain": { "type": "string" }, "id": { "description": "Token contract address.", "type": "string" }, "price_usd": { "description": "Current USD price; null if not available.", "type": [ "number", "null" ] } }, "type": "object" }, "type": "array" } }, "required": [ "prices" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getTokenOHLCV", "description": "Get historical USD OHLCV candles for one token over a time range, returned as a time-series array. The price and volume are computed across every pool the token trades in on the network (a volume-weighted price, and volume summed across those pools), not a single pair. Runs on the caller's own Dev, Pro or Enterprise API key, set as the Authorization header on the connection to this server; without one it returns DP401_API_KEY_REQUIRED and sends nothing upstream, and a free key gets 403. In either case fall back to getPoolOHLCV on the token's main pool, found with getTokenPools sorted by volume. Use for 'price history of this token' or 'USD chart for this token'; for a single pair's candles use getPoolOHLCV, and for the current price use getTokenDetails. Params: network (required); token_address (required); start (required; easiest as a relative offset from now such as '-24h', so you need not know today's date; also Unix seconds, RFC3339 or yyyy-mm-dd); end (optional, same formats); interval one of '1m','5m','10m','15m','30m','1h','6h','12h','24h' (default '24h'); limit (default 10, max 1000 candles). Dev plan history is limited to the last 30 days. There is no inversed parameter on this endpoint.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "end": { "description": "OPTIONAL: End time, same formats as start (e.g. '-1h')", "type": "string" }, "interval": { "default": "24h", "description": "OPTIONAL: Interval granularity (default: '24h')", "enum": [ "1m", "5m", "10m", "15m", "30m", "1h", "6h", "12h", "24h" ], "type": "string" }, "limit": { "default": 10, "description": "OPTIONAL: Number of data points to retrieve (default: 10, max: 1000)", "type": "number" }, "network": { "description": "REQUIRED: Network ID from getNetworks (e.g., 'ethereum', 'solana')", "type": "string" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" }, "start": { "description": "REQUIRED: Start time. A relative offset from now is simplest and needs no knowledge of today's date: '-24h' (last 24 hours), '-7d', '-90m' (units s, m, h, d). Also accepts RFC3339 (e.g. '2024-01-01T00:00:00Z'), Unix epoch seconds and YYYY-MM-DD (treated as 00:00:00 UTC).", "type": "string" }, "token_address": { "description": "REQUIRED: Token contract address", "type": "string" } }, "required": [ "network", "token_address", "start", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "ohlcv": { "description": "USD candles for the token across all its pools, ordered by time_open ascending.", "items": { "additionalProperties": true, "properties": { "close": { "type": "number" }, "high": { "type": "number" }, "low": { "type": "number" }, "open": { "type": "number" }, "time_close": { "description": "ISO 8601 timestamp of bucket close (inclusive at 23:59:59 for 24h).", "type": "string" }, "time_open": { "description": "ISO 8601 timestamp of bucket open.", "type": "string" }, "volume": { "description": "Trade volume in the bucket, in pair-quote units (or USD where applicable).", "type": "number" } }, "type": "object" }, "type": "array" } }, "required": [ "ohlcv" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "search", "description": "Search across ALL networks at once for tokens, pools, and DEXes by name, symbol, or address, returning three arrays: 'tokens', 'pools', and 'dexes'. Read-only and keyless. This is the cross-chain entry point when you do not yet know which network something lives on; once you have a network slug from the results, switch to the network-scoped tools. Use for 'find PEPE', 'what is the address for USDC', or 'which chain is this token on?'. Several words work: 'WETH USDC' returns the pools pairing both, and a network name ('brett base') narrows results to that chain. No matches returns empty arrays, not an error. Params: query (required; a name, symbol, or contract address, e.g. 'uniswap', 'bitcoin', or '0x...'); limit (optional, caps results per category, applied client-side).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "limit": { "description": "OPTIONAL: Cap items returned per category (tokens, pools, dexes). Upstream returns all matches by default; this client-side slice keeps payloads small for agents. Applies independently to each category.", "type": "number" }, "query": { "description": "REQUIRED: Search term (e.g., 'uniswap', 'bitcoin', 'ethereum', 'WETH USDC', or a token address).", "type": "string" }, "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" } }, "required": [ "query", "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "dexes": { "items": { "additionalProperties": true, "properties": { "chain": { "type": "string" }, "dex_id": { "type": "string" }, "dex_name": { "type": "string" }, "display_name": { "type": "string" }, "id": { "type": "string" }, "network_id": { "type": "string" }, "pools_count": { "type": "number" }, "protocol": { "type": "string" }, "txns_24h": { "type": "number" }, "volume_usd_24h": { "type": "number" } }, "type": "object" }, "type": "array" }, "pools": { "items": { "additionalProperties": true, "properties": { "chain": { "description": "Network slug (e.g. 'ethereum'). Note: also exposed as 'network' on some endpoints.", "type": "string" }, "created_at": { "description": "ISO 8601 pool-creation timestamp.", "type": "string" }, "created_at_block_number": { "type": "number" }, "dex_id": { "type": "string" }, "dex_name": { "type": "string" }, "fee": { "description": "Pool fee (units depend on DEX; null for some DEXes).", "type": [ "number", "null" ] }, "id": { "description": "Pool contract address.", "type": "string" }, "last_price": { "type": [ "number", "null" ] }, "last_price_usd": { "type": [ "number", "null" ] }, "tokens": { "items": { "$ref": "#/properties/tokens/items" }, "type": "array" } }, "type": "object" }, "type": "array" }, "tokens": { "items": { "additionalProperties": true, "properties": { "added_at": { "description": "ISO 8601 timestamp when DexPaprika first indexed this token.", "type": "string" }, "chain": { "type": "string" }, "decimals": { "type": "number" }, "fdv": { "description": "Fully-diluted valuation in USD.", "type": [ "number", "null" ] }, "id": { "description": "Token contract address (chain-canonical form).", "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" } }, "type": "object" }, "type": "array" } }, "required": [ "tokens", "pools", "dexes" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getStats", "description": "Get platform-wide totals for DexPaprika: the number of networks, DEXes, pools, and tokens indexed, returned as a single summary object. Read-only and keyless. Use for 'how much data do you cover?', 'how many chains or pools total?', or a one-line coverage summary. These are ecosystem-wide counts, not per-network figures; use getNetworks for the per-chain breakdown, or getCapabilities for onboarding docs. Takes no parameters beyond a short rationale.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" } }, "required": [ "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "chains": { "description": "Total chains indexed.", "type": "number" }, "factories": { "description": "Total DEX factory contracts indexed.", "type": "number" }, "pools": { "description": "Total pools indexed across all chains.", "type": "number" }, "tokens": { "description": "Total tokens indexed.", "type": "number" } }, "required": [ "chains", "factories", "pools", "tokens" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "getCapabilities", "description": "Get the static agent onboarding guide for this server: supported workflows, network name synonyms (mapping words like 'eth' to the canonical slug 'ethereum'), recommended call sequences, and common pitfalls. Read-only and keyless. Read it once at the start of a session before your first query, or when asked 'how do I use this API?', 'what order should I call things in?', or 'which slug maps to eth?'. This returns onboarding docs, not live market data; for the actual list of network slugs use getNetworks, and for coverage totals use getStats. Takes no parameters beyond a short rationale.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "rationale": { "description": "REQUIRED. 1-2 sentence rationale for this call (e.g. \"User asked for X; calling Y to fetch Z\"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples.", "maxLength": 500, "minLength": 20, "type": "string" } }, "required": [ "rationale" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "agent_skills": { "type": "string" }, "common_pitfalls": { "description": "Known edge cases agents should be aware of.", "items": { "type": "string" }, "type": "array" }, "documentation": { "type": "string" }, "network_synonyms": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "description": "Canonical network id -\u003e common alternates an agent might try.", "type": "object" }, "rate_limits": { "additionalProperties": true, "description": "How limits work for hosted tool calls. Not the REST allowances: your own plan does not apply, except to own_key_tools.", "properties": { "basis": { "type": "string" }, "on_limit": { "type": "string" }, "own_key_note": { "type": "string" }, "own_key_tools": { "items": { "type": "string" }, "type": "array" }, "rest_api_limits_url": { "type": "string" } }, "required": [ "basis", "on_limit", "own_key_tools", "own_key_note", "rest_api_limits_url" ], "type": "object" }, "server": { "additionalProperties": true, "properties": { "name": { "type": "string" }, "version": { "type": "string" } }, "required": [ "name", "version" ], "type": "object" }, "stats": { "additionalProperties": true, "properties": { "console_url": { "type": "string" }, "docs_url": { "type": "string" }, "free_key_credits_per_month": { "type": "number" }, "free_key_requests_per_minute": { "type": "number" }, "free_tier": { "type": "boolean" }, "free_tier_credits_per_month": { "type": "number" }, "free_tier_max_data_delay_seconds": { "type": "number" }, "free_tier_requests_per_minute": { "type": "number" }, "key_required_to_start": { "type": "boolean" }, "networks": { "type": "number" }, "pools_approx": { "type": "number" }, "pricing_url": { "type": "string" }, "tokens_approx": { "type": "number" } }, "required": [ "networks", "tokens_approx", "pools_approx", "free_tier", "key_required_to_start" ], "type": "object" }, "workflows": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "description": "Named tool sequences for common agent tasks.", "type": "object" } }, "required": [ "server", "stats", "network_synonyms", "workflows", "common_pitfalls", "documentation", "agent_skills" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "submitFeedback", "description": "Report a problem back to the DexPaprika team when a tool got you stuck, returned something unexpected, lacked data you needed, or behaved differently than documented. Use whenever you hit a dead end, a response shape surprised you, or coverage was missing; even partial feedback helps and every submission is read. Low friction: provide goal, expected, and observed instead of a rationale field.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "attempted_tools": { "description": "OPTIONAL: List of tool names you called, in order, before submitting this feedback.", "items": { "type": "string" }, "type": "array" }, "blocked_at": { "description": "OPTIONAL: Tool name or step where you got stuck.", "type": "string" }, "expected": { "description": "OPTIONAL: What you expected to happen. Capped at 500 characters; trim or summarize longer narratives.", "maxLength": 500, "type": "string" }, "goal": { "description": "REQUIRED: What you (or the user behind you) were trying to accomplish. 10-500 characters; longer goals are validation-rejected at the MCP layer.", "maxLength": 500, "minLength": 10, "type": "string" }, "observed": { "description": "OPTIONAL: What actually happened. Capped at 500 characters; trim or summarize longer narratives. Longer text triggers an MCP -32602 input validation error.", "maxLength": 500, "type": "string" }, "severity": { "default": "minor", "description": "OPTIONAL: How badly this affected your task. Default 'minor'.", "enum": [ "blocker", "major", "minor", "nit" ], "type": "string" } }, "required": [ "goal" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": true, "properties": { "message": { "type": "string" }, "ok": { "description": "True if the feedback row was persisted.", "type": "boolean" }, "severity": { "enum": [ "blocker", "major", "minor", "nit" ], "type": "string" }, "tracking_id": { "description": "Stable id agents can reference in follow-up submissions; null if persistence failed.", "type": [ "string", "null" ] } }, "required": [ "ok", "message" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false } } ] }, "name": "DexPaprika", "note": "Indexed from the official MCP registry: facts and our own checks, not reviewed, so no score, grade or rank.", "packages": null, "pageJsonUrl": "https://www.anchorterminal.com/tools/dexpaprika.json", "popularity": { "githubStars": 43 }, "registryName": "com.dexpaprika/dexpaprika", "remotes": [ { "type": "streamable-http", "url": "https://mcp.dexpaprika.com/streamable-http" }, { "type": "sse", "url": "https://mcp.dexpaprika.com/sse" } ], "repository": "https://github.com/coinpaprika/dexpaprika-mcp", "reviewed": false, "slug": "dexpaprika", "source": "the official MCP registry", "sourceUrl": "https://registry.modelcontextprotocol.io/v0.1/servers?search=com.dexpaprika/dexpaprika", "summary": "DEX and on-chain data: liquidity pools, token prices, swaps, and trading volume.", "updatedAt": "2026-09-29T12:45:04Z", "url": "https://www.anchorterminal.com/tools/dexpaprika", "vendor": "dexpaprika.com", "vendorUrl": "https://dexpaprika.com", "version": "2.7.1", "websiteUrl": "", "where": "hosted", "why": [ "vendor" ] } }