Public API

All endpoints are read-only JSON over HTTPS, versioned under /api/v1. Responses are wrapped as { data, meta }; meta carries generatedAt, methodologyVersion, cache TTL and a disclaimer. Numbers that carry monetary precision are strings. Errors are { error: { code, message } }.

Rate limits

Default 120 requests per minute per IP (configurable). Every response carries x-ratelimit-limit. Exceeding the limit returns HTTP 429 with x-ratelimit-remaining, x-ratelimit-reset and retry-after. Your remaining quota is deliberately absent from successful responses: they are cacheable, and a shared cache would hand one caller's count to everybody. A cached response also never reaches the limiter, so reads served from cache do not count against you. Responses are cacheable for 10–60 seconds (cache-control). CORS is open for GET.

Networks

SwapScope covers two networks that never see each other's orders: GLEEC on netid 6133 and Komodo on 8762. They are separate markets on the same coins, and no response ever mixes them.

There are two different places a netid appears, and they are not interchangeable.

• To choose a network, pass ?netid=6133 or ?netid=8762. Every price, pair, order-book and best-orders route takes it, and omitting it gives you GLEEC. /api/v1/hindsight is the exception and answers for both unless you narrow it.
• Coin symbols never carry a netid. RXD is the same coin on both networks, so /api/v1/prices/RXD@8762 is not a thing. Ask for /api/v1/prices/RXD?netid=8762 instead. The same goes for a pair: the two coins are path segments and the network is the query, so it is /api/v1/pairs/RXD/LTC?netid=8762, never /api/v1/pairs/RXD/LTC@8762.
• Pair ids in responses do carry it, and only on Komodo. A Komodo pair reads rxd/ltc@8762 and the same market on GLEEC reads rxd/ltc with no suffix at all. So the absence of a suffix means 6133; it does not mean the network is unknown. If you are keying on pair ids, either keep the suffix or read network.netid from the response, which is always present and always explicit.

The /api/coingecko/* endpoints are the one exception, and they work the other way round: that specification describes one exchange's markets, so they answer for GLEEC only. A ticker_id is always bare, a netid suffix in one is rejected rather than served, and ?netid= is rejected too rather than quietly ignored. For anything on 8762, use /api/v1.

Endpoints

Example

curl -s https://your-host/api/v1/prices/RXD | jq
{
  "data": {
    "id": "rxd",
    "symbol": "RXD",
    "price": {
      "usd": "0.0000396",
      "status": "reference",
      "freshness": "live",
      "confidence": { "score": 79, "level": "high" },
      "route": "RXD → LTC → USD",
      "externalAnchor": { "usd": "0.00003805", "providers": ["coingecko","coinpaprika"], "divergencePct": "4.1", "note": "comparison only" }
    }
  },
  "meta": { "generatedAt": "...", "methodologyVersion": "1.0.0" }
}

Numeric precision

Prices, rates, percentages and volume aggregates are published to 12 significant figures (6 for percentages). These values are computed by division, and the digits beyond that are an artifact of the arithmetic rather than anything the underlying swaps measured. Per-trade amounts and order-book quantities are settled quantities and are published exactly as recorded.

Field definitions

status

reference | indicative | stale | unavailable. Only `reference` is a confirmed, fresh price.

freshness

live | recent | low_confidence | stale | unavailable, from the age of the newest reliable trade.

confidence.score / level

0–100 and High/Medium/Low/Stale/Unavailable. Components are included on detail endpoints.

referencePrice

Quote units per 1 base unit (string, full precision).

referencePriceUsd / price.usd

USD value through the published route; null when no route or unavailable.

indicativePrice / indicativeSource

Best current estimate when no reference exists (orderbook | trades | previous).

lastTradePrice

Newest completed swap price. Never the reference.

rawVwap24h / filteredVwap24h

Volume-weighted averages over all / eligible swaps.

volume24h.rawUsd / reliableUsd / rejectedUsd

Raw, reliable and excluded USD volume.

priceAgeSec

Age of the newest reliable trade in seconds.

route / routeString

Selected conversion route, e.g. RXD → LTC → USD, with per-hop rate, quality and age.

externalAnchor

External aggregator price for DEX-priced assets, comparison only; `used: false`.

flags[].code

Machine-readable anomaly code with severity, penalty and explanation. On the bulk feed, `flags` is the plain list of codes raised on the primary market.

participants / largestParticipantSharePct

Bulk feed: distinct parties behind the primary pair's price, and the largest one's share of its influence. A share near 100 means one party made the price.

maker / taker.participant

Truncated keyed hash of the DEX pubkey. Not an identity.

methodologyVersion

Version of the pricing methodology that produced the value.

network / meta.network

Which network the response answers for: `{ id, netid, label }`. See Networks above for how to select one and how pair ids carry it.

CoinGecko compatibility

The /api/coingecko/* endpoints follow the CoinGecko exchange-integration “ideal API” field names (tickers: ticker_id, base_currency, target_currency, pool_id, last_price, base_volume, target_volume, liquidity_in_usd, bid, ask, high, low; orderbook: bids/asks as [price, quantity]; historical_trades: trade_id, price, base_volume, target_volume, trade_timestamp, type). Extra SwapScope fields are additive. Integrators should treat markets with price_status ≠ reference as unpriced.