API Reference

API Reference

Base URL: https://api.mecone.trade · JSON over HTTPS · no key required today (fair use; commercial consumption is licensed, talk to us). The API runs redundantly with zero-downtime deploys and is monitored around the clock.

GET /api/markets

The flagship board: one summary row per live market.

curl https://api.mecone.trade/api/markets

Key fields per market:

FieldTypeMeaning
slugstringStable id, e.g. us-cpi-yoy; use it for the per-market endpoint
symbolstringBranded symbol, e.g. MCPI; the Stork asset is MECON_<symbol>
title, labelstringDisplay names
unitstring% or $
index_nownumberThe live index level in its natural unit
index_fmtstringHuman-formatted value (e.g. $921B, 3.77%)
change_24h_pctnumber24-hour change
funding_rate_pctnumberCurrent demo funding rate
sparknumber[]Recent sparkline series
sourcestringUnderlying data source
bucket, kind, thesisstringCategorization and one-line rationale

GET /api/markets/{slug}

The full payload for one market: everything above plus the stored series (the immutable tick history the charts render), the crowd distribution, the perp block (oracle, mark, funding), and the order-book depth from the underlying market.

curl https://api.mecone.trade/api/markets/us-gdp

GET /api/status

Operational health: readiness, markets cached/errored, store connectivity, uptime.

curl https://api.mecone.trade/api/status

Values update on a 5-minute persistence cadence (a deliberate settlement-determinism choice; the internal pipeline is real-time and faster per-feed cadences are available to licensees). Responses are served from a warm cache, so reads are cheap; please keep polling reasonable.

On-chain

The same values are signed and published to the Stork oracle network; see Consuming the Feeds for feed ids and the Solidity interface.