Documentation
Launch app
Developers

Public read API

Read public market, order book, trade, position, and activity data without an API key.

Make your first request

The API is public and read-only. No API key is required.

Base URL
https://app.settle.market
Request
curl https://app.settle.market/v1/markets
i
REST is for reads

Orders use signed EIP-712 messages. Deposits, withdrawals, on-chain cancellations, and claims use wallet transactions.

Markets and prices

GET/healthz

Service status, indexing progress, automated market services, and active alerts.

GET/v1/markets

Markets and boot configuration, including chain ID and contract addresses.

GET/v1/markets/:id/orderbook

Above/YES-price bids, asks, and best available prices.

GET/v1/markets/:id/trades

Recent fills for one market, including price, quantity, and mechanism.

GET/v1/markets/:id/candles?tf=1m|5m|1h

Open, high, low, and close candles built from on-chain fills.

Orders and accounts

GET/v1/orders?user=0x…&status=open

A wallet’s orders, filterable by execution status.

GET/v1/positions/:address

Above/YES and Below/NO balances, plus claimable winnings.

GET/v1/activity/:address

Wallet ledger history: deposits, withdrawals, orders, fills, and claims.

Response terminology

YES / NO

The API names for the outcomes shown as Above and Below in the interface.

OHLC

Open, high, low, and close prices for one candle interval.

nonce

An account version used to invalidate older signed orders.