Skip to main content
GET
ListStablecoinMarkets

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

coins
string[]

CoinGecko IDs to retrieve (e.g. "tether,usd-coin"). Empty returns defaults.

Repeated (?coins=tether&coins=dai) and comma-joined (?coins=tether,dai) forms are equivalent. IDs are trimmed, lowercased, and de-duplicated; the request is capped at 25 IDs. An ID that is not shaped like a CoinGecko ID, that overflows the cap, or that no provider can resolve is reported in unresolved rather than dropped.

The empty (default) request is served from the seeded snapshot alone and never reaches an upstream provider. Naming IDs explicitly opts into a bounded, cached provider lookup for any ID the snapshot does not carry.

jmespath
string

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

Successful response

ListStablecoinMarketsResponse contains stablecoin market data.

timestamp
string

Timestamp of the data fetch (ISO 8601).

summary
object

StablecoinSummary contains aggregate stablecoin market stats.

stablecoins
object[]
unresolved
object[]
dataStatus
string

Coverage of THIS response, distinct from summary.health_status (which reports peg health, not data availability): "OK" — every requested coin was returned. "PARTIAL" — at least one coin returned, at least one unresolved. "UNAVAILABLE" — no coin data available.