PApaycrest
General

Get markets orderbook

Changed on

Returns the live protocol orderbook (all funded, available provider quotes across corridors × tokens × networks) plus network-wide aggregate statistics.

Public endpoint — no authentication required, CORS open. Responses are cached for ~10 s. Requests are per-IP rate limited.

Optional query filters (side, fiat, token, network) apply only to data.book. data.aggregates always remain network-wide (unfiltered).

Provider balances and success rates are intentionally public to support integrator tooling and the Paycrest Markets dashboard.

get/markets

Request

  • Base URL
    https://api.paycrest.io/v2
  • URL
    https://api.paycrest.io/v2/markets
  • Auth
    none declared

Query parameters

side'buy' | 'sell'

Return only buy or sell book rows. Omit for both sides. Invalid values return 400.

fiatstring

Comma-separated fiat currency codes (e.g. NGN,KES). Case-sensitive as stored. Filters data.book only; omit for all fiats.

tokenstring

Comma-separated token symbols (e.g. USDC,USDT). Filters data.book only; omit for all tokens.

networkstring

Comma-separated network identifiers (e.g. base,polygon). Filters data.book only; omit for all networks.

Response

Markets orderbook and aggregates

statusstring
messagestring

Example response

{
  "status": "success",
  "message": "Operation successful"
}

Changes

  • b2558cacb755Revision changes
    • info

      added the new optional query request parameter fiat

    • info

      added the new optional query request parameter network

    • info

      added the new optional query request parameter side

    • info

      added the new optional query request parameter token

    • info

      added the non-success response with the status