{"openapi":"3.1.0","info":{"title":"Live Coin Watch (BYOK) API","version":"0.1.0","description":"Live Coin Watch (BYOK) lets an AI assistant read your own Live Coin Watch data through the Live Coin Watch API with a key you supply (Live Coin Watch API key). Read-only: 10 tools (get_credits, get_market_overview, get_market_overview_history, get_coin, get_coin_by_contract, get_coin_history, list_coins, get_exchange, list_exchanges, list_fiat_currencies). The BYOK key travels with each request,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-livecoinwatch.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-livecoinwatch/docs"},"termsOfService":"https://connectorbay.com/byok-livecoinwatch/terms"},"servers":[{"url":"https://byok-livecoinwatch.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-livecoinwatch/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_credits":{"post":{"operationId":"get_credits","summary":"Show how many API credits remain today and the daily limit (each request costs one credit from a free daily allowance). ","description":"Show how many API credits remain today and the daily limit (each request costs one credit from a free daily allowance). Use for \"How many Live Coin Watch API credits do I have left today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_creditsArguments","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 current crypto market totals: total market cap, 24-hour volume, liquidity and Bitcoin dominance in a chosen curr","description":"Get the current crypto market totals: total market cap, 24-hour volume, liquidity and Bitcoin dominance in a chosen currency. Use for \"What is the total crypto market cap and Bitcoin dominance right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"currency":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":"USD","description":"Currency the answer is priced in: any fiat code (USD, EUR, INR) or coin code (BTC, ETH).","title":"Currency"}},"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/get_market_overview_history":{"post":{"operationId":"get_market_overview_history","summary":"Get historical crypto market totals (market cap, volume, liquidity, Bitcoin dominance) between two timestamps. Use for \"","description":"Get historical crypto market totals (market cap, volume, liquidity, Bitcoin dominance) between two timestamps. Use for \"How did total crypto market cap move over the last day\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start":{"description":"Start of the interval as a UNIX timestamp in milliseconds.","minimum":0,"title":"Start","type":"integer"},"end":{"description":"End of the interval as a UNIX timestamp in milliseconds.","minimum":0,"title":"End","type":"integer"},"currency":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":"USD","description":"Currency the answer is priced in: any fiat code (USD, EUR, INR) or coin code (BTC, ETH).","title":"Currency"}},"required":["start","end"],"title":"get_market_overview_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":{"post":{"operationId":"get_coin","summary":"Get the current price, market cap, volume, supply, rank and price change factors of one coin by code. Change values are ","description":"Get the current price, market cap, volume, supply, rank and price change factors of one coin by code. Change values are factors: 1.02 means plus 2 percent. Use for \"What is the current price of ETH in EUR\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"code":{"description":"Coin code such as BTC or ETH.","maxLength":20,"title":"Code","type":"string"},"currency":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":"USD","description":"Currency the answer is priced in: any fiat code (USD, EUR, INR) or coin code (BTC, ETH).","title":"Currency"},"meta":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"description":"True to include full coin information such as name and supply.","title":"Meta"}},"required":["code"],"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_by_contract":{"post":{"operationId":"get_coin_by_contract","summary":"Get the current price and market data of a token by its platform code and contract address. Use for \"What is the price o","description":"Get the current price and market data of a token by its platform code and contract address. Use for \"What is the price of the token at this Ethereum contract address\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"platform":{"description":"Platform code, for example ETH.","maxLength":20,"title":"Platform","type":"string"},"address":{"description":"Token contract address.","maxLength":100,"title":"Address","type":"string"},"currency":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":"USD","description":"Currency the answer is priced in: any fiat code (USD, EUR, INR) or coin code (BTC, ETH).","title":"Currency"},"meta":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"description":"True to include full coin information.","title":"Meta"}},"required":["platform","address"],"title":"get_coin_by_contractArguments","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_history":{"post":{"operationId":"get_coin_history","summary":"Get the price, volume and market cap history of one coin between two timestamps. Use for \"Show Bitcoin's price history f","description":"Get the price, volume and market cap history of one coin between two timestamps. Use for \"Show Bitcoin's price history for the last 24 hours\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"code":{"description":"Coin code such as BTC.","maxLength":20,"title":"Code","type":"string"},"start":{"description":"Start of the interval as a UNIX timestamp in milliseconds.","minimum":0,"title":"Start","type":"integer"},"end":{"description":"End of the interval as a UNIX timestamp in milliseconds.","minimum":0,"title":"End","type":"integer"},"currency":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":"USD","description":"Currency the answer is priced in: any fiat code (USD, EUR, INR) or coin code (BTC, ETH).","title":"Currency"},"meta":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include full coin information next to the history.","title":"Meta"}},"required":["code","start","end"],"title":"get_coin_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_coins":{"post":{"operationId":"list_coins","summary":"List coins ranked by market data (rank, price, volume, age, name or code) with price, volume, market cap and change fact","description":"List coins ranked by market data (rank, price, volume, age, name or code) with price, volume, market cap and change factors. Use for \"What are the top 10 coins by market cap right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"currency":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":"USD","description":"Currency the answer is priced in: any fiat code (USD, EUR, INR) or coin code (BTC, ETH).","title":"Currency"},"sort":{"anyOf":[{"enum":["rank","price","volume","code","name","age"],"type":"string"},{"type":"null"}],"default":"rank","description":"Sort by: rank, price, volume, code, name or age.","title":"Sort"},"order":{"anyOf":[{"enum":["ascending","descending"],"type":"string"},{"type":"null"}],"default":"descending","description":"Sort direction: ascending or descending.","title":"Order"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many entries to skip (for paging).","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many entries to return (1 to 100).","title":"Limit"},"meta":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"description":"True to include full coin information such as name.","title":"Meta"}},"title":"list_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/get_exchange":{"post":{"operationId":"get_exchange","summary":"Get one exchange's market count, 24-hour volume, order book depth, daily visitors and whether it is centralized. Use for","description":"Get one exchange's market count, 24-hour volume, order book depth, daily visitors and whether it is centralized. Use for \"How much volume does Gemini have in the last 24 hours\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"code":{"description":"Exchange code such as gemini.","maxLength":50,"title":"Code","type":"string"},"currency":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":"USD","description":"Currency the answer is priced in: any fiat code (USD, EUR, INR) or coin code (BTC, ETH).","title":"Currency"},"meta":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"description":"True to include full exchange information such as name.","title":"Meta"}},"required":["code"],"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_exchanges":{"post":{"operationId":"list_exchanges","summary":"List exchanges ranked by volume, liquidity, name or code with market counts, volume and depth. Use for \"Which exchanges ","description":"List exchanges ranked by volume, liquidity, name or code with market counts, volume and depth. Use for \"Which exchanges have the highest trading volume\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"currency":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":"USD","description":"Currency the answer is priced in: any fiat code (USD, EUR, INR) or coin code (BTC, ETH).","title":"Currency"},"sort":{"anyOf":[{"enum":["volume","liquidity","code","name"],"type":"string"},{"type":"null"}],"default":"volume","description":"Sort by: volume, liquidity, code or name.","title":"Sort"},"order":{"anyOf":[{"enum":["ascending","descending"],"type":"string"},{"type":"null"}],"default":"descending","description":"Sort direction: ascending or descending.","title":"Order"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many entries to skip (for paging).","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many entries to return (1 to 100).","title":"Limit"},"meta":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"description":"True to include full exchange information such as name.","title":"Meta"}},"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/list_fiat_currencies":{"post":{"operationId":"list_fiat_currencies","summary":"List the fiat currencies supported as pricing currencies, with ISO code, name, symbol and countries. Use for \"Which fiat","description":"List the fiat currencies supported as pricing currencies, with ISO code, name, symbol and countries. Use for \"Which fiat currencies can Live Coin Watch price coins in\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_fiat_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}}}}