Catalog / LiveCoinWatch public market data

LiveCoinWatch public market data API

livecoinwatch.com

Read-only live cryptocurrency rankings and exchange markets from LiveCoinWatch. Start with /v1/coins to discover source coin codes and live rankings, then pass a returned code to /v1/btc-markets. Coin aggregate volume and market-pair volume are separate measurements: coin volume uses the requested quote currency, while BTC-market volume is USD over the source's 24-hour window. BTC market results are source-offset pages filtered after retrieval to exact quote=BTC; the source search is not a complete enumeration of every BTC pair.

  • finance
  • crypto
  • coins
  • BTC
  • markets
3 endpointsDocs updated

Endpoint health

Loading verification…

CoinsLoading

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the LiveCoinWatch public market data API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

List live BTC-quoted exchange markets

Optional parameters 4

Zero-based offset in the source search=BTC candidate list.

Source market page size; maximum 20 observed for this endpoint.

Minimum market 24-hour trading volume in USD, applied after exact quote=BTC filtering on this source page.

Optional source coin code from /v1/coins; omit for the global BTC search.

View call pricing
cURL · Btc markets
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/844eac06-cabc-45f9-ad05-f54a27f83a4d/v1/btc-markets' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETBtc markets/v1/btc-markets

List live BTC-quoted exchange markets

Input

offsetOptionalQuery · integer, min: 0, default: 0

Zero-based offset in the source search=BTC candidate list.

Example: 0

limitOptionalQuery · integer, min: 1, max: 20, default: 20

Source market page size; maximum 20 observed for this endpoint.

Example: 5

min_volume_usdOptionalQuery · number, min: 0, default: 500

Minimum market 24-hour trading volume in USD, applied after exact quote=BTC filtering on this source page.

Example: 0

coinOptionalQuery · string | null

Optional source coin code from /v1/coins; omit for the global BTC search.

Example: ETH

Response

itemsobject[]
items[].fee?string | null
items[].asks?number[]
items[].basestring
items[].bids?number[]
items[].link?string | null
items[].quotestring
items[].outlier?boolean | null
items[].category?string | null
items[].exchangestring
items[].excluded?boolean | null
items[].rate_btc?number | null
items[].base_name?string | null
items[].depth_usd?number | null
items[].price_usd?number | null
items[].identifierobject
items[].identifier.basestring
items[].identifier.quotestring
items[].identifier.exchangestring
items[].quote_name?string | null
items[].exchange_name?string | null
items[].source_recordobject
items[].observed_at_ms?integer | null
items[].volume_24h_usd?number | null
items[].quote_price_usd?number | null
limitinteger
offsetinteger
transportstring
request_idstring
next_offsetinteger | null
search_term?string, default: BTC
volume_window?string, default: 24h
quote_currency?string, default: BTC
returned_countinteger
source_endpointstring
volume_currency?string, default: USD
source_search_totalinteger
volume_filter_scopestring

Fields marked ? are optional.

GETCoins/v1/coins

List live ranked coins

Input

offsetOptionalQuery · integer, min: 0, default: 0

Zero-based offset in the source rank listing.

Example: 0

limitOptionalQuery · integer, min: 1, max: 50, default: 50

Number of source rows requested; maximum 50.

Example: 20

currencyOptionalQuery · string, default: USD

Source quote/volume currency. Examples observed: USD, BTC and EUR; the source interprets the code.

Example: USD

min_volumeOptionalQuery · number, min: 0, default: 0

Minimum 24-hour aggregate coin volume in the selected currency; applied only to this returned source page.

Example: 0

Response

itemsobject[]
items[].codestring
items[].namestring
items[].rank?integer | null
items[].color?string | null
items[].price?number | null
items[].issued?number | null
items[].elisted?string[]
items[].markets?integer | null
items[].decimals?integer | null
items[].exchanges?integer | null
items[].total_cap?number | null
items[].market_cap?number | null
items[].max_supply?number | null
items[].volume_24h?number | null
items[].circulating?number | null
items[].total_supply?number | null
items[].source_recordobject
items[].volume_window?string, default: 24h
items[].quote_currencystring
items[].supply_verified?boolean | null
items[].volume_currencystring
items[].volume_to_market_cap?number | null
limitinteger
offsetinteger
currencystring
transportstring
min_volumenumber
request_idstring
next_offsetinteger | null
source_totalinteger
returned_countinteger
source_endpointstring
volume_filter_scopestring

Fields marked ? are optional.

GETMarket filters/v1/market-filters

Describe source-backed selections without inventing an exhaustive coin or exchange allowlist.

Input

No input parameters.

Response

choicesobject[]
choices[].namestring
choices[].valuestring
choices[].meaningstring
choices[].source_evidencestring
coin_inputobject
limitationstring
paginationobject
source_endpointstring
discovery_sequencestring[]

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.