{"openapi":"3.1.0","info":{"title":"Coinwise API","version":"0.1.0","description":"Crypto, read-only: prices, profiles, history, comparisons, portfolio valuation, Bitcoin network, Ethereum gas, address balances, DeFi, stablecoins.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://coinwise.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/coinwise/docs"},"termsOfService":"https://connectorbay.com/coinwise/terms"},"servers":[{"url":"https://coinwise.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/coinwise/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/price":{"post":{"operationId":"price","summary":"Current price with 1h/24h/7d/30d/1y changes, 24h range, market cap and rank, volume, supply and distance from the","description":"Current price with 1h/24h/7d/30d/1y changes, 24h range, market cap and rank, volume, supply and distance from the\n    all-time high, for up to twenty coins. Use for \"what's bitcoin at\", \"how's ETH doing this week\", \"SOL price in EUR\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"coins":{"description":"One to twenty coins by name, ticker or id.","examples":[["bitcoin","ETH","solana"]],"items":{"type":"string"},"maxItems":20,"minItems":1,"title":"Coins","type":"array"},"currency":{"default":"usd","description":"Quote currency: usd, eur, gbp, inr, brl, jpy, btc, eth…","examples":["usd","eur"],"title":"Currency","type":"string"}},"required":["coins"],"title":"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/coin_profile":{"post":{"operationId":"coin_profile","summary":"What a coin is: description, categories, launch date, consensus, chains it lives on, supply and market cap, ATH/ATL,","description":"What a coin is: description, categories, launch date, consensus, chains it lives on, supply and market cap, ATH/ATL,\n    links (site, whitepaper, explorers, GitHub), community sentiment, developer activity and any public notice CoinGecko has\n    posted. Use for \"what is Chainlink\", \"is this token legit\", \"when did Solana launch\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"coin":{"description":"Coin name, ticker or CoinGecko id: 'bitcoin', 'BTC', 'solana', 'pepe'.","examples":["bitcoin","ETH","solana"],"title":"Coin","type":"string"}},"required":["coin"],"title":"coin_profileArguments","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/price_history":{"post":{"operationId":"price_history","summary":"Price over a window: start/end, high and low with dates, average, total change, max drawdown from the window's peak and","description":"Price over a window: start/end, high and low with dates, average, total change, max drawdown from the window's peak and\n    volatility (standard deviation of daily returns), plus a compact series (~30 points). Use for \"how did BTC do this\n    month\", \"what was the low in the last 90 days\", \"how volatile has SOL been\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"coin":{"description":"Coin name, ticker or CoinGecko id: 'bitcoin', 'BTC', 'solana', 'pepe'.","examples":["bitcoin","ETH","solana"],"title":"Coin","type":"string"},"days":{"default":30,"description":"Window in days (1–365).","maximum":365,"minimum":1,"title":"Days","type":"integer"},"currency":{"default":"usd","description":"Quote currency: usd, eur, gbp, inr, brl, jpy, btc, eth…","examples":["usd","eur"],"title":"Currency","type":"string"}},"required":["coin"],"title":"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/compare_coins":{"post":{"operationId":"compare_coins","summary":"Side by side: price, market cap and rank, 24h/7d/30d/1y change, volume-to-market-cap ratio, supply issued vs max, and","description":"Side by side: price, market cap and rank, 24h/7d/30d/1y change, volume-to-market-cap ratio, supply issued vs max, and\n    distance from ATH, with who leads on each. Use for \"ETH vs SOL\", \"compare the top L2s\", \"which has more of its supply out\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"coins":{"description":"Two to six coins.","items":{"type":"string"},"maxItems":6,"minItems":2,"title":"Coins","type":"array"},"currency":{"default":"usd","description":"Quote currency: usd, eur, gbp, inr, brl, jpy, btc, eth…","examples":["usd","eur"],"title":"Currency","type":"string"}},"required":["coins"],"title":"compare_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/portfolio_value":{"post":{"operationId":"portfolio_value","summary":"Value a list of holdings at current prices: total, per-coin value and allocation, 24h change in money terms, and P&L","description":"Value a list of holdings at current prices: total, per-coin value and allocation, 24h change in money terms, and P&L\n    against the cost basis when given — computed for this call only; nothing is stored. Use for \"what's my crypto worth\",\n    \"how much am I up on my ETH\", \"what's my allocation\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"holdings":{"description":"Holdings as [{coin, amount, cost_basis?}], e.g. [{'coin':'BTC','amount':0.5,'cost_basis':30000}] where cost_basis is the average price paid per unit (optional).","items":{"additionalProperties":true,"type":"object"},"maxItems":40,"minItems":1,"title":"Holdings","type":"array"},"currency":{"default":"usd","description":"Quote currency: usd, eur, gbp, inr, brl, jpy, btc, eth…","examples":["usd","eur"],"title":"Currency","type":"string"}},"required":["holdings"],"title":"portfolio_valueArguments","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":{"post":{"operationId":"convert","summary":"Convert between a coin and a fiat currency, or coin to coin, at the current price. Use for \"how much is 0.3 BTC in","description":"Convert between a coin and a fiat currency, or coin to coin, at the current price. Use for \"how much is 0.3 BTC in\n    dollars\", \"what's $500 in ETH\", \"how many SOL is one ETH\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"amount":{"description":"Amount to convert.","exclusiveMinimum":0,"title":"Amount","type":"number"},"from_asset":{"description":"Coin or fiat: 'BTC', 'ETH', 'usd', 'eur'.","examples":["BTC","usd"],"title":"From Asset","type":"string"},"to_asset":{"default":"usd","description":"Coin or fiat.","examples":["usd","ETH"],"title":"To Asset","type":"string"}},"required":["amount","from_asset"],"title":"convertArguments","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/market_overview":{"post":{"operationId":"market_overview","summary":"The whole market at a glance: total cap and 24h change, BTC/ETH dominance, the Fear & Greed index with a week of","description":"The whole market at a glance: total cap and 24h change, BTC/ETH dominance, the Fear & Greed index with a week of\n    history, the biggest 24h gainers and losers in the top 100, trending searches, and the top 10 by cap. Use for \"how's\n    crypto today\", \"is the market fearful\", \"what's pumping\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"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/bitcoin_network":{"post":{"operationId":"bitcoin_network","summary":"Bitcoin right now: recommended fees in sat/vB (and what a typical transfer costs in USD), mempool backlog, block","description":"Bitcoin right now: recommended fees in sat/vB (and what a typical transfer costs in USD), mempool backlog, block\n    height, hashrate, the difficulty adjustment in progress and the next halving estimate. Use for \"is now a cheap time to\n    send BTC\", \"when is the next halving\", \"how congested is bitcoin\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"bitcoin_networkArguments","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/ethereum_gas":{"post":{"operationId":"ethereum_gas","summary":"Ethereum gas right now: gas price, base fee and median priority tip in gwei, the trend over the last 20 blocks, and","description":"Ethereum gas right now: gas price, base fee and median priority tip in gwei, the trend over the last 20 blocks, and\n    what an ETH transfer, an ERC-20 transfer and a typical swap cost in USD. Use for \"what's gas\", \"is it a good time to\n    swap\", \"how much does an ETH transfer cost right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"ethereum_gasArguments","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/address_balance":{"post":{"operationId":"address_balance","summary":"Read-only balance of a public address: for Bitcoin the confirmed and pending BTC, transaction count and the last few","description":"Read-only balance of a public address: for Bitcoin the confirmed and pending BTC, transaction count and the last few\n    transactions; for Ethereum the ETH balance, major ERC-20 balances (USDT, USDC, DAI, WETH, WBTC, LINK, UNI), whether it is a\n    contract, and the USD value. Use for \"how much is in this wallet\", \"did my deposit arrive\", \"check this address\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"description":"A public Bitcoin (1…, 3…, bc1…) or Ethereum (0x…) address. Never a private key or seed phrase.","examples":["bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh","0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],"title":"Address","type":"string"}},"required":["address"],"title":"address_balanceArguments","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/defi_overview":{"post":{"operationId":"defi_overview","summary":"DeFi by the numbers: total value locked by chain (top 15) and the largest protocols (filterable by chain and category)","description":"DeFi by the numbers: total value locked by chain (top 15) and the largest protocols (filterable by chain and category)\n    with TVL, 1d/7d change, chains and audit count. Use for \"which chain has the most DeFi\", \"biggest lending protocols on\n    Solana\", \"is TVL growing\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter protocols to a chain, e.g. 'Ethereum', 'Solana', 'Base'.","title":"Chain"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to a category: 'Lending', 'Dexes', 'Liquid Staking', 'Bridge', 'Yield'…","title":"Category"},"limit":{"default":15,"description":"Protocols to return (1–50).","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"title":"defi_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/stablecoins":{"post":{"operationId":"stablecoins","summary":"Stablecoins by supply with mechanism (fiat-backed, crypto-backed, algorithmic), 7-day supply change, current price and","description":"Stablecoins by supply with mechanism (fiat-backed, crypto-backed, algorithmic), 7-day supply change, current price and\n    peg deviation, with any that have slipped more than 0.5% flagged. Use for \"is USDT holding its peg\", \"how big is USDC\",\n    \"which stablecoins are growing\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"default":12,"description":"How many to return (1–30).","maximum":30,"minimum":1,"title":"Limit","type":"integer"}},"title":"stablecoinsArguments","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}}}}