{"openapi":"3.1.0","info":{"title":"CoinMarketCap (BYOK) API","version":"0.1.0","description":"CoinMarketCap (BYOK) lets an AI assistant read your own CoinMarketCap data through the CoinMarketCap API with a key you supply (CoinMarketCap Pro API key). Read-only: 11 tools (get_key_info, list_top_cryptocurrencies, get_quotes, get_simple_price, get_cryptocurrency_info, list_cryptocurrency_map, get_global_metrics, get_fear_and_greed, list_gainers_losers, list_exchanges, 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-coinmarketcap.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-coinmarketcap/docs"},"termsOfService":"https://connectorbay.com/byok-coinmarketcap/terms"},"servers":[{"url":"https://byok-coinmarketcap.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-coinmarketcap/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/get_key_info":{"post":{"operationId":"get_key_info","summary":"Show the key's plan limits and credit usage for the current minute, day and month. Use for \"How many CoinMarketCap API c","description":"Show the key's plan limits and credit usage for the current minute, day and month. Use for \"How many CoinMarketCap API credits do I have left this month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_key_infoArguments","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_top_cryptocurrencies":{"post":{"operationId":"list_top_cryptocurrencies","summary":"List cryptocurrencies ranked by market cap (or another sort) with supply, rank and quotes in the chosen currency. Each 1","description":"List cryptocurrencies ranked by market cap (or another sort) with supply, rank and quotes in the chosen currency. Each 100 results beyond the first 100 costs one extra credit. Use for \"What are the top 10 cryptocurrencies by market cap\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"1-based offset of the first result, for paging.","title":"Start"},"limit":{"anyOf":[{"maximum":5000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results (1 to 5000, default 100).","title":"Limit"},"sort":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"market_cap","description":"Sort field such as market_cap, name, price, volume_24h, percent_change_24h or date_added.","title":"Sort"},"sort_dir":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Direction: asc or desc.","title":"Sort Dir"},"convert":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Fiat or crypto symbols to quote in, comma-separated, for example 'USD,EUR'. Default USD; each extra currency costs an extra API credit.","title":"Convert"},"market_cap_min":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Minimum market cap in USD.","title":"Market Cap Min"},"volume_24h_min":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Minimum 24 hour volume in USD.","title":"Volume 24H Min"}},"title":"list_top_cryptocurrenciesArguments","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_quotes":{"post":{"operationId":"get_quotes","summary":"Get the latest price, market cap, volume and percent changes for coins by CoinMarketCap ID, slug or symbol (give one of ","description":"Get the latest price, market cap, volume and percent changes for coins by CoinMarketCap ID, slug or symbol (give one of the three). Returns a list of coins. Use for \"What are the current prices of Bitcoin and Ethereum\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated coin symbols, for example 'BTC,ETH'. Symbols can be ambiguous; IDs are safer.","title":"Symbol"},"id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated CoinMarketCap IDs, for example '1,1027'.","title":"Id"},"slug":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated slugs, for example 'bitcoin,ethereum'.","title":"Slug"},"convert":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Fiat or crypto symbols to quote in, comma-separated, for example 'USD,EUR'. Default USD; each extra currency costs an extra API credit.","title":"Convert"},"skip_invalid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to skip unknown symbols instead of failing the whole call.","title":"Skip Invalid"}},"title":"get_quotesArguments","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_simple_price":{"post":{"operationId":"get_simple_price","summary":"Get just the price of coins (optionally market cap, 24 hour volume and 24 hour change) by ID, slug or symbol; the lighte","description":"Get just the price of coins (optionally market cap, 24 hour volume and 24 hour change) by ID, slug or symbol; the lightest price call. Use for \"What is the Solana price in USD\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated symbols, for example 'BTC,SOL'.","title":"Symbol"},"id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated CoinMarketCap IDs.","title":"Id"},"slug":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated slugs.","title":"Slug"},"convert":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Currencies to price in, comma-separated (default USD).","title":"Convert"},"include_all":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to also return market cap, 24 hour volume, 24 hour change and update time.","title":"Include All"}},"title":"get_simple_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}},"/v1/tools/get_cryptocurrency_info":{"post":{"operationId":"get_cryptocurrency_info","summary":"Get a coin's metadata: description, website and social links, tags, platform and launch date, by ID, slug, symbol or con","description":"Get a coin's metadata: description, website and social links, tags, platform and launch date, by ID, slug, symbol or contract address. Use for \"What is the Chainlink project and where is its website\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"slug":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated slugs, for example 'chainlink'.","title":"Slug"},"id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated CoinMarketCap IDs.","title":"Id"},"symbol":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated symbols.","title":"Symbol"},"address":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"A token contract address.","title":"Address"}},"title":"get_cryptocurrency_infoArguments","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_cryptocurrency_map":{"post":{"operationId":"list_cryptocurrency_map","summary":"Map coin symbols and names to CoinMarketCap IDs, with rank, active status and platform. Cheap call (1 credit) for findin","description":"Map coin symbols and names to CoinMarketCap IDs, with rank, active status and platform. Cheap call (1 credit) for finding IDs. Use for \"What is the CoinMarketCap ID of the coin with symbol ARB\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated symbols to look up, for example 'ARB'.","title":"Symbol"},"listing_status":{"anyOf":[{"enum":["active","inactive","untracked"],"type":"string"},{"type":"null"}],"default":null,"description":"active (default), inactive or untracked.","title":"Listing Status"},"start":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"1-based offset of the first result, for paging.","title":"Start"},"limit":{"anyOf":[{"maximum":5000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results (1 to 5000).","title":"Limit"},"sort":{"anyOf":[{"enum":["cmc_rank","id"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by cmc_rank or id.","title":"Sort"}},"title":"list_cryptocurrency_mapArguments","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_global_metrics":{"post":{"operationId":"get_global_metrics","summary":"Get global crypto market metrics: total market cap and volume, Bitcoin and Ethereum dominance, active coins and exchange","description":"Get global crypto market metrics: total market cap and volume, Bitcoin and Ethereum dominance, active coins and exchanges. Use for \"What is Bitcoin dominance and total crypto market cap today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"convert":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Fiat or crypto symbols to quote in, comma-separated, for example 'USD,EUR'. Default USD; each extra currency costs an extra API credit.","title":"Convert"}},"title":"get_global_metricsArguments","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_fear_and_greed":{"post":{"operationId":"get_fear_and_greed","summary":"Get the latest CoinMarketCap Crypto Fear and Greed Index value and its classification. Use for \"What is the crypto Fear ","description":"Get the latest CoinMarketCap Crypto Fear and Greed Index value and its classification. Use for \"What is the crypto Fear and Greed index right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_fear_and_greedArguments","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_gainers_losers":{"post":{"operationId":"list_gainers_losers","summary":"List the biggest cryptocurrency gainers and losers over a time window. Use for \"Which coins gained the most in the last ","description":"List the biggest cryptocurrency gainers and losers over a time window. Use for \"Which coins gained the most in the last 24 hours\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"1-based offset of the first result, for paging.","title":"Start"},"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many results (1 to 1000, default 100).","title":"Limit"},"time_period":{"anyOf":[{"enum":["1h","24h","7d","30d"],"type":"string"},{"type":"null"}],"default":"24h","description":"Window: 1h, 24h, 7d or 30d.","title":"Time Period"},"sort_dir":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Direction: desc for gainers first, asc for losers first.","title":"Sort Dir"},"convert":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Fiat or crypto symbols to quote in, comma-separated, for example 'USD,EUR'. Default USD; each extra currency costs an extra API credit.","title":"Convert"}},"title":"list_gainers_losersArguments","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 crypto exchanges ranked by 24 hour volume, with score, launch date and number of market pairs. Use for \"Which crypt","description":"List crypto exchanges ranked by 24 hour volume, with score, launch date and number of market pairs. Use for \"Which crypto exchanges have the most volume\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"1-based offset of the first result, for paging.","title":"Start"},"limit":{"anyOf":[{"maximum":5000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many results (1 to 5000, default 100).","title":"Limit"},"sort":{"anyOf":[{"enum":["name","volume_24h","volume_24h_adjusted","exchange_score"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by name, volume_24h, volume_24h_adjusted or exchange_score.","title":"Sort"},"category":{"anyOf":[{"enum":["all","spot","derivatives","dex","lending"],"type":"string"},{"type":"null"}],"default":null,"description":"all, spot, derivatives, dex or lending.","title":"Category"},"convert":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Fiat or crypto symbols to quote in, comma-separated, for example 'USD,EUR'. Default USD; each extra currency costs an extra API credit.","title":"Convert"}},"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/convert_price":{"post":{"operationId":"convert_price","summary":"Convert an amount of one cryptocurrency or fiat currency into others at the current rate (or a past time). Use for \"How ","description":"Convert an amount of one cryptocurrency or fiat currency into others at the current rate (or a past time). Use for \"How much is 2.5 ETH worth in USD and EUR\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"amount":{"description":"Amount to convert (0.00000001 to 1000000000000).","maximum":1000000000000,"minimum":1e-08,"title":"Amount","type":"number"},"symbol":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Symbol to convert from, for example 'ETH'.","title":"Symbol"},"id":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Or the CoinMarketCap ID to convert from.","title":"Id"},"convert":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Symbols to convert to, comma-separated, for example 'USD,EUR'.","title":"Convert"},"time":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Optional past time (Unix or ISO 8601) to use historical prices.","title":"Time"}},"required":["amount"],"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}}}}