{"openapi":"3.1.0","info":{"title":"CoinGecko (BYOK) API","version":"0.1.0","description":"CoinGecko (BYOK) lets an AI assistant read your own CoinGecko data through the CoinGecko API with a key you supply (demo API key). Read-only: 7 tools (get_simple_price, list_coin_markets, get_coin, get_market_chart, get_trending, search_coins, list_supported_vs_currencies). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-coingecko.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-coingecko/docs"},"termsOfService":"https://connectorbay.com/byok-coingecko/terms"},"servers":[{"url":"https://byok-coingecko.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-coingecko/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_simple_price":{"post":{"operationId":"get_simple_price","summary":"Get the current price of one or more coins in one or more currencies, optionally with market cap, 24-hour volume and 24-","description":"Get the current price of one or more coins in one or more currencies, optionally with market cap, 24-hour volume and 24-hour change. The answer is keyed by coin ID, then by currency code. Use for \"What is the price of bitcoin and ethereum in dollars and euros\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ids":{"description":"Comma-separated CoinGecko coin IDs, for example 'bitcoin,ethereum' (up to 515 per request).","maxLength":2000,"title":"Ids","type":"string"},"vs_currencies":{"description":"Comma-separated currency codes to price in, for example 'usd,eur'.","maxLength":200,"title":"Vs Currencies","type":"string"},"include_market_cap":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to add market capitalisation.","title":"Include Market Cap"},"include_24hr_vol":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to add the 24-hour trading volume.","title":"Include 24Hr Vol"},"include_24hr_change":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to add the 24-hour percentage change.","title":"Include 24Hr Change"},"include_last_updated_at":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to add the time of the last price update as a Unix timestamp.","title":"Include Last Updated At"}},"required":["ids","vs_currencies"],"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/list_coin_markets":{"post":{"operationId":"list_coin_markets","summary":"List coins with price, market cap, rank, 24-hour volume and range, supply and all-time high, ranked by market cap by def","description":"List coins with price, market cap, rank, 24-hour volume and range, supply and all-time high, ranked by market cap by default. Use for \"What are the top 10 cryptocurrencies by market cap\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vs_currency":{"description":"Currency to quote prices in, as a lowercase code such as usd, eur, gbp, jpy or btc (see list_supported_vs_currencies).","maxLength":20,"title":"Vs Currency","type":"string"},"ids":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated coin IDs to restrict the list to (up to 250), for example 'bitcoin,ethereum'.","title":"Ids"},"category":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only coins in this CoinGecko category ID, for example 'layer-1'.","title":"Category"},"order":{"anyOf":[{"enum":["market_cap_asc","market_cap_desc","volume_asc","volume_desc","id_asc","id_desc"],"type":"string"},{"type":"null"}],"default":"market_cap_desc","description":"Sort order.","title":"Order"},"per_page":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many coins to return (1 to 250).","title":"Per Page"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"price_change_percentage":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated periods to add price change for: 1h, 24h, 7d, 14d, 30d, 200d, 1y (returned as price_change_percentage_<period>_in_currency).","title":"Price Change Percentage"}},"required":["vs_currency"],"title":"list_coin_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/get_coin":{"post":{"operationId":"get_coin","summary":"Get one coin's profile: name, market rank, description, categories, homepage links, genesis date, and USD price, market ","description":"Get one coin's profile: name, market rank, description, categories, homepage links, genesis date, and USD price, market cap, volume, price changes, supply and all-time high and low. Use for \"Tell me about Ethereum: description, price and supply\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"CoinGecko coin ID, for example 'bitcoin' or 'ethereum' (not the ticker symbol; use search_coins to find it).","maxLength":200,"title":"Id","type":"string"},"market_data":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"description":"True to include the market data block.","title":"Market Data"},"tickers":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include exchange ticker data (large; up to 100 entries).","title":"Tickers"},"localization":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include translated names and descriptions in all languages (large).","title":"Localization"}},"required":["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_market_chart":{"post":{"operationId":"get_market_chart","summary":"Get price, market cap and trading volume history of one coin as lists of [Unix time in milliseconds, value] pairs. Granu","description":"Get price, market cap and trading volume history of one coin as lists of [Unix time in milliseconds, value] pairs. Granularity is automatic (5-minute for 1 day, hourly for 2 to 90 days, daily above that) unless interval is set. How far back a key can read depends on its plan; long ranges return many points and are cut off. Use for \"Show bitcoin's price over the last 30 days\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"CoinGecko coin ID, for example 'bitcoin' or 'ethereum' (not the ticker symbol; use search_coins to find it).","maxLength":200,"title":"Id","type":"string"},"vs_currency":{"description":"Currency to quote prices in, as a lowercase code such as usd, eur, gbp, jpy or btc (see list_supported_vs_currencies).","maxLength":20,"title":"Vs Currency","type":"string"},"days":{"description":"How many days back from now: a whole number such as 1, 7, 30 or 365, or 'max'.","maxLength":5,"title":"Days","type":"string"},"interval":{"anyOf":[{"enum":["daily","hourly"],"type":"string"},{"type":"null"}],"default":null,"description":"Force daily or hourly points (hourly reaches back at most 100 days); leave unset for automatic.","title":"Interval"}},"required":["id","vs_currency","days"],"title":"get_market_chartArguments","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_trending":{"post":{"operationId":"get_trending","summary":"Get what is trending on CoinGecko in the last 24 hours: trending coins, NFTs and categories with rank and price data. Us","description":"Get what is trending on CoinGecko in the last 24 hours: trending coins, NFTs and categories with rank and price data. Use for \"Which coins are trending on CoinGecko right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_trendingArguments","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/search_coins":{"post":{"operationId":"search_coins","summary":"Search CoinGecko by name or symbol for coins, exchanges, categories and NFTs; returns their IDs and market cap rank, sor","description":"Search CoinGecko by name or symbol for coins, exchanges, categories and NFTs; returns their IDs and market cap rank, sorted by market cap. Use it to find the coin ID the other tools need. Use for \"What is the CoinGecko ID of the Solana coin\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Name or symbol to search for, for example 'solana' or 'sol'.","maxLength":100,"title":"Query","type":"string"}},"required":["query"],"title":"search_coinsArguments","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_supported_vs_currencies":{"post":{"operationId":"list_supported_vs_currencies","summary":"List every currency code (fiat, crypto and units such as sats) that can be used as vs_currency or vs_currencies. Use for","description":"List every currency code (fiat, crypto and units such as sats) that can be used as vs_currency or vs_currencies. Use for \"Which currencies can I get crypto prices in\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_supported_vs_currenciesArguments","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}}}}