For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Developer InformationAPI Reference
Developer InformationAPI Reference
  • Getting Started
    • Paradigm Overview
    • Onboarding
    • High-Level Notes
      • Taker Limits
      • Maker Protection
      • Platform State
      • Leaderboard Definitions
    • Authentication
    • Rate-Limits
    • Errors
    • Allowlisting URL`s
    • Security
  • Unified Markets
    • Summary
    • RFQ - Request For Quotes
    • OBv1
  • Delta-1 Spreads
    • Summary
    • High-Level Workflows
    • API Flows
  • What`s Changed
    • Auto-Populated Delta Hedge Quantity
    • Changes to Leg Level Validation
Logo
On this page
  • Markets can only be in three market availability states:
  • The sequence of platform state changes will always be:
Getting StartedHigh-Level Notes

Platform State

Previous

Leaderboard Definitions

Next
Built with

When necessary, Paradigm will communicate information about the platform state via UI banners, API, or Web-socket updates. The updates will include information about the estimated time of transition between different states.

Markets can only be in three market availability states:

  • AVAILABLE
    • Normal trading with no restrictions.
  • UNAVAILABLE
    • No actions are allowed in this state.
    • You will not be able to Create, Amend, or Cancel your orders.
  • AVAILABLE_CANCEL_ONLY
    • Creating and Amending of orders are not allowed in this state.
    • Order Cancellations are allowed.
    • You may retrieve information from the API via [GET] requests.

The sequence of platform state changes will always be:

1️⃣ Available → 2️⃣ Unavailable → 3️⃣ Available Cancel-Only → 1️⃣ Available

During any platform states changes, Paradigm will not cancel users’ orders on their behalf.

When the platform state is Unavailable, both UI and API users will not be able to cancel their orders on the platform. Users are reminded to cancel their orders before the platform goes into maintenance, or during the AVAILABLE_CANCEL_ONLY state.