JSON-RPC Usage Guide

Quick Start

The JSON-RPC endpoint provides reliable access to cryptocurrency data for AI agents and custom applications. Endpoint: https://mcp.coinpaprika.com/json-rpc

Basic Usage

Search for cryptocurrencies

curl -X POST 'https://mcp.coinpaprika.com/json-rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search",
      "arguments": {
        "q": "bitcoin",
        "limit": 5
      }
    }
  }'

Response Format

Results are returned in result.content[0].text as stringified JSON:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"data\": \"...\"}"
      }
    ]
  }
}

Error Handling

The MCP server returns standard JSON-RPC error codes. Upstream HTTP statuses may map to messages like 400/402/403/429. Inspect the JSON-RPC error.message field for specific error details.

Best Practices

Implement caching to reduce redundant requests
Use reasonable retry policies with jitter for network resilience
Handle errors gracefully with proper fallback mechanisms
Consider batching multiple requests when possible

Available Tools

To discover all available tools, use the tools/list method:

curl -X POST 'https://mcp.coinpaprika.com/json-rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Tool Call Structure

All tools follow this structure:

Field	Description	Example
`name`	Tool name	`"search"`
`arguments`	Tool-specific parameters	`{"q": "bitcoin", "limit": 5}`

Available Tools

Tool	Description	Arguments	Example
getGlobal	Market overview	none	`{}`
getCoins	List coins	limit: number (50)	`{"limit": 25}`
getCoinById	Coin details	coinId: string	`{"coinId": "btc-bitcoin"}`
getCoinEvents	Events for a coin	coinId: string; limit: number (50)	`{"coinId": "btc-bitcoin", "limit": 10}`
getCoinExchanges	Exchanges for a coin	coinId: string; limit: number (50)	`{"coinId": "btc-bitcoin", "limit": 10}`
getCoinMarkets	Markets for a coin	coinId: string; quotes: string; limit: number (50)	`{"coinId": "btc-bitcoin", "quotes": "usd,btc", "limit": 10}`
getTickers	All tickers	quotes: string; limit: number (50)	`{"quotes": "usd", "limit": 10}`
getTickersById	Ticker for coin	coinId: string; quotes: string	`{"coinId": "btc-bitcoin", "quotes": "usd"}`
getPeopleById	Person details	personId: string	`{"personId": "satoshi-nakamoto"}`
getTags	List tags	additionalFields: string; limit: number (50)	`{"additionalFields": "id,name", "limit": 10}`
getTagById	Tag details	tagId: string; additionalFields: string	`{"tagId": "defi"}`
getExchanges	List exchanges	quotes: string; limit: number (50)	`{"quotes": "usd", "limit": 10}`
getExchangeByID	Exchange details	exchangeId: string; quotes: string	`{"exchangeId": "binance", "quotes": "usd"}`
getExchangeMarkets	Markets on exchange	exchangeId: string; quotes: string; limit: number (50)	`{"exchangeId": "binance", "quotes": "usd", "limit": 10}`
getPlatforms	List contract platforms	limit: number (50)	`{"limit": 10}`
getContracts	Contracts for a platform	platformId: string; limit: number (50)	`{"platformId": "eth-ethereum", "limit": 10}`
getTickerByContract	Ticker by contract address	platformId: string; contractAddress: string	`{"platformId": "eth-ethereum", "contractAddress": "0x..."}`
priceConverter	Convert base to quote	baseCurrencyId: string; quoteCurrencyId: string; amount: number (0)	`{"baseCurrencyId": "btc-bitcoin", "quoteCurrencyId": "usd", "amount": 1}`
search	Search currencies, exchanges, icos, people, tags	q: string; categories: string; modifier: string; limit: number (50)	`{"q": "btc", "categories": "currencies,exchanges", "modifier": "symbol", "limit": 5}`
status	API health check	none	`{}`
getCapabilities	Agent onboarding notes for this server	none	`{}`
resolveId	Resolve a name or symbol to a canonical ID	type: string; query: string; limit: number	`{"type": "coin", "query": "bitcoin", "limit": 5}`
getCoinOHLCVLatest	OHLCV for the last full day	coinId: string; quote: string	`{"coinId": "btc-bitcoin", "quote": "usd"}`
getCoinOHLCVToday	OHLCV for the current day	coinId: string; quote: string	`{"coinId": "btc-bitcoin", "quote": "usd"}`
getCoinOHLCVHistorical	Historical OHLCV	coinId: string; start: string; end: string; limit: number; interval: string; quote: string	`{"coinId": "btc-bitcoin", "start": "2026-07-01", "interval": "24h"}`
getTickersHistoricalById	Historical ticks for a coin	coinId: string; start: string; end: string; limit: number; quote: string; interval: string	`{"coinId": "btc-bitcoin", "start": "2026-07-01", "interval": "1d"}`
getHistoricalTickerByContract	Historical ticks by contract address	platformId: string; contractAddress: string; start: string; end: string; limit: number; quote: string; interval: string	`{"platformId": "eth-ethereum", "contractAddress": "0x...", "start": "2026-07-01"}`
keyInfo	API key plan and monthly usage	none	`{}`
getMappings	Map other providers’ IDs to CoinPaprika IDs	coinpaprika: string; coinmarketcap: string; coingecko: string; cryptocompare: string; isin: string; dti: string	`{"coingecko": "bitcoin"}`
getChangelogIDs	Coin ID changes made by moderators	page: number; limit: number	`{"page": 1, "limit": 50}`
submitFeedback	Report a gap or problem with this server	goal: string; attempted_tools: string; blocked_at: string; expected: string; observed: string; severity: string	`{"goal": "Fetch hourly OHLCV", "observed": "402 returned"}`

This table is the full set of 31 tools the server exposes. To confirm it against the running server at any time, call tools/list as shown above.

Call Pattern Template

curl -sS -X POST 'https://mcp.coinpaprika.com/json-rpc' \
  -H 'content-type: application/json' \
  --data '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"tools/call",
    "params":{"name":"<TOOL>","arguments":{ /* see table */ }}
  }'

AI & Tools

Get Started

API Reference

SDKs & Libraries

Quick Start

Basic Usage

Search for cryptocurrencies

Response Format

Error Handling

Best Practices

Available Tools

Tool Call Structure

Available Tools

Call Pattern Template

What’s Next?

Connect Claude Desktop or Cursor

Explore Available Tools

Need Help?

Join Our Discord

Direct Support

​Quick Start

​Basic Usage

​Search for cryptocurrencies

​Response Format

​Error Handling

​Best Practices

​Available Tools

​Tool Call Structure

​Available Tools

​Call Pattern Template

​What’s Next?

Connect Claude Desktop or Cursor

Explore Available Tools

​Need Help?

Join Our Discord

Direct Support

Quick Start

Basic Usage

Search for cryptocurrencies

Response Format

Error Handling

Best Practices

Available Tools

Tool Call Structure

Available Tools

Call Pattern Template

What’s Next?

Need Help?