{"openapi":"3.1.0","info":{"title":"CoinPaprika (BYOK) API","version":"0.1.0","description":"CoinPaprika (BYOK) lets an AI assistant read your own CoinPaprika data through the CoinPaprika API with a key you supply (CoinPaprika API key (paid plan)). Read-only: 12 tools (search_assets, get_market_overview, list_tickers, get_ticker, get_coin, get_coin_ohlcv_today, get_coin_ohlcv_history, get_coin_price_history, list_exchanges, get_exchange, list_exchange_markets, convert_price). The BYOK...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-coinpaprika.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-coinpaprika/docs"},"termsOfService":"https://connectorbay.com/byok-coinpaprika/terms"},"servers":[{"url":"https://byok-coinpaprika.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-coinpaprika/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_assets":{"post":{"operationId":"search_assets","summary":"Search coins, exchanges, ICOs, people and tags by name or symbol; returns matches per category. Use for \"Find the CoinPa","description":"Search coins, exchanges, ICOs, people and tags by name or symbol; returns matches per category. Use for \"Find the CoinPaprika id for Solana\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"Name or symbol to look for, for example 'sol'.","maxLength":100,"title":"Q","type":"string"},"c":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":"currencies,exchanges,icos,people,tags","description":"Comma-separated categories: currencies, exchanges, icos, people, tags (default all).","title":"C"},"limit":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":6,"description":"Results per category (1 to 250).","title":"Limit"}},"required":["q"],"title":"search_assetsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_market_overview":{"post":{"operationId":"get_market_overview","summary":"Get the overall crypto market: total market cap, 24 hour volume, Bitcoin dominance and number of coins. Use for \"What is","description":"Get the overall crypto market: total market cap, 24 hour volume, Bitcoin dominance and number of coins. Use for \"What is the total crypto market cap and Bitcoin dominance\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_market_overviewArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_tickers":{"post":{"operationId":"list_tickers","summary":"List current price, volume, market cap and changes of active coins (all coins, so the answer is cut to the first 50), in","description":"List current price, volume, market cap and changes of active coins (all coins, so the answer is cut to the first 50), in up to 3 quote currencies. Use for \"Show the top coins by rank with their USD prices\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"quotes":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"USD","description":"Comma-separated quote currencies, at most 3, for example 'USD,BTC'. Allowed values include USD, BTC, ETH, EUR, GBP, JPY, INR.","title":"Quotes"}},"title":"list_tickersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_ticker":{"post":{"operationId":"get_ticker","summary":"Get current price, volume, market cap, supply and percent changes of one coin in up to 3 quote currencies. Use for \"What","description":"Get current price, volume, market cap, supply and percent changes of one coin in up to 3 quote currencies. Use for \"What is the current Bitcoin price in USD and EUR\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"coin_id":{"description":"CoinPaprika coin id such as 'btc-bitcoin' or 'eth-ethereum' (find ids with search_assets or list_tickers).","maxLength":200,"title":"Coin Id","type":"string"},"quotes":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"USD","description":"Comma-separated quote currencies, at most 3, for example 'USD,BTC'. Allowed values include USD, BTC, ETH, EUR, GBP, JPY, INR.","title":"Quotes"}},"required":["coin_id"],"title":"get_tickerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_coin":{"post":{"operationId":"get_coin","summary":"Get descriptive data of one coin: type, rank, description, tags, team size, links and proof type (no prices). Use for \"D","description":"Get descriptive data of one coin: type, rank, description, tags, team size, links and proof type (no prices). Use for \"Describe Ethereum: what type of coin is it and who built it\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"coin_id":{"description":"CoinPaprika coin id such as 'eth-ethereum'.","maxLength":200,"title":"Coin Id","type":"string"}},"required":["coin_id"],"title":"get_coinArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_coin_ohlcv_today":{"post":{"operationId":"get_coin_ohlcv_today","summary":"Get open, high, low, close, volume and market cap of a coin for the current day so far, in USD or BTC. Use for \"What is ","description":"Get open, high, low, close, volume and market cap of a coin for the current day so far, in USD or BTC. Use for \"What is Bitcoin's range so far today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"coin_id":{"description":"CoinPaprika coin id such as 'btc-bitcoin' or 'eth-ethereum' (find ids with search_assets or list_tickers).","maxLength":200,"title":"Coin Id","type":"string"},"quote":{"anyOf":[{"enum":["usd","btc"],"type":"string"},{"type":"null"}],"default":"usd","description":"Quote currency of the returned data: 'usd' or 'btc' only.","title":"Quote"}},"required":["coin_id"],"title":"get_coin_ohlcv_todayArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_coin_ohlcv_history":{"post":{"operationId":"get_coin_ohlcv_history","summary":"Get candles (open, high, low, close, volume, market cap) of a coin between two dates, in USD or BTC. The range is at mos","description":"Get candles (open, high, low, close, volume, market cap) of a coin between two dates, in USD or BTC. The range is at most 1 year; finer intervals need higher plans. Use for \"Show Bitcoin's daily candles for September 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"coin_id":{"description":"CoinPaprika coin id such as 'btc-bitcoin' or 'eth-ethereum' (find ids with search_assets or list_tickers).","maxLength":200,"title":"Coin Id","type":"string"},"start":{"description":"Start of the range: YYYY-MM-DD, an ISO 8601 time or a Unix timestamp in seconds.","maxLength":30,"title":"Start","type":"string"},"end":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"End of the range in the same formats as start.","title":"End"},"limit":{"anyOf":[{"maximum":366,"minimum":1,"type":"integer"},{"type":"null"}],"default":30,"description":"Maximum rows (1 to 366).","title":"Limit"},"interval":{"anyOf":[{"enum":["5m","15m","30m","1h","6h","12h","24h"],"type":"string"},{"type":"null"}],"default":"24h","description":"Candle interval: 5m, 15m, 30m, 1h, 6h, 12h or 24h.","title":"Interval"},"quote":{"anyOf":[{"enum":["usd","btc"],"type":"string"},{"type":"null"}],"default":"usd","description":"Quote currency of the returned data: 'usd' or 'btc' only.","title":"Quote"}},"required":["coin_id","start"],"title":"get_coin_ohlcv_historyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_coin_price_history":{"post":{"operationId":"get_coin_price_history","summary":"Get historical price, 24 hour volume and market cap ticks of a coin at an interval, in USD or BTC. Use for \"How did Ethe","description":"Get historical price, 24 hour volume and market cap ticks of a coin at an interval, in USD or BTC. Use for \"How did Ethereum's price move over the last week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"coin_id":{"description":"CoinPaprika coin id such as 'btc-bitcoin' or 'eth-ethereum' (find ids with search_assets or list_tickers).","maxLength":200,"title":"Coin Id","type":"string"},"start":{"description":"Start of the range: YYYY-MM-DD, an ISO 8601 time or a Unix timestamp in seconds.","maxLength":30,"title":"Start","type":"string"},"end":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"End of the range in the same formats as start.","title":"End"},"limit":{"anyOf":[{"maximum":5000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"Maximum rows (1 to 5000).","title":"Limit"},"interval":{"anyOf":[{"enum":["5m","10m","15m","30m","45m","1h","2h","3h","6h","12h","24h","1d","7d","14d","30d","90d","365d"],"type":"string"},{"type":"null"}],"default":"1d","description":"Tick interval such as 5m, 1h, 6h, 24h, 7d, 30d.","title":"Interval"},"quote":{"anyOf":[{"enum":["usd","btc"],"type":"string"},{"type":"null"}],"default":"usd","description":"Quote currency of the returned data: 'usd' or 'btc' only.","title":"Quote"}},"required":["coin_id","start"],"title":"get_coin_price_historyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_exchanges":{"post":{"operationId":"list_exchanges","summary":"List the exchanges CoinPaprika tracks with rank, number of markets and coins, and 24 hour volume. Use for \"Which crypto ","description":"List the exchanges CoinPaprika tracks with rank, number of markets and coins, and 24 hour volume. Use for \"Which crypto exchanges have the highest volume\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"quotes":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"USD","description":"Comma-separated quote currencies, at most 3, for example 'USD,BTC'. Allowed values include USD, BTC, ETH, EUR, GBP, JPY, INR.","title":"Quotes"}},"title":"list_exchangesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_exchange":{"post":{"operationId":"get_exchange","summary":"Get one exchange: description, rank, number of coins and markets, links and 24 hour, 7 day and 30 day volume. Use for \"T","description":"Get one exchange: description, rank, number of coins and markets, links and 24 hour, 7 day and 30 day volume. Use for \"Tell me about the Kraken exchange\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"exchange_id":{"description":"CoinPaprika exchange id such as 'kraken'.","maxLength":200,"title":"Exchange Id","type":"string"},"quotes":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"USD","description":"Comma-separated quote currencies, at most 3, for example 'USD,BTC'. Allowed values include USD, BTC, ETH, EUR, GBP, JPY, INR.","title":"Quotes"}},"required":["exchange_id"],"title":"get_exchangeArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_exchange_markets":{"post":{"operationId":"list_exchange_markets","summary":"List the trading pairs on one exchange with price, 24 hour volume and share of the exchange's volume. Use for \"Which pai","description":"List the trading pairs on one exchange with price, 24 hour volume and share of the exchange's volume. Use for \"Which pairs trade on Kraken and what are their volumes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"exchange_id":{"description":"CoinPaprika exchange id such as 'kraken'.","maxLength":200,"title":"Exchange Id","type":"string"},"quotes":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"USD","description":"Comma-separated quote currencies, at most 3, for example 'USD,BTC'. Allowed values include USD, BTC, ETH, EUR, GBP, JPY, INR.","title":"Quotes"}},"required":["exchange_id"],"title":"list_exchange_marketsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/convert_price":{"post":{"operationId":"convert_price","summary":"Convert an amount of one coin or currency into another at current prices, using CoinPaprika ids. Use for \"How many ETH i","description":"Convert an amount of one coin or currency into another at current prices, using CoinPaprika ids. Use for \"How many ETH is 2 BTC worth right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"base_currency_id":{"description":"Coin or currency id to convert from, for example 'btc-bitcoin'.","maxLength":60,"title":"Base Currency Id","type":"string"},"quote_currency_id":{"description":"Coin or currency id to convert to, for example 'eth-ethereum'.","maxLength":60,"title":"Quote Currency Id","type":"string"},"amount":{"anyOf":[{"maximum":1000000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":1,"description":"Amount of the base currency (whole number).","title":"Amount"}},"required":["base_currency_id","quote_currency_id"],"title":"convert_priceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}