{"openapi":"3.1.0","info":{"title":"Coinmico API","version":"1.0.0","summary":"Crypto market data measured from real trades on 50+ exchanges and indexed on-chain.","description":"Free, read-only REST API. Every request needs an API key from https://api.coinmico.com/dashboard sent as x-api-key or a bearer token. 600 requests per hour per key. Attribution \"Data by Coinmico\" is required.","termsOfService":"https://docs.coinmico.com/guides/attribution","contact":{"name":"Coinmico","email":"hello@coinmico.com","url":"https://api.coinmico.com"}},"servers":[{"url":"https://api.coinmico.com","description":"Production"}],"tags":[{"name":"Coins"},{"name":"Market"},{"name":"Indicators"}],"security":[{"ApiKey":[]},{"Bearer":[]}],"paths":{"/v1/coins":{"get":{"operationId":"coins","tags":["Coins"],"summary":"List coins","description":"Returns assets ordered by market cap. Each row is the same shape as the market table on coinmico.com: a volume-weighted price measured across the venues we track, 1h/24h/7d/30d change, measured 24h volume, circulating/total/max supply, ATH/ATL and a measured flag.","externalDocs":{"url":"https://docs.coinmico.com/reference/coins"},"parameters":[{"name":"limit","in":"query","required":false,"description":"Rows per response, 1–250.","schema":{"type":"integer","default":100}},{"name":"page","in":"query","required":false,"description":"1-based page number. Ignored when offset is set.","schema":{"type":"integer","default":1}},{"name":"offset","in":"query","required":false,"description":"Rows to skip. Overrides page.","schema":{"type":"integer","default":0}},{"name":"ids","in":"query","required":false,"description":"Comma-separated asset ids to fetch instead of the ranked list.","schema":{"type":"string"},"example":"bitcoin,ethereum"},{"name":"sparkline","in":"query","required":false,"description":"Include a 7-day hourly price array per coin.","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Ranked list of every asset in the index with price, market cap, volume, change and supply.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"coins":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"image":{"type":"string"},"current_price":{"type":"number"},"market_cap":{"type":"number"},"market_cap_rank":{"type":"integer"},"fully_diluted_valuation":{"type":"number"},"total_volume":{"type":"number"},"high_24h":{"type":"number"},"low_24h":{"type":"number"},"price_change_percentage_1h_in_currency":{"type":"number"},"price_change_percentage_24h_in_currency":{"type":"number"},"price_change_percentage_7d_in_currency":{"type":"number"},"price_change_percentage_30d_in_currency":{"type":"number"},"circulating_supply":{"type":"integer"},"total_supply":{"type":"integer"},"measured":{"type":"boolean"},"max_supply":{"type":"integer"},"ath":{"type":"integer"},"ath_change_percentage":{"type":"number"},"ath_date":{"type":"string"},"atl":{"type":"number"},"atl_change_percentage":{"type":"number"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"at":{"type":"string"}}},"example":{"coins":[{"id":"bitcoin","symbol":"btc","name":"Bitcoin","image":"https://cdn.coinmico.com/coins/bitcoin-3af4e627853c.png","current_price":83059.5,"market_cap":1669194802323.02,"market_cap_rank":1,"fully_diluted_valuation":1744249440448.02,"total_volume":10156209940.64,"high_24h":83150.34,"low_24h":82509.22,"price_change_percentage_1h_in_currency":0.047769,"price_change_percentage_24h_in_currency":0.575342,"price_change_percentage_7d_in_currency":-1.980662,"price_change_percentage_30d_in_currency":8.501538,"circulating_supply":20096375,"total_supply":20096375,"measured":true,"max_supply":21000000,"ath":126080,"ath_change_percentage":-34.121592,"ath_date":"2025-10-06T10:57:42.000Z","atl":67.81,"atl_change_percentage":122388.57},{"id":"ethereum","symbol":"eth","name":"Ethereum","image":"/venues/ethereum-mark.webp","current_price":2507.48,"market_cap":306217831062.9,"market_cap_rank":2,"fully_diluted_valuation":306217831062.9,"total_volume":4116246432,"high_24h":2518.67,"low_24h":2485.25,"price_change_percentage_1h_in_currency":0.01331,"price_change_percentage_24h_in_currency":0.784131,"price_change_percentage_7d_in_currency":-6.669863,"price_change_percentage_30d_in_currency":2.877378,"circulating_supply":122121843.65,"total_supply":122121843.65,"measured":true,"max_supply":null,"ath":4946.05,"ath_change_percentage":-49.303425,"ath_date":"2025-08-24T11:21:03.000Z","atl":0.432979,"atl_change_percentage":579022.3}],"page":1,"limit":2,"offset":0,"at":"2026-10-10T23:33:45.797Z"}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"unavailable: Market data is temporarily unavailable; retry after a few seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/coins/{id}":{"get":{"operationId":"coin","tags":["Coins"],"summary":"Get a coin","description":"Returns everything the coin page shows: metadata (name, description, image, links, platform contracts, categories, genesis date), market_cap_rank, and price_stats with price, change, volume, market cap, supply and ATH/ATL in every supported currency.","externalDocs":{"url":"https://docs.coinmico.com/reference/coin"},"parameters":[{"name":"id","in":"path","required":true,"description":"Asset id such as bitcoin. Resolve tickers with /v1/search.","schema":{"type":"string"},"example":"bitcoin"}],"responses":{"200":{"description":"Full profile of one asset: description, links, contracts, categories and live price statistics.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"categories":{"type":"array","items":{"type":"string"}},"description":{"type":"object","properties":{"en":{"type":"string"}}},"image":{"type":"object","properties":{"thumb":{"type":"string"},"small":{"type":"string"},"large":{"type":"string"}}},"links":{"type":"object","properties":{"chat_url":{"type":"array","items":{}},"homepage":{"type":"array","items":{"type":"string"}},"repos_url":{"type":"object","properties":{"github":{"type":"array","items":{"type":"string"}},"bitbucket":{"type":"array","items":{}}}},"whitepaper":{"type":"string"},"snapshot_url":{"type":["string","null"]},"subreddit_url":{"type":"string"},"blockchain_site":{"type":"array","items":{"type":"string"}},"announcement_url":{"type":"array","items":{}},"facebook_username":{"type":"string"},"official_forum_url":{"type":"array","items":{"type":"string"}},"twitter_screen_name":{"type":"string"},"telegram_channel_identifier":{"type":"string"},"bitcointalk_thread_identifier":{"type":["string","null"]}}},"platforms":{"type":"object","properties":{"":{"type":"string"}}},"detail_platforms":{"type":"object","properties":{"":{"type":"object","properties":{"decimal_place":{"type":["string","null"]},"contract_address":{"type":"string"}}}}},"hashing_algorithm":{"type":"string"},"genesis_date":{"type":"string"},"market_cap_rank":{"type":"integer"},"watchlist_portfolio_users":{"type":"integer"},"price_stats":{"type":"object","properties":{"observed_since":{"type":"string"},"ranges":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"low":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"high":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}}}}},"high_all":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"high_all_at":{"type":"string"},"low_all":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"integer"},"sek":{"type":"number"}}},"low_all_at":{"type":"string"}}},"price_source":{"type":"string"},"market_data":{"type":"object","properties":{"current_price":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"market_cap":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"fully_diluted_valuation":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"integer"},"brl":{"type":"number"},"sek":{"type":"number"}}},"total_volume":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"integer"}}},"high_24h":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"low_24h":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"price_change_percentage_1h_in_currency":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"price_change_percentage_24h_in_currency":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"price_change_percentage_7d_in_currency":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"price_change_percentage_14d_in_currency":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"price_change_percentage_30d_in_currency":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"price_change_percentage_1y_in_currency":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"ath":{"type":"object","properties":{"usd":{"type":"integer"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"ath_change_percentage":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"ath_date":{"type":"object","properties":{"usd":{"type":"string"},"ars":{"type":"string"},"brl":{"type":"string"},"sek":{"type":"string"},"sgd":{"type":"string"},"thb":{"type":"string"},"try":{"type":"string"},"twd":{"type":"string"},"uah":{"type":"string"},"vnd":{"type":"string"},"zar":{"type":"string"},"eth":{"type":"string"},"aed":{"type":"string"},"aud":{"type":"string"},"bdt":{"type":"string"},"cad":{"type":"string"},"chf":{"type":"string"},"clp":{"type":"string"},"cny":{"type":"string"},"czk":{"type":"string"},"dkk":{"type":"string"},"eur":{"type":"string"},"gbp":{"type":"string"},"hkd":{"type":"string"}}},"atl":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"atl_change_percentage":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"atl_date":{"type":"object","properties":{"usd":{"type":"string"},"ars":{"type":"string"},"brl":{"type":"string"},"sek":{"type":"string"},"sgd":{"type":"string"},"thb":{"type":"string"},"try":{"type":"string"},"twd":{"type":"string"},"uah":{"type":"string"},"vnd":{"type":"string"},"zar":{"type":"string"},"eth":{"type":"string"},"aed":{"type":"string"},"aud":{"type":"string"},"bdt":{"type":"string"},"cad":{"type":"string"},"chf":{"type":"string"},"clp":{"type":"string"},"cny":{"type":"string"},"czk":{"type":"string"},"dkk":{"type":"string"},"eur":{"type":"string"},"gbp":{"type":"string"},"hkd":{"type":"string"}}},"circulating_supply":{"type":"integer"},"total_supply":{"type":"integer"},"max_supply":{"type":"integer"},"supply_source":{"type":"string"},"market_cap_change_percentage_24h":{"type":"number"}}}}},"example":{"id":"bitcoin","symbol":"btc","name":"Bitcoin","categories":["Smart Contract Platform","Layer 1 (L1)"],"description":{"en":"Bitcoin is the world's first decentralized cryptocurrency, created in 2009 by the pseudonymous Satoshi Nakamoto. It enables peer-to-peer electronic cash tran…"},"image":{"thumb":"https://cdn.coinmico.com/coins/bitcoin-8a8f39db2369.png","small":"https://cdn.coinmico.com/coins/bitcoin-2a7de236e64c.png","large":"https://cdn.coinmico.com/coins/bitcoin-3af4e627853c.png"},"links":{"chat_url":[],"homepage":["http://www.bitcoin.org"],"repos_url":{"github":["https://github.com/bitcoin/bitcoin","https://github.com/bitcoin/bips"],"bitbucket":[]},"whitepaper":"https://bitcoin.org/bitcoin.pdf","snapshot_url":null,"subreddit_url":"https://www.reddit.com/r/Bitcoin/","blockchain_site":["https://mempool.space/","https://platform.arkhamintelligence.com/explorer/token/bitcoin"],"announcement_url":[],"facebook_username":"bitcoins","official_forum_url":["https://bitcointalk.org/"],"twitter_screen_name":"bitcoin","telegram_channel_identifier":"","bitcointalk_thread_identifier":null},"platforms":{"":""},"detail_platforms":{"":{"decimal_place":null,"contract_address":""}},"hashing_algorithm":"SHA-256","genesis_date":"2009-01-03","market_cap_rank":1,"watchlist_portfolio_users":2447440,"price_stats":{"observed_since":"2024-12-31T00:00:00+00:00","ranges":[{"key":"24h","label":"24h","low":{"usd":82509.22,"ars":125073788.52,"brl":413545.76,"sek":824396.76},"high":{"usd":83150.34,"ars":126045657.74,"brl":416759.16,"sek":830802.63}},{"key":"7d","label":"7d","low":{"usd":80725.32,"ars":122369617.37,"brl":404604.65,"sek":806572.81},"high":{"usd":86647.95,"ars":131347605.74,"brl":434289.6,"sek":865749.27}}],"high_all":{"usd":124659.03,"ars":188967705.22,"brl":624805.51,"sek":1245539.66},"high_all_at":"2025-10-06T00:00:00+00:00","low_all":{"usd":58628.73,"ars":88873920.04,"brl":293854,"sek":585793.18},"low_all_at":"2026-06-30T00:00:00+00:00"},"price_source":"index","market_data":{"current_price":{"usd":83059.5,"ars":125907948.16,"brl":416303.83,"sek":829894.95},"market_cap":{"usd":1669194802323.02,"ars":2530293341683097.5,"brl":8366197975840.06,"sek":16677880049436.26},"fully_diluted_valuation":{"usd":1744249440448.02,"ars":2644066911338241,"brl":8742380528460.55,"sek":17427793870196.06},"total_volume":{"usd":10156209940.64,"ars":15395560993700.05,"brl":50904102342.83,"sek":101476502869},"high_24h":{"usd":83150.34,"ars":126045657.74,"brl":416759.16,"sek":830802.63},"low_24h":{"usd":82509.22,"ars":125073788.52,"brl":413545.76,"sek":824396.76},"price_change_percentage_1h_in_currency":{"usd":0.047769,"ars":0.047769,"brl":0.047769,"sek":0.047769},"price_change_percentage_24h_in_currency":{"usd":0.575342,"ars":0.575342,"brl":0.575342,"sek":0.575342},"price_change_percentage_7d_in_currency":{"usd":-1.980662,"ars":-1.980662,"brl":-1.980662,"sek":-1.980662},"price_change_percentage_14d_in_currency":{"usd":-1.642967,"ars":-1.642967,"brl":-1.642967,"sek":-1.642967},"price_change_percentage_30d_in_currency":{"usd":8.501538,"ars":8.501538,"brl":8.501538,"sek":8.501538},"price_change_percentage_1y_in_currency":{"usd":-26.357506,"ars":-26.357506,"brl":-26.357506,"sek":-26.357506},"ath":{"usd":126080,"ars":191121721.73,"brl":631927.59,"sek":1259737.4},"ath_change_percentage":{"usd":-34.121592,"ars":-34.121592,"brl":-34.121592,"sek":-34.121592},"ath_date":{"usd":"2025-10-06T10:57:42.000Z","ars":"2025-10-06T10:57:42.000Z","brl":"2025-10-06T10:57:42.000Z","sek":"2025-10-06T10:57:42.000Z","sgd":"2025-10-06T10:57:42.000Z","thb":"2025-10-06T10:57:42.000Z","try":"2025-10-06T10:57:42.000Z","twd":"2025-10-06T10:57:42.000Z","uah":"2025-10-06T10:57:42.000Z","vnd":"2025-10-06T10:57:42.000Z","zar":"2025-10-06T10:57:42.000Z","eth":"2025-10-06T10:57:42.000Z","aed":"2025-10-06T10:57:42.000Z","aud":"2025-10-06T10:57:42.000Z","bdt":"2025-10-06T10:57:42.000Z","cad":"2025-10-06T10:57:42.000Z","chf":"2025-10-06T10:57:42.000Z","clp":"2025-10-06T10:57:42.000Z","cny":"2025-10-06T10:57:42.000Z","czk":"2025-10-06T10:57:42.000Z","dkk":"2025-10-06T10:57:42.000Z","eur":"2025-10-06T10:57:42.000Z","gbp":"2025-10-06T10:57:42.000Z","hkd":"2025-10-06T10:57:42.000Z"},"atl":{"usd":67.81,"ars":102791.59,"brl":339.871586,"sek":677.528497},"atl_change_percentage":{"usd":122388.57,"ars":122388.57,"brl":122388.57,"sek":122388.57},"atl_date":{"usd":"2013-07-05T16:00:00.000Z","ars":"2013-07-05T16:00:00.000Z","brl":"2013-07-05T16:00:00.000Z","sek":"2013-07-05T16:00:00.000Z","sgd":"2013-07-05T16:00:00.000Z","thb":"2013-07-05T16:00:00.000Z","try":"2013-07-05T16:00:00.000Z","twd":"2013-07-05T16:00:00.000Z","uah":"2013-07-05T16:00:00.000Z","vnd":"2013-07-05T16:00:00.000Z","zar":"2013-07-05T16:00:00.000Z","eth":"2013-07-05T16:00:00.000Z","aed":"2013-07-05T16:00:00.000Z","aud":"2013-07-05T16:00:00.000Z","bdt":"2013-07-05T16:00:00.000Z","cad":"2013-07-05T16:00:00.000Z","chf":"2013-07-05T16:00:00.000Z","clp":"2013-07-05T16:00:00.000Z","cny":"2013-07-05T16:00:00.000Z","czk":"2013-07-05T16:00:00.000Z","dkk":"2013-07-05T16:00:00.000Z","eur":"2013-07-05T16:00:00.000Z","gbp":"2013-07-05T16:00:00.000Z","hkd":"2013-07-05T16:00:00.000Z"},"circulating_supply":20096375,"total_supply":20096375,"max_supply":21000000,"supply_source":"onchain","market_cap_change_percentage_24h":0.575342}}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found: No asset with that id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/coins/{id}/ohlc":{"get":{"operationId":"coinOhlc","tags":["Coins"],"summary":"OHLC candles","description":"Candles are built in-house from the trade feed, so volume is the measured volume for the interval. The response names its source (coinmico) and the FX rate applied when vs is not usd.","externalDocs":{"url":"https://docs.coinmico.com/reference/coin-ohlc"},"parameters":[{"name":"id","in":"path","required":true,"description":"Asset id.","schema":{"type":"string"},"example":"bitcoin"},{"name":"interval","in":"query","required":false,"description":"Candle size.","schema":{"type":"string","enum":["1m","5m","15m","1h","4h","1d","1w"],"default":"1h"}},{"name":"vs","in":"query","required":false,"description":"Quote currency for price fields: usd (default), eur, gbp, idr, jpy and 25 more fiat, plus btc and eth.","schema":{"type":"string","default":"usd"}}],"responses":{"200":{"description":"Open/high/low/close/volume candles aggregated from trades on the venues we track.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"candles":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"integer"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"}}}},"source":{"type":"string"},"rate":{"type":"integer"},"currency":{"type":"string"}}},"example":{"candles":[{"timestamp":1791068400000,"open":84733.27,"high":84794.29,"low":84697.27,"close":84743.44,"volume":352864511.89},{"timestamp":1791072000000,"open":84743.43,"high":84864.79,"low":84742.51,"close":84789.56,"volume":898293617.7}],"source":"coinmico","rate":1,"currency":"usd"}}}},"400":{"description":"bad_request: vs is not a supported currency.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found: No asset with that id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/coins/{id}/chart":{"get":{"operationId":"coinChart","tags":["Coins"],"summary":"Price chart","description":"A lightweight line-chart series. Point density adapts to the window. When the window is longer than our own history the response is marked with the coverage we do hold rather than padded with third-party data.","externalDocs":{"url":"https://docs.coinmico.com/reference/coin-chart"},"parameters":[{"name":"id","in":"path","required":true,"description":"Asset id.","schema":{"type":"string"},"example":"bitcoin"},{"name":"range","in":"query","required":false,"description":"Window.","schema":{"type":"string","enum":["1h","24h","7d","30d","90d","1y","max"],"default":"24h"}},{"name":"metric","in":"query","required":false,"description":"Series to return.","schema":{"type":"string","enum":["price","market_cap"],"default":"price"}},{"name":"vs","in":"query","required":false,"description":"Quote currency for price fields: usd (default), eur, gbp, idr, jpy and 25 more fiat, plus btc and eth.","schema":{"type":"string","default":"usd"}}],"responses":{"200":{"description":"Price or market-cap series for a window from 1 hour to the full history.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"range":{"type":"string"},"metric":{"type":"string"},"currency":{"type":"string"},"coverage":{"type":"string"},"points":{"type":"array","items":{"type":"array","items":{"type":"integer"}}}}},"example":{"id":"bitcoin","range":"24h","metric":"price","currency":"usd","coverage":"full","points":[[1791590400000,82510.12],[1791594000000,82644.9]]}}}},"400":{"description":"bad_request: range is not one of the supported windows.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found: No asset with that id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/coins/{id}/markets":{"get":{"operationId":"coinMarkets","tags":["Coins"],"summary":"Markets","description":"Lists each market we track for the asset: venue, pair, quote, last price, 24h volume, share of the asset's total, contract type (spot or perpetual), ±2% depth, spread and whether the market is excluded from the index and why.","externalDocs":{"url":"https://docs.coinmico.com/reference/coin-markets"},"parameters":[{"name":"id","in":"path","required":true,"description":"Asset id.","schema":{"type":"string"},"example":"bitcoin"},{"name":"vs","in":"query","required":false,"description":"Quote currency for price fields: usd (default), eur, gbp, idr, jpy and 25 more fiat, plus btc and eth.","schema":{"type":"string","default":"usd"}}],"responses":{"200":{"description":"Every pair and venue where the asset trades, with measured volume, share, spread and depth.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"markets":{"type":"array","items":{"type":"object","properties":{"venueId":{"type":"string"},"venue":{"type":"string"},"pair":{"type":"string"},"quote":{"type":"string"},"price":{"type":"number"},"volume24h":{"type":"number"},"share":{"type":"number"},"contract":{"type":"string"},"excluded":{"type":"boolean"},"excludeReason":{"type":["string","null"]},"updatedAt":{"type":"integer"},"spreadBps":{"type":["string","null"]},"depthBid":{"type":["string","null"]},"depthAsk":{"type":["string","null"]},"depthBid1":{"type":["string","null"]},"depthAsk1":{"type":["string","null"]},"costBuy":{"type":["string","null"]},"costSell":{"type":["string","null"]},"liquidityScore":{"type":["string","null"]}}}},"currency":{"type":"string"},"at":{"type":"integer"}}},"example":{"markets":[{"venueId":"binance","venue":"Binance","pair":"BTCUSDT-PERP","quote":"USDT","price":83008.9,"volume24h":1718091688.99,"share":0.197752,"contract":"perpetual","excluded":false,"excludeReason":null,"updatedAt":1791675180000,"spreadBps":null,"depthBid":null,"depthAsk":null,"depthBid1":null,"depthAsk1":null,"costBuy":null,"costSell":null,"liquidityScore":null},{"venueId":"bitrue","venue":"Bitrue","pair":"BTCUSDT","quote":"USDT","price":83063.62,"volume24h":1091296888.43,"share":0.105188,"contract":"spot","excluded":false,"excludeReason":null,"updatedAt":1791675180000,"spreadBps":0.001204,"depthBid":2284559.38,"depthAsk":1523729.1,"depthBid1":2284452.78,"depthAsk1":1523712.3,"costBuy":{"1000":0,"10000":0,"100000":0,"1000000":0.32},"costSell":{"1000":0,"10000":0,"100000":0,"1000000":0},"liquidityScore":9.4}],"currency":"usd","at":1791675241490}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found: No asset with that id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/prices":{"get":{"operationId":"prices","tags":["Coins"],"summary":"Prices","description":"The cheapest way to watch a handful of assets. Returns the current index price for the requested ids, or the whole catalogue when ids is omitted. Poll no faster than every 5 seconds; the data behind it updates on every trade.","externalDocs":{"url":"https://docs.coinmico.com/reference/prices"},"parameters":[{"name":"ids","in":"query","required":false,"description":"Comma-separated asset ids. Omit for all assets.","schema":{"type":"string"},"example":"bitcoin,ethereum"}],"responses":{"200":{"description":"Compact live prices for polling: id, price, 24h change, measured flag.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"prices":{"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string"},"symbol":{"type":"string"},"price":{"type":"number"},"change24h":{"type":"number"},"measured":{"type":"boolean"},"updatedAt":{"type":"integer"}}}},"at":{"type":"integer"}}},"example":{"prices":[{"assetId":"bitcoin","symbol":"BTC","price":83059.5,"change24h":0.58,"measured":true,"updatedAt":1791675180000}],"at":1791675258676}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/search":{"get":{"operationId":"search","tags":["Coins"],"summary":"Search","description":"Prefix and fuzzy search across the catalogue. Use it to turn user input into an id for the other endpoints.","externalDocs":{"url":"https://docs.coinmico.com/reference/search"},"parameters":[{"name":"q","in":"query","required":true,"description":"Name, ticker or contract address.","schema":{"type":"string"},"example":"sol"}],"responses":{"200":{"description":"Resolve a name, ticker or contract address to coins, categories, exchanges and DEXes.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"coins":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"market_cap_rank":{"type":"integer"},"thumb":{"type":"string"},"large":{"type":"string"},"contract":{"type":["string","null"]}}}},"categories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}}},"exchanges":{"type":"array","items":{}},"dexes":{"type":"array","items":{}}}},"example":{"coins":[{"id":"solana","name":"Solana","symbol":"SOL","market_cap_rank":7,"thumb":"https://cdn.coinmico.com/coins/solana-89e9231236ed.png","large":"https://cdn.coinmico.com/coins/solana-89e9231236ed.png","contract":null},{"id":"solv-protocol","name":"Solv Protocol","symbol":"SOLV","market_cap_rank":839,"thumb":"https://cdn.coinmico.com/coins/solv-protocol-4313ed9cf9e1.jpg","large":"https://cdn.coinmico.com/coins/solv-protocol-4313ed9cf9e1.jpg","contract":null}],"categories":[{"id":"solana-meme-coins","name":"Solana Meme"},{"id":"solana-ecosystem","name":"Solana Ecosystem"}],"exchanges":[],"dexes":[]}}}},"400":{"description":"bad_request: q is missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/global":{"get":{"operationId":"global","tags":["Market"],"summary":"Global","description":"Aggregates across every asset in the index. total_market_cap and total_volume are given in every supported currency; market_cap_percentage is dominance per asset for the top assets.","externalDocs":{"url":"https://docs.coinmico.com/reference/global"},"parameters":[],"responses":{"200":{"description":"Total market cap, volume and dominance summed from the index.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"active_cryptocurrencies":{"type":"integer"},"markets":{"type":"integer"},"total_market_cap":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"integer"},"brl":{"type":"number"},"sek":{"type":"number"}}},"total_volume":{"type":"object","properties":{"usd":{"type":"number"},"ars":{"type":"number"},"brl":{"type":"number"},"sek":{"type":"number"}}},"market_cap_percentage":{"type":"object","properties":{"btc":{"type":"number"},"eth":{"type":"number"},"usdt":{"type":"number"},"bnb":{"type":"number"},"xrp":{"type":"number"},"usdc":{"type":"number"},"sol":{"type":"number"},"trx":{"type":"number"},"figr_heloc":{"type":"number"},"zec":{"type":"number"}}},"market_cap_change_percentage_24h_usd":{"type":"number"}}},"example":{"active_cryptocurrencies":2533,"markets":28656,"total_market_cap":{"usd":2922493394176.22,"ars":4430139349886310,"brl":14647875900844.95,"sek":29200303167436.09},"total_volume":{"usd":31775184926.31,"ars":48167259290460.32,"brl":159260912772.1,"sek":317484048004.5},"market_cap_percentage":{"btc":57.106651,"eth":10.480411,"usdt":6.299293,"bnb":3.420726,"xrp":3.034137,"usdc":2.49957,"sol":2.220624,"trx":1.074983,"figr_heloc":0.862399,"zec":0.709424},"market_cap_change_percentage_24h_usd":0.699748}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/global/history":{"get":{"operationId":"globalHistory","tags":["Market"],"summary":"Global history","description":"Hourly or daily points of total market cap, summed from our own index history. basket is the number of assets included in each point.","externalDocs":{"url":"https://docs.coinmico.com/reference/global-history"},"parameters":[{"name":"range","in":"query","required":false,"description":"Window.","schema":{"type":"string","enum":["24h","7d","30d","90d"],"default":"90d"}}],"responses":{"200":{"description":"Total market cap over time.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"range":{"type":"string"},"basket":{"type":"integer"},"points":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer"},"marketCap":{"type":"number"}}}}}},"example":{"range":"7d","basket":1323,"points":[{"time":1791072000000,"marketCap":2951966376340.65},{"time":1791079200000,"marketCap":2952741509615.28}]}}}},"400":{"description":"bad_request: range must be one of 24h, 7d, 30d, 90d.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/exchanges":{"get":{"operationId":"exchanges","tags":["Market"],"summary":"Exchanges","description":"One row per exchange we connect to. Volume is what we counted from the venue's own trade stream, split into spot and derivatives, with the number of markets excluded from the index and a five-part score.","externalDocs":{"url":"https://docs.coinmico.com/reference/exchanges"},"parameters":[],"responses":{"200":{"description":"Centralised exchanges ranked by measured volume, with trust score, depth, open interest and uptime.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"exchanges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"volume24h":{"type":"number"},"spotVolume24h":{"type":"number"},"derivativesVolume24h":{"type":"number"},"markets":{"type":"integer"},"assets":{"type":"integer"},"excluded":{"type":"integer"},"lastTradeAt":{"type":"integer"},"volumeDaily":{"type":"array","items":{"type":"number"}},"country":{"type":["string","null"]},"url":{"type":"string"},"depth2":{"type":"number"},"depthBooks":{"type":"integer"},"openInterest":{"type":"number"},"uptime":{"type":"integer"},"score":{"type":"object","properties":{"value":{"type":"integer"},"parts":{"type":"object","properties":{"liquidity":{"type":"integer"},"volume":{"type":"integer"},"integrity":{"type":"number"},"uptime":{"type":"integer"},"transparency":{"type":"integer"}}}}},"logo":{"type":"string"}}}},"at":{"type":"integer"}}},"example":{"exchanges":[{"id":"binance","name":"Binance","kind":"cex","volume24h":15332485779.83,"spotVolume24h":4906873210.87,"derivativesVolume24h":10425612568.96,"markets":1280,"assets":576,"excluded":35,"lastTradeAt":1791675240000,"volumeDaily":[12637770230.09,18280639099.51],"country":null,"url":"https://www.binance.com","depth2":383194071.77,"depthBooks":163,"openInterest":21307445690.64,"uptime":1,"score":{"value":10,"parts":{"liquidity":10,"volume":10,"integrity":9.7,"uptime":10,"transparency":10}},"logo":"/venues/binance.webp"},{"id":"okx","name":"OKX","kind":"cex","volume24h":6762113636.14,"spotVolume24h":931715553.84,"derivativesVolume24h":5830398082.29,"markets":880,"assets":378,"excluded":24,"lastTradeAt":1791675240000,"volumeDaily":[5110513786.47,7294279081.89],"country":null,"url":"https://www.okx.com","depth2":193288730.01,"depthBooks":199,"openInterest":6133357580.84,"uptime":1,"score":{"value":9.4,"parts":{"liquidity":9.5,"volume":8.5,"integrity":9.7,"uptime":10,"transparency":10}},"logo":"/venues/okx.webp"}],"at":1791675285784}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/exchanges/{id}":{"get":{"operationId":"exchange","tags":["Market"],"summary":"Get an exchange","description":"The exchange row from /v1/exchanges plus its market list and score detail.","externalDocs":{"url":"https://docs.coinmico.com/reference/exchange"},"parameters":[{"name":"id","in":"path","required":true,"description":"Exchange id such as binance.","schema":{"type":"string"},"example":"binance"}],"responses":{"200":{"description":"One exchange with its markets, daily volume history and score breakdown.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"exchange":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"url":{"type":"string"},"about":{"type":"string"},"socials":{"type":"array","items":{"type":"string"}},"founded":{"type":"integer"},"nativeToken":{"type":"object","properties":{"id":{"type":"string"},"symbol":{"type":"string"}}},"volume24h":{"type":"number"},"spotVolume24h":{"type":"number"},"derivativesVolume24h":{"type":"number"},"markets":{"type":"integer"},"excluded":{"type":"integer"},"assets":{"type":"integer"},"lastTradeAt":{"type":"integer"},"volumeDaily":{"type":"array","items":{}},"country":{"type":["string","null"]},"fees":{"type":"string"},"proofOfReserves":{"type":"string"},"depth2":{"type":"number"},"depthBooks":{"type":"integer"},"openInterest":{"type":"number"},"uptime":{"type":"integer"},"score":{"type":"object","properties":{"value":{"type":"integer"},"parts":{"type":"object","properties":{"liquidity":{"type":"integer"},"volume":{"type":"integer"},"integrity":{"type":"number"},"uptime":{"type":"integer"},"transparency":{"type":"integer"}}}}}}},"at":{"type":"integer"}}},"example":{"exchange":{"id":"binance","name":"Binance","kind":"cex","url":"https://www.binance.com","about":"Binance is a global cryptocurrency exchange launched in July 2017 by Changpeng Zhao and Yi He, and it has been the largest venue in the market by spot turnov…","socials":["https://x.com/binance","https://t.me/binanceexchange"],"founded":2017,"nativeToken":{"id":"binancecoin","symbol":"BNB"},"volume24h":15336343430.11,"spotVolume24h":4907175332.31,"derivativesVolume24h":10429168097.8,"markets":1280,"excluded":35,"assets":576,"lastTradeAt":1791675240000,"volumeDaily":[],"country":null,"fees":"https://www.binance.com/en/fee/schedule","proofOfReserves":"https://www.binance.com/en/proof-of-reserves","depth2":383194071.77,"depthBooks":163,"openInterest":21307445690.64,"uptime":1,"score":{"value":10,"parts":{"liquidity":10,"volume":10,"integrity":9.7,"uptime":10,"transparency":10}}},"at":1791675291261}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found: No exchange with that id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/dex":{"get":{"operationId":"dex","tags":["Market"],"summary":"DEX","description":"Volume is summed from swaps we index directly on-chain, per DEX and chain, for the last 24 hours.","externalDocs":{"url":"https://docs.coinmico.com/reference/dex"},"parameters":[],"responses":{"200":{"description":"Decentralised exchanges with indexed on-chain volume, swaps and pools per chain.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"venues":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"chains":{"type":"array","items":{"type":"string"}},"volume24h":{"type":"number"},"swaps24h":{"type":"integer"},"pools24h":{"type":"integer"},"poolsIndexed":{"type":"integer"},"assets24h":{"type":"integer"},"lastTradeAt":{"type":"integer"},"volumeDaily":{"type":"array","items":{"type":"number"}},"logo":{"type":"string"}}}},"at":{"type":"integer"}}},"example":{"venues":[{"id":"uniswap-v3","name":"Uniswap v3","chains":["arbitrum","avalanche"],"volume24h":404392291.57,"swaps24h":983179,"pools24h":1746,"poolsIndexed":55101,"assets24h":743,"lastTradeAt":1791675207000,"volumeDaily":[499050822.85,880879486.08],"logo":"/venues/uniswap-mark.webp"},{"id":"uniswap-v4","name":"Uniswap v4","chains":["arbitrum","avalanche"],"volume24h":238349856.69,"swaps24h":309481,"pools24h":2597,"poolsIndexed":3642121,"assets24h":707,"lastTradeAt":1791675187000,"volumeDaily":[354646401.52,610512395.21],"logo":"/venues/uniswap-mark.webp"}],"at":1791675295625}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/categories":{"get":{"operationId":"categories","tags":["Market"],"summary":"Categories","description":"Every category with its aggregate market cap, dominance, asset count and top three coins. Pass ids to fetch specific categories.","externalDocs":{"url":"https://docs.coinmico.com/reference/categories"},"parameters":[{"name":"ids","in":"query","required":false,"description":"Comma-separated category ids.","schema":{"type":"string"},"example":"layer-1,meme-token"},{"name":"all","in":"query","required":false,"description":"Include categories with no priced assets.","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Sectors and ecosystems with market cap, 24h/7d change, volume and top coins.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"market_cap":{"type":"number"},"market_cap_change_24h":{"type":"number"},"market_cap_change_7d":{"type":"number"},"content":{"type":["string","null"]},"top_3_coins":{"type":"array","items":{"type":"string"}},"top_3_coins_id":{"type":"array","items":{"type":"string"}},"asset_count":{"type":"integer"},"volume_24h":{"type":"number"},"dominance":{"type":"number"},"top_gainer":{"type":"object","properties":{"id":{"type":"string"},"symbol":{"type":"string"},"logo":{"type":"string"},"change_24h":{"type":"number"}}},"top_loser":{"type":"object","properties":{"id":{"type":"string"},"symbol":{"type":"string"},"logo":{"type":"string"},"change_24h":{"type":"number"}}},"series":{"type":"array","items":{"type":"array","items":{"type":"integer"}}}}}},"example":[{"id":"smart-contract-platform","name":"Smart Contract Platform","market_cap":2435512958581.09,"market_cap_change_24h":0.682227,"market_cap_change_7d":-3.167092,"content":null,"top_3_coins":["https://cdn.coinmico.com/coins/bitcoin-3af4e627853c.png","/venues/ethereum-mark.webp"],"top_3_coins_id":["bitcoin","ethereum"],"asset_count":408,"volume_24h":22763552533.83,"dominance":83.350921,"top_gainer":{"id":"starknet","symbol":"STRK","logo":"https://cdn.coinmico.com/coins/starknet-961b599a9bf0.png","change_24h":42.224766},"top_loser":{"id":"kira-network","symbol":"KEX","logo":"https://cdn.coinmico.com/coins/kira-network-0f5b9af5c6b6.png","change_24h":-27.16462},"series":[[1791072000000,2561959263303.78],[1791158400000,2544144180104.13]]},{"id":"layer-1","name":"Layer 1 (L1)","market_cap":2397500459375.5,"market_cap_change_24h":0.656484,"market_cap_change_7d":-3.174919,"content":null,"top_3_coins":["https://cdn.coinmico.com/coins/bitcoin-3af4e627853c.png","/venues/ethereum-mark.webp"],"top_3_coins_id":["bitcoin","ethereum"],"asset_count":208,"volume_24h":20191779578.31,"dominance":82.050014,"top_gainer":{"id":"celestia","symbol":"TIA","logo":"https://cdn.coinmico.com/coins/celestia-59157e972a19.jpg","change_24h":27.236547},"top_loser":{"id":"kira-network","symbol":"KEX","logo":"https://cdn.coinmico.com/coins/kira-network-0f5b9af5c6b6.png","change_24h":-27.16462},"series":[[1791072000000,2522503764063.24],[1791158400000,2504608523250.05]]}]}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/chains":{"get":{"operationId":"chains","tags":["Market"],"summary":"Chains","description":"One row per chain with our indexing coverage and the last 24h of DEX activity.","externalDocs":{"url":"https://docs.coinmico.com/reference/chains"},"parameters":[],"responses":{"200":{"description":"Blockchains we index on-chain, with 24h DEX volume, swaps, pools and tokens indexed.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"chains":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"volume24h":{"type":"number"},"swaps24h":{"type":"integer"},"pools24h":{"type":"integer"},"poolsIndexed":{"type":"integer"},"tokensIndexed":{"type":"integer"},"assets24h":{"type":"integer"},"dexes24h":{"type":"integer"},"lastTradeAt":{"type":"integer"},"volumeChange24h":{"type":"number"},"volumeChange7d":{"type":"number"},"volumeChange30d":{"type":["string","null"]},"volumeDaily":{"type":"array","items":{"type":"number"}},"native":{"type":"object","properties":{"assetId":{"type":"string"},"symbol":{"type":"string"},"price":{"type":["string","null"]},"change24h":{"type":["string","null"]}}},"logo":{"type":"string"}}}},"at":{"type":"integer"}}},"example":{"chains":[{"id":"bsc","name":"BNB Chain","volume24h":367097040.67,"swaps24h":1047824,"pools24h":1724,"poolsIndexed":604064,"tokensIndexed":495310,"assets24h":553,"dexes24h":8,"lastTradeAt":1791675187000,"volumeChange24h":44.468119,"volumeChange7d":-27.014608,"volumeChange30d":null,"volumeDaily":[430700215.18,372756508.45],"native":{"assetId":"binancecoin","symbol":"BNB","price":null,"change24h":null},"logo":"/venues/bsc.webp"},{"id":"ethereum","name":"Ethereum","volume24h":310623654.2,"swaps24h":198038,"pools24h":1910,"poolsIndexed":193257,"tokensIndexed":40807,"assets24h":651,"dexes24h":6,"lastTradeAt":1791675119000,"volumeChange24h":-48.422435,"volumeChange7d":-15.43635,"volumeChange30d":null,"volumeDaily":[314520931.93,640046114.6],"native":{"assetId":"ethereum","symbol":"ETH","price":null,"change24h":null},"logo":"/venues/ethereum-mark.webp"}],"at":1791675320264}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/trending":{"get":{"operationId":"trending","tags":["Market"],"summary":"Trending","description":"A short list of assets trending on Coinmico in the last hours.","externalDocs":{"url":"https://docs.coinmico.com/reference/trending"},"parameters":[{"name":"limit","in":"query","required":false,"description":"Rows per response, 1–20.","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Assets gaining attention right now, ranked by searches, views and volume change.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"coins":{"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":"string"},"coin_id":{"type":"integer"},"name":{"type":"string"},"symbol":{"type":"string"},"market_cap_rank":{"type":"integer"},"thumb":{"type":"string"},"small":{"type":"string"},"large":{"type":"string"},"slug":{"type":"string"},"price_btc":{"type":"number"},"score":{"type":"integer"},"data":{"type":"object","properties":{"price":{"type":"number"},"price_btc":{"type":"string"},"price_change_percentage_24h":{"type":"object","properties":{"usd":{"type":"number"}}},"market_cap":{"type":"string"},"total_volume":{"type":"string"},"sparkline":{"type":"string"}}}}}}}}}},"example":{"coins":[{"item":{"id":"lumia","coin_id":0,"name":"Lumia","symbol":"LUMIA","market_cap_rank":803,"thumb":"https://cdn.coinmico.com/coins/lumia-c9d6e5af90f0.jpg","small":"https://cdn.coinmico.com/coins/lumia-c9d6e5af90f0.jpg","large":"https://cdn.coinmico.com/coins/lumia-c9d6e5af90f0.jpg","slug":"lumia","price_btc":0.000001,"score":0,"data":{"price":0.104196,"price_btc":"0.0000012547905105365902","price_change_percentage_24h":{"usd":27.994435},"market_cap":"24891221.16747908","total_volume":"40657237.785643265","sparkline":""}}},{"item":{"id":"starknet","coin_id":0,"name":"Starknet","symbol":"STRK","market_cap_rank":92,"thumb":"https://cdn.coinmico.com/coins/starknet-961b599a9bf0.png","small":"https://cdn.coinmico.com/coins/starknet-961b599a9bf0.png","large":"https://cdn.coinmico.com/coins/starknet-961b599a9bf0.png","slug":"starknet","price_btc":0.000001,"score":1,"data":{"price":0.103988,"price_btc":"0.0000012522882701587537","price_change_percentage_24h":{"usd":42.224766},"market_cap":"771793892.0007265","total_volume":"442654969.72045946","sparkline":""}}}]}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/new-coins":{"get":{"operationId":"newCoins","tags":["Market"],"summary":"New coins","description":"Recently listed assets with their first print, current price and change since listing, plus summary stats.","externalDocs":{"url":"https://docs.coinmico.com/reference/new-coins"},"parameters":[{"name":"limit","in":"query","required":false,"description":"Rows per response, 1–200.","schema":{"type":"integer","default":200}}],"responses":{"200":{"description":"Assets that first traded on a tracked venue recently.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"coins":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"image":{"type":"string"},"rank":{"type":"integer"},"price":{"type":"number"},"quiet":{"type":"boolean"},"change1h":{"type":"number"},"change24h":{"type":"number"},"volume24h":{"type":"number"},"marketCap":{"type":"number"},"changeSinceListing":{"type":"number"},"firstSeenAt":{"type":"integer"},"listedAt":{"type":"integer"},"track":{"type":"string"},"venues":{"type":"integer"},"pools":{"type":"integer"},"chains":{"type":"array","items":{"type":"string"}}}}},"stats":{"type":"object","properties":{"listed":{"type":"integer"},"screened":{"type":"integer"},"rejected":{"type":"integer"}}}}},"example":{"coins":[{"id":"apex-gold-ledger","symbol":"agl","name":"Apex Gold Ledger","image":"https://cdn.coinmico.com/coins/apex-gold-ledger-d39135f9a6fb.png","rank":1553,"price":0.007009,"quiet":false,"change1h":0.473185,"change24h":9.795183,"volume24h":30630.63,"marketCap":6942778.31,"changeSinceListing":3212263.46,"firstSeenAt":1790914253000,"listedAt":1791654960000,"track":"dex","venues":0,"pools":1,"chains":["base"]},{"id":"inu-wif-sword","symbol":"swordinu","name":"inu wif sword","image":"https://cdn.coinmico.com/coins/inu-wif-sword-3d712bc41e98.png","rank":null,"price":0.000008,"quiet":true,"change1h":null,"change24h":null,"volume24h":null,"marketCap":null,"changeSinceListing":-99.945735,"firstSeenAt":1791353010976,"listedAt":1791661560000,"track":"dex","venues":0,"pools":3,"chains":["solana"]}],"stats":{"listed":2,"screened":593,"rejected":385}}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/fear-greed":{"get":{"operationId":"fearGreed","tags":["Indicators"],"summary":"Fear & Greed","description":"A 0–100 score computed from momentum, volatility, volume, dominance and breadth measured in our own index, with yesterday's and last week's readings.","externalDocs":{"url":"https://docs.coinmico.com/reference/fear-greed"},"parameters":[],"responses":{"200":{"description":"Coinmico Fear & Greed index with its components.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"score":{"type":"integer"},"label":{"type":"string"},"yesterday":{"type":"integer"},"lastWeek":{"type":"integer"},"components":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"score":{"type":"integer"},"detail":{"type":"string"}}}},"days":{"type":"integer"},"asOf":{"type":"string"}}},"example":{"score":50,"label":"Neutral","yesterday":57,"lastWeek":59,"components":[{"key":"momentum","label":"Bitcoin vs its 30 day average","score":54,"detail":"+0.9%"},{"key":"volatility","label":"Volatility vs the past year","score":64,"detail":"38% annualised"}],"days":420,"asOf":"2026-10-10T23:35:31.234Z"}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/fear-greed/history":{"get":{"operationId":"fearGreedHistory","tags":["Indicators"],"summary":"Fear & Greed history","description":"The daily series of the index since we started computing it, with the 30-day high and low.","externalDocs":{"url":"https://docs.coinmico.com/reference/fear-greed-history"},"parameters":[],"responses":{"200":{"description":"Daily Fear & Greed readings.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"current":{"type":"object","properties":{"score":{"type":"integer"},"label":{"type":"string"},"yesterday":{"type":"integer"},"lastWeek":{"type":"integer"},"components":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"score":{"type":"integer"},"detail":{"type":"string"}}}},"days":{"type":"integer"},"asOf":{"type":"string"}}},"series":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"score":{"type":"integer"},"btc":{"type":"number"}}}},"lastMonth":{"type":"integer"},"high":{"type":"object","properties":{"day":{"type":"string"},"score":{"type":"integer"}}},"low":{"type":"object","properties":{"day":{"type":"string"},"score":{"type":"integer"}}}}},"example":{"current":{"score":50,"label":"Neutral","yesterday":57,"lastWeek":59,"components":[{"key":"momentum","label":"Bitcoin vs its 30 day average","score":54,"detail":"+0.9%"},{"key":"volatility","label":"Volatility vs the past year","score":64,"detail":"38% annualised"}],"days":420,"asOf":"2026-10-10T23:35:34.587Z"},"series":[{"day":"2025-08-18","score":17,"btc":116231.82},{"day":"2025-08-19","score":15,"btc":112877.2}],"lastMonth":41,"high":{"day":"2025-08-22","score":93},"low":{"day":"2026-02-05","score":8}}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/etf-flows":{"get":{"operationId":"etfFlowsAll","tags":["Indicators"],"summary":"ETF flows (all assets)","description":"The same per-fund daily flows as /v1/etf-flows/{asset}, for all three underlyings at once, plus the shared as-of trading day. Reference data from fund disclosures, updated each US trading day.","externalDocs":{"url":"https://docs.coinmico.com/reference/etf-flows-all"},"parameters":[],"responses":{"200":{"description":"Bitcoin, Ether and Solana spot ETF flows in one call.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"assets":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"slug":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"logo":{"type":"string"},"days":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"net":{"type":"integer"},"aum":{"type":["string","null"]},"price":{"type":["string","null"]},"cap":{"type":["string","null"]}}}},"funds":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"issuer":{"type":"string"},"fee":{"type":"number"},"netAssets":{"type":"integer"},"traded":{"type":"integer"},"premium":{"type":"number"},"day1":{"type":"integer"},"day5":{"type":"integer"},"day30":{"type":"integer"},"cumulative":{"type":"number"}}}},"grid":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"total":{"type":"number"},"values":{"type":"object","properties":{"IBIT":{"type":"integer"},"FBTC":{"type":"number"},"GBTC":{"type":"integer"},"BTC":{"type":"integer"},"BITB":{"type":"integer"},"ARKB":{"type":"integer"},"HODL":{"type":"integer"},"MSBT":{"type":"integer"},"BRRR":{"type":"integer"},"EZBC":{"type":"integer"},"BTCO":{"type":"integer"},"BTCW":{"type":"integer"}}}}}},"latest":{"type":"object","properties":{"day":{"type":"string"},"net":{"type":"number"}}},"windows":{"type":"object","properties":{"week":{"type":"number"},"month":{"type":"number"},"quarter":{"type":"number"},"best":{"type":"object","properties":{"month":{"type":"string"},"net":{"type":"number"}}},"worst":{"type":"object","properties":{"month":{"type":"string"},"net":{"type":"number"}}}}},"last5":{"type":"number"},"last5Positive":{"type":"integer"},"last30":{"type":"number"},"last30Days":{"type":"integer"},"cumulative":{"type":"number"},"netAssets":{"type":"number"},"traded":{"type":"number"},"holdings":{"type":"number"},"firstDay":{"type":"string"},"streak":{"type":"object","properties":{"sign":{"type":"integer"},"days":{"type":"integer"}}}}}},"asOf":{"type":"string"},"updatedAt":{"type":"string"}}},"example":{"assets":[{"key":"btc","slug":"bitcoin","symbol":"BTC","name":"Bitcoin","logo":"https://cdn.coinmico.com/coins/bitcoin-3af4e627853c.png","days":[{"day":"2024-01-11","net":655300000,"aum":null,"price":null,"cap":null}],"funds":[{"ticker":"IBIT","issuer":"BlackRock","fee":0.0025,"netAssets":66304480000,"traded":1108802757,"premium":-0.001609,"day1":22380000,"day5":1017520,"day30":1685788640,"cumulative":65733430983.66}],"grid":[{"day":"2026-10-09","total":21128078.55,"values":{"IBIT":22380000,"FBTC":-3580502.45,"GBTC":0,"BTC":0,"BITB":0,"ARKB":0,"HODL":2328581,"MSBT":0,"BRRR":0,"EZBC":0,"BTCO":0,"BTCW":0}}],"latest":{"day":"2026-10-09","net":21128078.55},"windows":{"week":-681100293.25,"month":1656147510.89,"quarter":5830137406.18,"best":{"month":"2026-08","net":3522793683.76},"worst":{"month":"2026-06","net":-4510447515.44}},"last5":-681100293.25,"last5Positive":2,"last30":1656147510.89,"last30Days":22,"cumulative":57106714665.87,"netAssets":105844422150.6,"traded":1440037593.9,"holdings":1282351.44,"firstDay":"2024-01-11","streak":{"sign":1,"days":1}}],"asOf":"2026-10-09","updatedAt":"2026-10-10T22:00:27.820Z"}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"unavailable: ETF flow data is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/etf-flows/{asset}":{"get":{"operationId":"etfFlows","tags":["Indicators"],"summary":"ETF flows","description":"Daily net flow in USD for each listed fund and the total, with 5-day and 30-day windows. Sourced from fund disclosures (reference data, not measured by us) and updated each US trading day.","externalDocs":{"url":"https://docs.coinmico.com/reference/etf-flows"},"parameters":[{"name":"asset","in":"path","required":true,"description":"ETF underlying.","schema":{"type":"string","enum":["btc","eth","sol"]},"example":"btc"}],"responses":{"200":{"description":"Daily net flows of US spot Bitcoin, Ether and Solana ETFs, per fund.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string"},"slug":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"logo":{"type":"string"},"days":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"net":{"type":"integer"},"aum":{"type":["string","null"]},"price":{"type":["string","null"]},"cap":{"type":["string","null"]}}}},"funds":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"issuer":{"type":"string"},"fee":{"type":"number"},"netAssets":{"type":"integer"},"traded":{"type":"integer"},"premium":{"type":"number"},"day1":{"type":"integer"},"day5":{"type":"integer"},"day30":{"type":"integer"},"cumulative":{"type":"number"}}}},"grid":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"total":{"type":"number"},"values":{"type":"object","properties":{"IBIT":{"type":"integer"},"FBTC":{"type":"number"},"GBTC":{"type":"integer"},"BTC":{"type":"integer"},"BITB":{"type":"integer"},"ARKB":{"type":"integer"},"HODL":{"type":"integer"},"MSBT":{"type":"integer"},"BRRR":{"type":"integer"},"EZBC":{"type":"integer"},"BTCO":{"type":"integer"},"BTCW":{"type":"integer"}}}}}},"latest":{"type":"object","properties":{"day":{"type":"string"},"net":{"type":"number"}}},"windows":{"type":"object","properties":{"week":{"type":"number"},"month":{"type":"number"},"quarter":{"type":"number"},"best":{"type":"object","properties":{"month":{"type":"string"},"net":{"type":"number"}}},"worst":{"type":"object","properties":{"month":{"type":"string"},"net":{"type":"number"}}}}},"last5":{"type":"number"},"last5Positive":{"type":"integer"},"last30":{"type":"number"},"last30Days":{"type":"integer"},"cumulative":{"type":"number"},"netAssets":{"type":"number"},"traded":{"type":"number"},"holdings":{"type":"number"},"firstDay":{"type":"string"},"streak":{"type":"object","properties":{"sign":{"type":"integer"},"days":{"type":"integer"}}},"asOf":{"type":"string"},"updatedAt":{"type":"string"}}},"example":{"key":"btc","slug":"bitcoin","symbol":"BTC","name":"Bitcoin","logo":"https://cdn.coinmico.com/coins/bitcoin-3af4e627853c.png","days":[{"day":"2024-01-11","net":655300000,"aum":null,"price":null,"cap":null},{"day":"2024-01-12","net":203000000,"aum":null,"price":null,"cap":null}],"funds":[{"ticker":"IBIT","issuer":"BlackRock","fee":0.0025,"netAssets":66304480000,"traded":1108802757,"premium":-0.001609,"day1":22380000,"day5":1017520,"day30":1685788640,"cumulative":65733430983.66},{"ticker":"FBTC","issuer":"Fidelity","fee":0.0025,"netAssets":14669567740.62,"traded":130994973,"premium":-0.000978,"day1":-3580502.45,"day5":-380362571.18,"day30":199720323.33,"cumulative":10515270521.75}],"grid":[{"day":"2026-10-09","total":21128078.55,"values":{"IBIT":22380000,"FBTC":-3580502.45,"GBTC":0,"BTC":0,"BITB":0,"ARKB":0,"HODL":2328581,"MSBT":0,"BRRR":0,"EZBC":0,"BTCO":0,"BTCW":0}},{"day":"2026-10-08","total":-244125629.17,"values":{"IBIT":-5544360,"FBTC":-197086985.17,"GBTC":-8203897,"BTC":0,"BITB":-17713432.4,"ARKB":-20291277,"HODL":0,"MSBT":0,"BRRR":0,"EZBC":4714322.4,"BTCO":0,"BTCW":0}}],"latest":{"day":"2026-10-09","net":21128078.55},"windows":{"week":-681100293.25,"month":1656147510.89,"quarter":5830137406.18,"best":{"month":"2026-08","net":3522793683.76},"worst":{"month":"2026-06","net":-4510447515.44}},"last5":-681100293.25,"last5Positive":2,"last30":1656147510.89,"last30Days":22,"cumulative":57106714665.87,"netAssets":105844422150.6,"traded":1440037593.9,"holdings":1282351.44,"firstDay":"2024-01-11","streak":{"sign":1,"days":1},"asOf":"2026-10-09","updatedAt":"2026-10-10T22:00:27.820Z"}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found: asset must be btc, eth or sol.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/liquidations":{"get":{"operationId":"liquidations","tags":["Indicators"],"summary":"Liquidations","description":"Liquidation prints captured live from exchange streams, bucketed over the window, with long/short totals, the largest events and per-asset and per-venue splits.","externalDocs":{"url":"https://docs.coinmico.com/reference/liquidations"},"parameters":[{"name":"range","in":"query","required":false,"description":"Window.","schema":{"type":"string","enum":["1h","4h","12h","24h","7d","30d"],"default":"24h"}},{"name":"venue","in":"query","required":false,"description":"Restrict to one exchange id.","schema":{"type":"string"},"example":"binance"}],"responses":{"200":{"description":"Forced liquidations on the derivatives venues we stream, by side, asset, venue and time.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"range":{"type":"string"},"venue":{"type":["string","null"]},"long":{"type":"number"},"short":{"type":"number"},"total":{"type":"number"},"previousTotal":{"type":"number"},"events":{"type":"integer"},"assets":{"type":"integer"},"bars":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer"},"long":{"type":"number"},"short":{"type":"number"}}}},"contracts":{"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"logo":{"type":"string"},"long":{"type":"number"},"short":{"type":"number"},"total":{"type":"number"},"events":{"type":"integer"},"largest":{"type":"number"},"openInterestUsd":{"type":"number"},"funding8h":{"type":"number"}}}},"prints":{"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"logo":{"type":"string"},"venue":{"type":"string"},"side":{"type":"string"},"valueUsd":{"type":"number"},"time":{"type":"integer"}}}},"venues":{"type":"array","items":{"type":"object","properties":{"venueId":{"type":"string"},"name":{"type":"string"},"valueUsd":{"type":"number"},"events":{"type":"integer"},"streaming":{"type":"boolean"}}}},"highlights":{"type":"object","properties":{"mostLiquidated":{"type":"object","properties":{"assetId":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"logo":{"type":"string"},"long":{"type":"number"},"short":{"type":"number"},"total":{"type":"number"},"events":{"type":"integer"},"largest":{"type":"number"},"openInterestUsd":{"type":"number"},"funding8h":{"type":"number"}}},"squeeze":{"type":"object","properties":{"assetId":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"logo":{"type":"string"},"long":{"type":"number"},"short":{"type":"number"},"total":{"type":"number"},"events":{"type":"integer"},"largest":{"type":"number"},"openInterestUsd":{"type":"number"},"funding8h":{"type":"number"},"share":{"type":"number"}}},"largest":{"type":"object","properties":{"assetId":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"logo":{"type":"string"},"venue":{"type":"string"},"side":{"type":"string"},"valueUsd":{"type":"number"},"time":{"type":"integer"}}}}},"updatedAt":{"type":"integer"},"oldestAt":{"type":"integer"}}},"example":{"range":"24h","venue":null,"long":21427309.69,"short":31391517.36,"total":52818827.04,"previousTotal":99108060.51,"events":36286,"assets":432,"bars":[{"time":1791586800000,"long":76081.18,"short":202175.31},{"time":1791590400000,"long":388521.56,"short":1834830.46}],"contracts":[{"assetId":"starknet","symbol":"STRK","name":"Starknet","logo":"https://cdn.coinmico.com/coins/starknet-961b599a9bf0.png","long":3300136.72,"short":4650528.62,"total":7950665.35,"events":5366,"largest":214005.76,"openInterestUsd":124476940.46,"funding8h":0.0001},{"assetId":"magic","symbol":"MAGIC","name":"Treasure","logo":"https://cdn.coinmico.com/coins/magic-fdc7316624df.png","long":2160880.1,"short":2361502.64,"total":4522382.75,"events":3916,"largest":23067,"openInterestUsd":13912788.73,"funding8h":-0.001202}],"prints":[{"assetId":"ethereum","symbol":"ETH","name":"Ethereum","logo":"/venues/ethereum-mark.webp","venue":"Binance","side":"short","valueUsd":793226.29,"time":1791641900340},{"assetId":"bitcoin","symbol":"BTC","name":"Bitcoin","logo":"https://cdn.coinmico.com/coins/bitcoin-3af4e627853c.png","venue":"Binance","side":"short","valueUsd":658601.53,"time":1791642602159}],"venues":[{"venueId":"binance","name":"Binance","valueUsd":34304216.72,"events":24231,"streaming":true},{"venueId":"bybit","name":"Bybit","valueUsd":6905392.24,"events":5090,"streaming":true}],"highlights":{"mostLiquidated":{"assetId":"starknet","symbol":"STRK","name":"Starknet","logo":"https://cdn.coinmico.com/coins/starknet-961b599a9bf0.png","long":3300136.72,"short":4650528.62,"total":7950665.35,"events":5366,"largest":214005.76,"openInterestUsd":124476940.46,"funding8h":0.0001},"squeeze":{"assetId":"ethereum","symbol":"ETH","name":"Ethereum","logo":"/venues/ethereum-mark.webp","long":1034548.72,"short":3175315.01,"total":4209863.72,"events":395,"largest":793226.29,"openInterestUsd":9289493617.57,"funding8h":-0.000118,"share":0.754256},"largest":{"assetId":"ethereum","symbol":"ETH","name":"Ethereum","logo":"/venues/ethereum-mark.webp","venue":"Binance","side":"short","valueUsd":793226.29,"time":1791641900340}},"updatedAt":1791675328416,"oldestAt":1789344050281}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/market-status":{"get":{"operationId":"marketStatus","tags":["Indicators"],"summary":"Market status","description":"A small object answering \"what is the market doing today\": how many assets are up, the change in total cap and volume, dominance drift and an altcoin-season reading.","externalDocs":{"url":"https://docs.coinmico.com/reference/market-status"},"parameters":[],"responses":{"200":{"description":"Breadth, 24h market-cap and volume change, BTC dominance change and the altcoin-season score.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"basket":{"type":"integer"},"marketCapChange24h":{"type":"number"},"volumeChange24h":{"type":"number"},"btcSharePointsChange24h":{"type":"number"},"altcoinSeason":{"type":"object","properties":{"score":{"type":"integer"},"outperforming":{"type":"integer"},"judged":{"type":"integer"},"days":{"type":"integer"}}},"asOf":{"type":"string"}}},"example":{"basket":100,"marketCapChange24h":0.679062,"volumeChange24h":-43.843853,"btcSharePointsChange24h":-0.012873,"altcoinSeason":{"score":63,"outperforming":48,"judged":76,"days":90},"asOf":"2026-10-10T23:35:46.597Z"}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/news":{"get":{"operationId":"news","tags":["Indicators"],"summary":"News","description":"Articles from CoinDesk, Cointelegraph, The Block, Decrypt, BeInCrypto and others, with summary, image, source and the assets each article mentions.","externalDocs":{"url":"https://docs.coinmico.com/reference/news"},"parameters":[{"name":"coin","in":"query","required":false,"description":"Only articles tagged with this asset id.","schema":{"type":"string"},"example":"bitcoin"},{"name":"topic","in":"query","required":false,"description":"Topic filter.","schema":{"type":"string","enum":["bitcoin","ethereum","altcoins","regulation","defi"]}},{"name":"source","in":"query","required":false,"description":"Publication name.","schema":{"type":"string"},"example":"CoinDesk"},{"name":"q","in":"query","required":false,"description":"Full-text search.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Rows per response, 1–200.","schema":{"type":"integer","default":40}},{"name":"offset","in":"query","required":false,"description":"Rows to skip.","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Headlines from major crypto publications, tagged by coin and topic.","headers":{"x-ratelimit-limit":{"$ref":"#/components/headers/RateLimitLimit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/RateLimitReset"},"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"url":{"type":"string"},"image":{"type":"string"},"published_at":{"type":"string"},"assets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"}}}}}}},"total":{"type":"integer"}}},"example":{"items":[{"id":"https://cryptobriefing.com/sui-rallies-54-percent-outpacing-bitcoin-ether","source":"Crypto Briefing","title":"SUI rallies approximately 54% in four weeks, outpacing Bitcoin and Ether","summary":"SUI's surge highlights the potential for emerging tokens to outperform established cryptocurrencies, impacting investor strategies and market dynamics.","url":"https://cryptobriefing.com/sui-rallies-54-percent-outpacing-bitcoin-ether","image":"https://static.cryptobriefing.com/wp-content/uploads/2026/10/10190957/library-sui-rallies-approximately-54-in-four-weeks-outpacing-bit-400x225.png","published_at":"2026-10-10T23:10:04.000Z","assets":[{"id":"bitcoin","name":"Bitcoin","symbol":"BTC"},{"id":"ethereum","name":"Ethereum","symbol":"ETH"}]},{"id":"https://thedefiant.io/news/markets/sui-gains-54-in-four-weeks-outpacing-bitcoin-and-ether","source":"The Defiant","title":"SUI Gains 54% in Four Weeks, Outpacing Bitcoin and Ether","summary":"Sui’s DeFi liquidity also expanded, but more slowly than its token price, while a recent pullback interrupted the rally.","url":"https://thedefiant.io/news/markets/sui-gains-54-in-four-weeks-outpacing-bitcoin-and-ether","image":"https://cdn.sanity.io/images/6oftkxoa/production/ff3735399a3abdc56505bb3cd4ed258e76d4ccce-2048x1152.png?w=800&fit=max&fm=jpg&q=70&bg=ffffff","published_at":"2026-10-10T22:58:19.000Z","assets":[{"id":"bitcoin","name":"Bitcoin","symbol":"BTC"},{"id":"ethereum","name":"Ethereum","symbol":"ETH"}]}],"total":2753}}}},"400":{"description":"bad_request: limit or offset out of range.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_key: No x-api-key header or bearer token on the request. invalid_key: The key is unknown or has been revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"quota_exceeded: More than 600 requests this hour. Wait for x-ratelimit-reset seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"x-api-key"},"Bearer":{"type":"http","scheme":"bearer"}},"headers":{"RateLimitLimit":{"description":"Requests allowed per hour for this key.","schema":{"type":"integer"}},"RateLimitRemaining":{"description":"Requests left in the current hour.","schema":{"type":"integer"}},"RateLimitReset":{"description":"Seconds until the hourly window resets.","schema":{"type":"integer"}},"RequestId":{"description":"Id to quote when reporting a problem.","schema":{"type":"string"}}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","status"],"properties":{"code":{"type":"string","enum":["missing_key","invalid_key","quota_exceeded","rate_limited","bad_request","not_found","unavailable","internal"]},"message":{"type":"string"},"status":{"type":"integer"}}}}}}}}