Skip to main content

Base URL

https://api.limitless.exchange
Interactive API explorer (Scalar): https://api.limitless.exchange/api-v1

Authentication

Most endpoints require authentication via one of two methods:
MethodHeadersUse case
API KeyX-API-Key: lmts_...Individual traders, bots, data access
Scoped API Token (HMAC)lmts-api-key, lmts-timestamp, lmts-signaturePartner integrations, delegated signing, sub-account management
curl -H "X-API-Key: lmts_your_key_here" \
  https://api.limitless.exchange/markets/active
Public endpoints like market browsing and orderbook data do not require authentication.
See the Authentication guide for API keys and HMAC signing details, or the Programmatic API guide for the full partner integration workflow.

Endpoint Groups

Authentication

Manage API keys, verify sessions, and authentication flows.

API Tokens

Scoped API token management for partner integrations — derive, list, and revoke HMAC-authenticated tokens.

Markets

Browse active markets, search, get details and feed events.

Trading

Create and cancel orders, batch order status, orderbook, historical prices, and user orders.

Partner Accounts

Create and manage sub-accounts for partner integrations.

Portfolio

Positions, trades, PnL chart, history, points, and allowance.

Public Portfolio

Public user positions, traded volume, and PnL data.

Key Concepts

ConceptDescription
Venue systemEach CLOB market has a venue with exchange and adapter addresses. Fetch via GET /markets/:slug. See Venue System.
EIP-712 signingOrders are signed using the venue’s exchange address as verifyingContract. See EIP-712 Signing.
Order typesGTC (Good Till Cancelled) stays on the orderbook. FOK (Fill or Kill) executes immediately or cancels.
Token IDsEach market has YES and NO position IDs returned in positionIds. Use these as tokenId in orders.
USDC decimalsUSDC on Base has 6 decimals. Amounts are scaled by 1e6.

WebSocket API

For real-time orderbook and position updates, see the WebSocket Events reference. URL: wss://ws.limitless.exchange | Namespace: /markets

Rate Limits

LimitValue
Max concurrent requests2
Min delay between calls300ms
Exceeding rate limits will return 429 Too Many Requests. Use exponential backoff or the SDK’s built-in retry mechanisms. Contact hey@limitless.network for higher limits.