Pascal#

Pascal is a noncustodial prediction market exchange on Solana.

Quickstart#

Web: visit app.pascal.trade and connect your wallet to start trading.

Python Quickstart: github.com/pascal-research-inc/pascal-python-quickstart includes examples for request signing and order placement, plus a simple market making script you can adapt for custom trading logic.

Architecture#

Traders post collateral in a Solana program (smart contract) and submit signed orders to the offchain matching engine. When a trade occurs, the matching engine broadcasts a transaction containing both signed orders to settle the trade onchain.

Only the matching engine can broadcast trades onchain, meaning all state transitions occur through the offchain API and trades are guaranteed to execute as soon as they are matched offchain. Practically, this means that after depositing, traders do not need to interact with the chain to trade on Pascal.

The program ensures that any trading or movement of funds requires signatures by the trader. For details, see Program.

Onboarding#

Open the web app, connect a Solana wallet (or sign up with email), and deposit USDC.

Deposit USDC directly from a wallet, or by withdrawing from Polymarket or another centralized exchange to your generated deposit address.

Fees#

Fees are charged per fill and configured per market.

Fields for taker_fee_rate and maker_rebate_share are returned in each market's MarketSpec.

Today they default to:

{
  "taker_fee_rate": "0.020000", // Takers pay 2% * price * (1 - price) * size
  "maker_rebate_share": "0.250000" // Makers receive 25% of the taker fee
}

Fees are denominated in USD and rounded to 6 fractional digits.

For a fill of size contracts at price price ($0.00–$1.00), the taker pays:

size × price × (1 - price) × taker_fee_rate

Maker Rebates#

For a fill of size contracts at price price ($0.00–$1.00), the maker is paid:

size × price × (1 - price) × taker_fee_rate × maker_rebate_share

Builder Codes#

A third-party integration — a frontend, terminal, or bot — can attach a builder fee to the orders it routes by setting builder_info on Place Order requests. Builder codes are permissionless: any registered account's wallet public key other than your own is a valid builder_pubkey, with no registration or approval step. The builder must hold at least $100.00 of free collateral at the time an order naming it is placed; see the placement rules below.

The builder public key and fee rate sit inside the signed order permit, so the order's signer consents to the exact fee on every order. Consent is per order, not a standing approval. To stop paying a builder on future fills, cancel any open orders that name it and omit builder_info from future orders.

For each fill of size contracts at price price, the order's owner pays the builder:

size × price × (1 - price) × builder_fee_rate

For example, a 1% builder fee rate on 100 contracts filled at $0.50 pays the builder $0.25. The fee is debited with the fill and credited to the builder's free collateral in the same settlement step; the builder withdraws the proceeds like any balance.

Placement rejects fee rates above the 10% cap (BUILDER_FEE_RATE_INVALID), unknown builders and orders naming their own account (BUILDER_INVALID), and builders holding less than $100.00 of free collateral (BUILDER_COLLATERAL_BELOW_MINIMUM); resting orders are unaffected. Fills expose builder_pubkey and builder_fee_paid_usd, and lifetime builder totals are served by Builder Stats.

Referral Program#

Pascal's referral program rewards you for inviting new traders to Pascal. You earn a share of the fees they generate, while they receive a fee discount.

Once your Pascal account is funded, you can create a referral code and share it or your referral link with a new trader. When they sign up through the link or enter your code during registration, they become your referral. Referral codes cannot be added or changed after registration.

You receive 10% of the exchange fees generated by each trader you refer, calculated after discounts and rebates, up to $10,000.00 in rewards per trader. Your share is credited to your Pascal balance automatically with each eligible trade and is available immediately. There is no separate claim process.

A trader who registers with a referral code receives a 5% discount on fees until the discount has saved them $250.00.

Contracts#

Pascal offers outcome contracts for trading.

Outcome contracts are bilateral, fully collateralized derivative contracts which settle to a price p in the interval [$0, $1]. Counterparties are either long (receive p at settlement) or short (receive 1 - p at settlement).

There is no notion of "yes" or "no" on Pascal. If you are long 5 contracts, you can sell 8 and you will be short 3.

Collateral#

Accounts hold USDC collateral in the Pascal program.

When entering positions, an account's Free Collateral is reduced by enough to cover the worst case loss on the position.

For example, if going long q contracts at 30c, free collateral is reduced by q * 0.30 USD. If going short q at 30c, free collateral is reduced by q * (1 - 0.30) USD.

Free collateral is automatically unlocked when a market settles, or after partially or completely trading out of a position.

Realized and Unrealized PnL#

Pascal reports realized and unrealized PnL on open positions for display and portfolio tracking.

Core exchange accounting is based on collateral locked and unlocked during trading, not on these display fields.

For display purposes, positions follow these rules:

1. The lifecycle of a position resets when touching zero. Fields like average entry price accumulate while the position stays open in one direction (long or short) and reset on touching or crossing zero.
2. Average entry price updates only when the magnitude of the position increases (ie longing when already long, shorting when already short).
3. Unrealized PnL is size * (mark - entry), where size is signed.
4. Realized PnL updates by size_traded * (price - entry) on every closing trade.
5. Realized and unrealized PnL do not include fees. At the end of a position's lifecycle, the realized PnL is exactly equal to the account's USDC balance change attributable to that position, excluding fees.

Self-Trade Prevention#

The matching engine prevents any fill where the same account would be both maker and taker by cancelling the maker order and continuing to match the taker.

Matching Rounds And Priority#

The exchange batches incoming orders into rounds and processes them every 50ms.

Within a round, orders are processed in three groups, in this order:

1. Cancels
2. Post-only placements: order place or replace requests with post_only: true.
3. Other orders: IOC, GTC limits without post_only, GTT, market.

Requests within the same group are processed first come, first served by the order they were received by the write API.

If a cancel references a client_order_id whose placement is accepted later in the same round, it is applied immediately after that placement. A non-post-only order may therefore match before its remaining resting size is canceled. If the placement is rejected or leaves no resting order, the cancel is rejected because the target no longer exists.

This is comparable to Hyperliquid's matching algorithm.

Order Book#

Each market has a single limit order book with bid and ask sides. Within a side, orders are sorted by price, then by order of arrival. Order book insertion happens in the order described in Matching Rounds and Priority.

Tick Sizes#

Each market is parameterized with a tick_sig_figs and tick_size_min.

Both tick_size_min and tick_sig_figs are returned in each market's MarketSpec and on List Markets. For a market with tick_size_min = 0.001 and tick_sig_figs = 2, the tick size at various prices is:

Specifically, for a given price p:

p' = min(p, 1 - p) # Symmetrical around 50c
p_sigs = floor(log10(p')) + 1
tick_size = max(10^(p_sigs - tick_sig_figs), tick_size_min)

The min(p, 1 - p) mirror keeps tick precision symmetric around 0.50, so a market priced near $0.01 has the same precision as one priced near $0.99.

The intuition is to use a fixed number of significant figures regardless of how many leading zeros the price has, and the min tick size adds a bound as the price approaches the endpoints.

Program#

The following details are provided for informational purposes. None of them are necessary to trade on the exchange. The offchain APIs are the exclusive source of truth for exchange state.

Guarantees and Non-Guarantees#

The program enforces the following guarantees:

1. Trader funds cannot move without a trader signature.
2. Trades can only occur at crossing prices and with trader signatures.
3. Once a trading key is revoked, orders placed with it cannot match.

The program does not guarantee the following:

1. The program does not enforce the state of the order book. The offchain matching engine enforces matching priority.
2. The program does not provide onchain oracles for market resolution.

Upgrade authority#

The program upgrade authority is secured with a Fordefi multisig. Accordingly key material is sharded across hardware secure enclaves. No upgrade keys are stored in AWS. Unlike an onchain multisig (eg Squads) this appears as a standard on-curve wallet onchain.

In the future the Pascal program will also include timelocked upgrades.

State#

Most exchange state is stored onchain in these large program-owned accounts:

• Traders: B8FMkiV2fpLrkdHcvejTGaj4gcbYfW2vn5NULvowvCSB
• Positions: 6NGtecwsNdvm3qT1F7ARruQ4eZpbBNfZcn4D33pj3dVv
• Markets: 8hktgNpvPg72bqbDwNorJhGsz9D1Vo7cHMN9jKei1Cb1

Additional per-trader information, including trading key records, is stored in trader auxiliary PDAs. For example, the trader auxiliary PDA for owner 5Hu8swhmKFK5NG7GWxYsisHfgKzic8WCF2QLGmrDs4Kk is 1CforH2A6eXwYpR8z7GFfdt2ikUNYZ5qFeaeNUD1Wc8.

Buffers#

To improve throughput, all state transitions are first buffered before they are applied to exchange state.

The buffer accounts are 1, 2, 3, 4, 5, 6, 7, and 8.

When a buffer is full, its transitions are applied to exchange state and the buffer is emptied. This is why trades initially appear in transactions targeting one of the buffers rather than the exchange state accounts.

Deposit Addresses#

Traders do not deposit directly to exchange state. Instead, they deposit to program-controlled PDAs. The program then moves the funds into exchange state.

For example, the deposit PDA for owner GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB is DtzBRq9hAREJZKj1fuHsgrWrtaeXmbYQdXsmMrd54arG.

To find your registered deposit address, use the Deposit Address endpoint. Note that the deposit address PDA itself is never created (and thus won't show up on block explorers). Only the associated token account that stores the USDC is created.

Source code#

For now, the Pascal program is not source-available. The program's source code will be publicly available once we conclude security audits.

API#

Public reference for integrating Pascal's REST and WebSocket APIs.

All write requests are signed. Most read requests are unauthenticated; invite-code and referral reads require a signed request payload, as documented per endpoint. The Write and Read APIs use distinct base URLs; see Base URLs.

General Information#

Base URLs#

Use the production URLs for live trading:

Geography#

The Pascal matching engine is located in AWS ap-northeast-1.

Rate Limits#

Rate limits are provisional during private beta, and may change. Please program your clients to respect HTTP 429 error codes.

Initial rate limits: 100 requests / second (note you can batch up to 50 orders per request).

Authentication and Request Authorization#

Signing Keys#

Each Solana wallet address owns one Pascal account. Pascal separates account ownership from trading authorization, so certain operations (moving funds, approving trading keys) require wallet signatures, while order placement and cancellation are signed by separate trading keys.

This allows accounts to use higher security custody, like hardware or MPC wallets, without prohibiting the use of hot keys for trading.

In every signed request, owner is the wallet public key, also used as the Solana address, and signer is the key that produced the Ed25519 signature. Wallet-signed requests require signer == owner.

Request Authorization#

Every signed request carries a RequestAuth object with replay and staleness protection fields client_ts_ms and recv_window_ms:

RequestAuth#

Request authentication metadata used to validate client requests.

recv_window_ms may be at most 60,000ms (1 minute).

See Request Signing for constructing the exact payloads to sign over.

Generate A Trading Key In The Browser#

For most users the easiest way to get a trading key is through the Pascal web app. The web app handles wallet prompts, permit construction, and key generation.

1. Open the Pascal web app, for example https://app.pascal.trade, and log in with the wallet of your choice. To keep wallet keys off the computer, use a hardware wallet or MPC solution.
2. Click your account image in the upper right, then Trading Keys > Create Key.
3. Give the key a name and save the private key somewhere secure.

Alternatively, to generate and assign a trading key programmatically, call Create A Trading Key directly with an Ed25519 public key and a wallet-signed create_trading_key permit.

Response Envelopes#

All REST API responses are wrapped in:

Error data is an object with fields:

Batch endpoints return an array of envelopes, one per submitted request, in the same order as the request batch.

Batch endpoints return HTTP 200 if any request in the batch succeeds. Inspect each item's status to determine which requests succeeded or failed. Other endpoints return 200 only on {"status": "success"}.

Success envelope

{
  "status": "success",
  "data": {
    "server_time_ms": "1731536000123"
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Error envelope

{
  "status": "error",
  "data": {
    "code": "INVALID_REQUEST",
    "message": "count_back must be positive"
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Batch response envelope

[
  {
    "status": "success",
    "data": {
      "id": "987654321",
      "client_order_id": "42",
      "symbol": "SIM_EVENT_1.MARKET_1",
      "side": "BID",
      "price": "0.550000",
      "size_original": "10",
      "size_remaining": "0",
      "size_filled": "3",
      "notional_filled": "1.650000",
      "tif": "GTC",
      "type": "LIMIT",
      "post_only": false,
      "reduce_only": false,
      "seq": "67880",
      "update_seq": "67891",
      "place_ts_ms": "1731536000050",
      "update_ts_ms": "1731536000050"
    },
    "seq": "67891",
    "state_time_ms": "1731536000050",
    "server_time_ms": "1731536000123"
  },
  {
    "status": "error",
    "data": {
      "code": "ORDER_NOT_FOUND",
      "message": "client_order_id 43 is not an open order"
    },
    "seq": "67891",
    "state_time_ms": "1731536000050",
    "server_time_ms": "1731536000123"
  }
]

Pagination#

Paginated endpoints accept an optional limit and at most one starting point: before_cursor or at_or_before_seq.

• at_or_before_seq allows starting pagination at a sequence number. Continue paginating using the cursor.
• before_cursor is the cursor returned from a previous page.
• limit uses min 1, default 100, max 500.

Treat cursor values as opaque. The internal format may change without notice; clients should only round-trip next_cursor back into before_cursor.

Paginated responses wrap the page in the standard response envelope. Its data object contains:

The envelope seq and state_time_ms indicate the freshness of the historical data.

See the historical Trades query for an example.

JSON Conventions#

Sequence Numbers#

Responses to API calls that read or update exchange state include a seq number.

The seq is a global counter that increments on every exchange state change. It only increases. Note: it is not a per-connection message counter.

You can compare seq values across REST, WebSocket, and historical APIs to tell which state is newer. For example:

• Order responses include the seq at which the order was placed.
• REST account and order book snapshots include the snapshot's seq in the response envelope.
• WebSocket messages include the seq of the state that produced the update.
• Historical data queries include the highest seq of indexed state. For example, the historical trades response is guaranteed to include every trade where trade.seq <= envelope.seq.

For example, after placing an order, suppose the order response has seq = o. Then a WebSocket book update arrives with seq = w:

• If w < o, the update is from state before your order was placed.
• If w = o, the update is from the same state transition as your order.
• If w > o, the update is from state after your order was placed.

Individual WebSocket channels can carry non-contiguous seq values because multiple state changes occur in each matching round and not every global state change affects each specific WebSocket channel.

Write Endpoints#

Place And Replace Orders#

POST <write_base_url>/api/v1/orders

Places or amends one or more orders. Each order is independently signed and independently succeeds or fails. The maximum batch size is 50.

Request Body

Request bodies are JSON arrays. Every element is a JSON object:

PlaceOrderRequest#

Client sends this request to the API to place an order.

tif (time in force) values:

TimeInForce#

Time in force for an order.

builder_info, when present, is a JSON object (see Builder Codes):

BuilderInfo#

Builder public key and fee rate for one order, signed into the order permit.

JSON Response Payload

Batch responses are JSON arrays of responses. On success, each response's data object has these fields:

order object schema:

OrderMsg#

Order message for API responses.

Every element in fills is a JSON object:

FillMsg#

Fill message for API responses.

curl -X POST https://trade.pascal.trade/api/v1/orders \
  -H 'Content-Type: application/json' \
  --data @- <<'EOF'
[
  {
    "client_order_id": "42",
    "symbol": "SIM_EVENT_1.MARKET_1",
    "side": "BID",
    "price": "0.550000",
    "size": "10",
    "auth": {
      "client_ts_ms": "1731536000000",
      "recv_window_ms": "5000",
      "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
      "signer": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
      "signature": "2rUctQ9bFbuQaUxbXDGRtGm4LMj3GdbYWAW6pjrznAsLvpdH8Eqyx3LgsFx3YzV9cvMfw1ND5T5nChUQZZJ7jEad"
    }
  }
]
EOF

[
  {
    "status": "success",
    "data": {
      "order": {
        "id": "987654321",
        "client_order_id": "42",
        "symbol": "SIM_EVENT_1.MARKET_1",
        "side": "BID",
        "price": "0.550000",
        "size_original": "10",
        "size_remaining": "7",
        "size_filled": "3",
        "notional_filled": "1.650000",
        "tif": "GTC",
        "type": "LIMIT",
        "post_only": false,
        "reduce_only": false,
        "seq": "67880",
        "update_seq": "67891",
        "place_ts_ms": "1731536000050",
        "update_ts_ms": "1731536000050"
      },
      "fills": [
        {
          "trade_id": "555001",
          "symbol": "SIM_EVENT_1.MARKET_1",
          "side": "BID",
          "fill_price": "0.550000",
          "fill_size": "3",
          "liquidity": "TAKER",
          "order_id": "987654321",
          "client_order_id": "42",
          "fee_usd": "0.000742",
          "collateral_change_usd": "-1.650742",
          "position_size_prev": "0",
          "realized_pnl_usd": "0.000000",
          "seq": "67891",
          "trade_ts_ms": "1731536000050"
        }
      ]
    },
    "seq": "67891",
    "state_time_ms": "1731536000050",
    "server_time_ms": "1731536000123"
  }
]

Cancel Orders#

POST <write_base_url>/api/v1/cancels

Cancels one or more orders by client order id or exchange order id. Each cancel is independently signed and independently succeeds or fails. The maximum batch size is 50. Canceling by client order id and canceling by exchange order id have equivalent performance.

Request Body

Request bodies are JSON arrays. Every element is a JSON object:

CancelOrderRequest#

Client sends this request to the API to cancel an order.

JSON Response Payload

Batch responses are JSON arrays of write envelopes. On success, each envelope's data object is an OrderMsg with the cancelled order's final state.

curl -X POST https://trade.pascal.trade/api/v1/cancels \
  -H 'Content-Type: application/json' \
  --data @- <<'EOF'
[
  {
    "client_order_id": "42",
    "auth": {
      "client_ts_ms": "1731536000000",
      "recv_window_ms": "5000",
      "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
      "signer": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
      "signature": "591YziUjZzro24mamxgRrSDdYD71NpsDBmU4UGSyrBYbFiWzYaLjR9he1P5DP8djMKMJzHTsZzwRAagvLqgtiXnc"
    }
  },
  {
    "client_order_id": "43",
    "auth": {
      "client_ts_ms": "1731536000000",
      "recv_window_ms": "5000",
      "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
      "signer": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
      "signature": "3wFZKJWKA92W6iPszoKQccQmrVEfd6hU68HY6mqWYKEH8yFKQEFRJs1tKmrGDy1PMd3wWwcdcYSVoTgrW5KSnP3f"
    }
  }
]
EOF

[
  {
    "status": "success",
    "data": {
      "id": "987654321",
      "client_order_id": "42",
      "symbol": "SIM_EVENT_1.MARKET_1",
      "side": "BID",
      "price": "0.550000",
      "size_original": "10",
      "size_remaining": "0",
      "size_filled": "3",
      "notional_filled": "1.650000",
      "tif": "GTC",
      "type": "LIMIT",
      "post_only": false,
      "reduce_only": false,
      "seq": "67880",
      "update_seq": "67891",
      "place_ts_ms": "1731536000050",
      "update_ts_ms": "1731536000050"
    },
    "seq": "67891",
    "state_time_ms": "1731536000050",
    "server_time_ms": "1731536000123"
  },
  {
    "status": "success",
    "data": {
      "id": "987654322",
      "client_order_id": "43",
      "symbol": "SIM_EVENT_1.MARKET_1",
      "side": "BID",
      "price": "0.550000",
      "size_original": "10",
      "size_remaining": "0",
      "size_filled": "3",
      "notional_filled": "1.650000",
      "tif": "GTC",
      "type": "LIMIT",
      "post_only": false,
      "reduce_only": false,
      "seq": "67880",
      "update_seq": "67891",
      "place_ts_ms": "1731536000050",
      "update_ts_ms": "1731536000050"
    },
    "seq": "67891",
    "state_time_ms": "1731536000050",
    "server_time_ms": "1731536000123"
  }
]

Create A Trading Key#

POST <write_base_url>/api/v1/trading-keys

Authorizes a trading key for an account. This request is wallet-signed.

Trading key names may be at most 16 bytes long, and their expiration timestamps may be no more than 31,536,000,000ms (365 days) in the future. An account may store at most 10 unrevoked trading keys at a time. Expired keys count against this limit until revoked.

Request Body

JSON Response Payload

On success, the response envelope's data object has these fields:

TradingKeyMsg#

Trading key entry in API responses.

curl -X POST https://trade.pascal.trade/api/v1/trading-keys \
  -H 'Content-Type: application/json' \
  --data @- <<'EOF'
{
  "trading_key": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
  "name": "api-doc-key",
  "expiration_ts_ms": "1732140800000",
  "auth": {
    "client_ts_ms": "1731536000000",
    "recv_window_ms": "5000",
    "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "signer": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "signature": "kyc2KdqPTeEWqoK3pXR2rgPUiK4zXg9QdQffPUWk8eALpFy7uaHBEsASt7RQyVzDeubHVsPqQAHXrt8m8KZ78Ep"
  }
}
EOF

{
  "status": "success",
  "data": {
    "trading_key": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
    "name": "api-doc-key",
    "expiration_ts_ms": "1732140800000",
    "open_order_count": "0"
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Revoke A Trading Key#

POST <write_base_url>/api/v1/trading-key-revocations

Revokes a previously authorized trading key. This request is wallet-signed.

Request Body

JSON Response Payload

On success, the response envelope's data object has these fields:

curl -X POST https://trade.pascal.trade/api/v1/trading-key-revocations \
  -H 'Content-Type: application/json' \
  --data @- <<'EOF'
{
  "trading_key": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
  "auth": {
    "client_ts_ms": "1731536000000",
    "recv_window_ms": "5000",
    "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "signer": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "signature": "3muKct6upyRNAr1CPdYcxQGCojpuB4gaEnWvbNwEBJ6rrKaThRZrKY56rpYbFEsGUZqJ4iCTJqYrPuxfGYVzXQX3"
  }
}
EOF

{
  "status": "success",
  "data": {
    "trading_key": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1"
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Withdraw Collateral#

POST <write_base_url>/api/v1/withdrawals

Requests withdrawal of collateral to a destination token account. This request is wallet-signed.

Clients do not send a fee field. amount is the gross amount debited from the account; the exchange sends amount minus the current signed withdrawal fee to destination_token_account. Read the active fee from GET /api/v1/features (withdrawal_fee_usd).

Destination address

Derive the destination_token_account associated token account (ATA) with the standard Solana formula: PDA seeds [wallet, spl_token_program_id, usd_token_mint] under the Associated Token program.

Request Body

JSON Response Payload

On success, the response envelope's data object has these fields:

curl -X POST https://trade.pascal.trade/api/v1/withdrawals \
  -H 'Content-Type: application/json' \
  --data @- <<'EOF'
{
  "amount": "25.000000",
  "destination_authority": "29d2S7vB453rNYFdR5Ycwt7y9haRT5fwVwL9zTmBhfV2",
  "destination_token_account": "3JF3sEqM796hk5WFqA6EtmEwJQ9quALszsfJyvXNQKy3",
  "auth": {
    "client_ts_ms": "1731536000000",
    "recv_window_ms": "5000",
    "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "signer": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "signature": "61YYUBk6BTXkfrksMbqDLUNxwo6jhMPqdP7fNnWjNF2FYvMDujTsaUxfCiRxXX72jxy4oLtt6AtLodCvjDi4XpDn"
  }
}
EOF

{
  "status": "success",
  "data": {
    "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "amount": "25.000000",
    "destination_authority": "29d2S7vB453rNYFdR5Ycwt7y9haRT5fwVwL9zTmBhfV2",
    "destination_token_account": "3JF3sEqM796hk5WFqA6EtmEwJQ9quALszsfJyvXNQKy3"
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Register A Deposit Address#

POST <write_base_url>/api/v1/deposit-addresses

Registers the account's deposit address for balance scanning. This request is wallet-signed. Check Features for the attribution mechanism currently active: while invite_codes_enabled is true, a new account must include an invite_code; while referral_codes_enabled is true, a new account may include a referrer's referral_code to credit the referral. Submit at most one of the two codes; requests carrying both, or a referral_code while referral codes are not enabled, are rejected. A registration carrying a Referral Code succeeds only when attribution is created. If the code is unknown, revoked, self-referring, or otherwise cannot resolve, the request fails with REFERRAL_CODE_INVALID; the account remains unregistered and may retry with a corrected code or without one. The Reward Owner can observe a successfully created Referral through their Referrals list.

Request Body

JSON Response Payload

curl -X POST https://trade.pascal.trade/api/v1/deposit-addresses \
  -H 'Content-Type: application/json' \
  --data @- <<'EOF'
{
  "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
  "invite_code": "4PHPW-S4BM2-U9MS6-KP2JF",
  "auth": {
    "client_ts_ms": "1731536000000",
    "recv_window_ms": "5000",
    "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "signer": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "signature": "3y43tLaBWdQyxkj7BAbbSEmGfd6Fu3Xop5ATyWcLiC4XYFgNJSmoKXmyC8Qnu7oRUzAnEycmfSLzdyAV5L3cxecc"
  }
}
EOF

{
  "status": "success",
  "data": {
    "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "deposit_address": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "registered": true
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Generate A Referral Code#

POST <write_base_url>/api/v1/referral-codes

Creates the owner's reusable referral code. This request is signed by an active trading key. Each owner can generate one code, and generation requires a deposited account. Use Features to check whether referral codes are enabled (referral_codes_enabled), and Referrals for the owner's current code and the can_generate_referral_code flag.

A new user referred with this code submits it as referral_code in Register A Deposit Address, which creates a Referral under the Referral Program.

Request Body

JSON Response Payload

On success, the response envelope's data object has these fields:

curl -X POST https://trade.pascal.trade/api/v1/referral-codes \
  -H 'Content-Type: application/json' \
  --data @- <<'EOF'
{
  "auth": {
    "client_ts_ms": "1731536000000",
    "recv_window_ms": "5000",
    "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "signer": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
    "signature": "4UpZqQfCNDbj3NEnkkRUQsW5USTTcv7JekvPWyHsEC2ifcc3R8PwEVd5xVWZuSNacyNHrZg29ZqPeUME3GWGpnCN"
  }
}
EOF

{
  "status": "success",
  "data": {
    "generated_referral_code": "k7wq2m4x"
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Claim A Custom Referral Code#

POST <write_base_url>/api/v1/referral-codes/custom

Claims the owner's one-time Custom Referral Code. This request is signed by an active trading key, requires a deposited account, and succeeds at most once per owner. Use Features for custom_referral_codes_enabled, and Referrals for the owner's current code and can_claim_custom_referral_code.

The code must contain 6–20 lowercase ASCII letters or digits and is not normalized by the server. Four- and five-character values fail with referral_code_too_short. Values shorter than four characters or otherwise outside the Referral Code format fail request parsing. Codes that are occupied or fail content policy fail with referral_code_unavailable.

Request Body

JSON Response Payload

On success, the response envelope's data object has these fields:

curl -X POST https://trade.pascal.trade/api/v1/referral-codes/custom \
  -H 'Content-Type: application/json' \
  --data @- <<'EOF'
{
  "referral_code": "trader1",
  "auth": {
    "client_ts_ms": "1731536000000",
    "recv_window_ms": "5000",
    "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "signer": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
    "signature": "26FzDQPEDR6u7rKhkaEEJL1YSyKpbUCCibQtQxkDfEfEjyAsJu17X5p8TtuW5iXQfCNbs9gjEsFecqPv4yffwsgS"
  }
}
EOF

{
  "status": "success",
  "data": {
    "custom_referral_code": "trader1"
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Set A Username#

POST <write_base_url>/api/v1/usernames

Sets, renames, or clears the authenticated owner's Username. This request is signed by an active trading key and requires a deposited account.

Usernames contain 3 to 20 ASCII letters, digits, underscores, or hyphens. Submitted casing is preserved, but uniqueness is case-insensitive. Send an empty string to clear the current Username. An unavailable Username returns CONFLICT with the message That name is taken.

Request Body

JSON Response Payload

curl -X POST https://trade.pascal.trade/api/v1/usernames \
  -H 'Content-Type: application/json' \
  --data @- <<'EOF'
{
  "username": "Trader",
  "auth": {
    "client_ts_ms": "1731536000000",
    "recv_window_ms": "5000",
    "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
    "signer": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
    "signature": "2aEt4QQeG3iFTD6tAZvDnfKzna7cnVh18eq6cveGho9mdwfDGLoFjs1fsyYieXuZKKGdpFFCH8VgvVQJ2K1BBmjV"
  }
}
EOF

{
  "status": "success",
  "data": {
    "username": "Trader"
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Order Entry WebSocket#

GET wss://trade.pascal.trade/ws upgrades to a WebSocket connection for placing and cancelling orders.

Submission via WebSocket may be useful to users who want many concurrent orders in flight and also want guaranteed submission ordering.

Note:

• WebSocket messages sent on one connection enter matching in the order you sent them, so an order can replace or cancel an order whose acknowledgement has not arrived yet (see Matching Rounds And Priority)
• Send up to 128 concurrent messages per connection. At the cap the server stops reading the socket until responses are delivered.
• Rate limit of 1,000 requests per second (counting batch items and pings).
• Batch and message size limits are the same as for REST: 50 requests per frame, 64 KiB per frame.
• Send {"type":"ping"} messages to keep the connection open. Connections idle for 60 seconds are closed.
• Responses do not necessarily arrive in the order requests were sent. Use the id field on the request envelope to identify responses.

Client Requests#

Send JSON place and cancel messages shaped like

{
  "id": "42",
  "type": "place|cancel|ping",
  "payload": "/* same place or cancel payload as REST */"
}

The payload matches the Place And Replace Orders array for place, or the Cancel Orders array for cancel exactly.

id is an optional field echoed back on the message's response, to help the client match responses to requests.

Ping keeps the connection alive and verifies the server end-to-end. The server responds with {"type":"pong"}.

{
  "id": "1",
  "type": "place",
  "payload": [
    {
      "client_order_id": "42",
      "symbol": "SIM_EVENT_1.MARKET_1",
      "side": "BID",
      "price": "0.550000",
      "size": "10",
      "auth": {
        "client_ts_ms": "1731536000000",
        "recv_window_ms": "5000",
        "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
        "signer": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
        "signature": "2rUctQ9bFbuQaUxbXDGRtGm4LMj3GdbYWAW6pjrznAsLvpdH8Eqyx3LgsFx3YzV9cvMfw1ND5T5nChUQZZJ7jEad"
      }
    }
  ]
}

{
  "id": "2",
  "type": "cancel",
  "payload": [
    {
      "client_order_id": "42",
      "auth": {
        "client_ts_ms": "1731536000000",
        "recv_window_ms": "5000",
        "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
        "signer": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
        "signature": "591YziUjZzro24mamxgRrSDdYD71NpsDBmU4UGSyrBYbFiWzYaLjR9he1P5DP8djMKMJzHTsZzwRAagvLqgtiXnc"
      }
    }
  ]
}

Server Responses#

The server sends one response message per request message, but not necessarily in request order. Match request/response messages by the echoed id, or match individual payload entries by client_order_id.

Requests rejected before entering the write pipeline (over the rate limit, under backpressure, unparseable, or over the batch size limit) get an error frame instead, echoing the frame's id and the rejected client_order_ids (both absent when they could not be parsed). Unparseable frames carry the parse error in the error frame's message; repeated ones close the connection (see Close Codes).

{
  "id": "1",
  "type": "place",
  "payload": [
    {
      "status": "success",
      "data": {
        "order": {
          "id": "987654321",
          "client_order_id": "42",
          "symbol": "SIM_EVENT_1.MARKET_1",
          "side": "BID",
          "price": "0.550000",
          "size_original": "10",
          "size_remaining": "7",
          "size_filled": "3",
          "notional_filled": "1.650000",
          "tif": "GTC",
          "type": "LIMIT",
          "post_only": false,
          "reduce_only": false,
          "seq": "67880",
          "update_seq": "67891",
          "place_ts_ms": "1731536000050",
          "update_ts_ms": "1731536000050"
        },
        "fills": [
          {
            "trade_id": "555001",
            "symbol": "SIM_EVENT_1.MARKET_1",
            "side": "BID",
            "fill_price": "0.550000",
            "fill_size": "3",
            "liquidity": "TAKER",
            "order_id": "987654321",
            "client_order_id": "42",
            "fee_usd": "0.000742",
            "collateral_change_usd": "-1.650742",
            "position_size_prev": "0",
            "realized_pnl_usd": "0.000000",
            "seq": "67891",
            "trade_ts_ms": "1731536000050"
          }
        ]
      },
      "seq": "67891",
      "state_time_ms": "1731536000050",
      "server_time_ms": "1731536000123"
    }
  ]
}

{
  "id": "2",
  "type": "cancel",
  "payload": [
    {
      "status": "success",
      "data": {
        "id": "987654321",
        "client_order_id": "42",
        "symbol": "SIM_EVENT_1.MARKET_1",
        "side": "BID",
        "price": "0.550000",
        "size_original": "10",
        "size_remaining": "0",
        "size_filled": "3",
        "notional_filled": "1.650000",
        "tif": "GTC",
        "type": "LIMIT",
        "post_only": false,
        "reduce_only": false,
        "seq": "67880",
        "update_seq": "67891",
        "place_ts_ms": "1731536000050",
        "update_ts_ms": "1731536000050"
      },
      "seq": "67891",
      "state_time_ms": "1731536000050",
      "server_time_ms": "1731536000123"
    }
  ]
}

{
  "id": "3",
  "type": "error",
  "payload": {
    "data": {
      "code": "RATE_LIMITED",
      "message": "rate limited; slow down before retrying"
    },
    "client_order_ids": [
      "42"
    ]
  }
}

Close Codes#

Clients closed with malformed_frame or rate_limited are rejected on subsequent upgrades with HTTP 429 for several minutes.

Market Data Endpoints#

Server Time#

GET <read_base_url>/api/v1/time

Returns the read API server's current wall-clock time in milliseconds.

JSON Response Payload

curl 'https://data.pascal.trade/api/v1/time'

{
  "status": "success",
  "data": {
    "server_time_ms": "1731536000123"
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Features#

GET <read_base_url>/api/v1/features

Returns feature flags that clients may need before choosing a write flow.

JSON Response Payload

curl 'https://data.pascal.trade/api/v1/features'

{
  "status": "success",
  "data": {
    "invite_codes_enabled": true,
    "referral_codes_enabled": false,
    "custom_referral_codes_enabled": false,
    "usernames_enabled": false,
    "withdrawal_fee_usd": "0.500000"
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Usernames#

GET <read_base_url>/api/v1/usernames?owners={owner_1},{owner_2}

Returns active Usernames for up to 100 account owners. Owners without a Username are omitted. The request rejects an empty owner list, duplicate owners, and lists over the limit.

Query Parameters

JSON Response Payload

curl 'https://data.pascal.trade/api/v1/usernames?owners=GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB,J2xccRtuG43drESLYznHhLhQkLTdfepcKYbiQ9BsJVaf'

{
  "status": "success",
  "data": {
    "usernames": {
      "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB": "Trader"
    }
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Referral Code#

GET <read_base_url>/api/v1/referral-codes/{referral_code}

Returns whether referral_code currently resolves to a Reward Owner, plus the taker discount terms a referred user receives at registration. Revoked Custom Referral Codes return exists: false. See the Referral Program for how both sides of a Referral work.

Codes are 4 to 20 characters of lowercase a-z0-9; other values are rejected with invalid_request.

JSON Response Payload

curl 'https://data.pascal.trade/api/v1/referral-codes/k7wq2m4x'

{
  "status": "success",
  "data": {
    "exists": true,
    "taker_fee_discount_share": "0.050000",
    "fee_savings_limit_usd": "250.000000"
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

List Markets#

GET <read_base_url>/api/v1/markets

Returns unresolved markets and their current state, ordered by symbol.

JSON Response Payload

Returns a JSON array of market objects. Every element in the array is a JSON object:

MarketStateMsg#

Contains the market spec, display attributes, and current state exposed by the Read API.

display_attributes object:

MarketDisplayAttributes#

Additional market attributes used for display purposes only.

display_attributes.scalar and legacy display_attributes.range objects:

RangeDisplayAttributes#

display_attributes.topic object:

TopicInfo#

Higher-level category that links related events for display.

display_attributes.game_page object:

GamePageDisplayInfo#

Display metadata for sections (game lines) under the same game.

display_attributes.colors object, present on head-to-head sections such as a moneyline. Use the color for the active theme as supplied.

MarketDisplayColors#

Theme colors for a market's outcomes.

display_attributes.colors.market and display_attributes.colors.reverse objects:

ThemeDisplayColors#

A display color for each theme, as an opaque #RRGGBB value. Use the one for the active theme as supplied.

display_attributes.market_type enum:

MarketType#

Typed market category and category-specific details for a listed market.

For example, sports markets use kind: "sports" with a nested sport value such as "soccer".

"sports" fields

display_attributes.market_type.sport enum for kind: sports market types:

SportsMarketType#

Sport-specific market type details.

"soccer" fields

"baseball" fields

"league_of_legends" fields

"counter_strike" fields

"tennis" fields

"football" fields

"basketball" fields

display_attributes.market_type.period enum for soccer markets:

SoccerPeriod#

Portion of a soccer match that a market settles on.

display_attributes.market_type.period enum for baseball markets:

BaseballPeriod#

Portion of a baseball game that a market settles on.

display_attributes.market_type.period enum for football markets:

FootballPeriod#

Portion of a football game that a market settles on.

display_attributes.market_type.period enum for basketball markets:

BasketballPeriod#

Portion of a basketball game that a market settles on.

display_attributes.market_type.period enum for tennis markets:

TennisPeriod#

Portion of a tennis match that a market settles on.

display_attributes.market_type.match_format enum for tennis markets:

TennisMatchFormat#

Number of sets in a completed tennis match.

display_attributes.market_type.series_format enum for best-of esports markets:

BestOfSeriesFormat#

Format of a best-of series.

display_attributes.market_type.teams object for fixture-scoped team sports:

HomeAwayTeams#

Provider-designated home and away competitors for match-scoped market types.

For neutral-site, esports, and individual-sport matches, home and away provide canonical fixture ordering and do not imply that either competitor is playing at a home venue.

display_attributes.market_type.market enum for soccer markets:

SoccerMarket#

Soccer market types.

"moneyline" fields

"spread" fields

"total_goals" fields

display_attributes.market_type.market enum for baseball markets:

BaseballMarket#

Market types for a baseball game.

"moneyline" fields

"spread" fields

"total" fields

display_attributes.market_type.market enum for football markets:

FootballMarket#

Football market types.

"moneyline" fields

"spread" fields

"total_points" fields

display_attributes.market_type.market enum for basketball markets:

BasketballMarket#

Basketball market types.

"moneyline" fields

"spread" fields

"total_points" fields

display_attributes.market_type.market enum for League of Legends markets:

LeagueOfLegendsMarket#

League of Legends market types.

"moneyline" fields

"map_winner" fields

"map_handicap" fields

"total_maps" fields

display_attributes.market_type.market enum for Counter-Strike markets:

CounterStrikeMarket#

Counter-Strike market types.

"moneyline" fields

"map_winner" fields

"map_handicap" fields

"total_maps" fields

display_attributes.market_type.market enum for tennis markets:

TennisMarket#

Tennis market types.

"moneyline" fields

"set_handicap" fields

"total_sets" fields

"total_games" fields

display_attributes.market_type.market.outcome enum for moneyline market types that can draw:

ThreeWayOutcome#

Home, away, or draw outcome for three-way markets.

display_attributes.market_type.market.team enum for team-scoped market types:

TeamSide#

display_attributes.sort_order enum:

MarketSort#

An enum encoding the default sort order for markets on the UI

display_attributes.reference enum:

ReferenceAttributes#

"polymarket" fields

resolution object:

MarketResolutionMsg#

Final resolution metadata for a market.

stats object:

MarketStatsMsg#

last_24h and all_time use the following shape:

MarketStatsSnapshotMsg#

For last_24h, window_end_ts_ms_exclusive is the latest closed minute. Markets with no history receive a zero snapshot at that boundary.

Resolution does not freeze the 24-hour window. A resolved market keeps its final price while volume, trades, and earlier prices age out normally. Once the window begins after resolution, mark_price_start is the final price.

curl 'https://data.pascal.trade/api/v1/markets'

{
  "status": "success",
  "data": [
    {
      "symbol": "SIM_EVENT_1.MARKET_1",
      "taker_fee_rate": "0.001000",
      "maker_rebate_share": "0.500000",
      "tick_size_min": "0.010000",
      "tick_sig_figs": 2,
      "display_attributes": {
        "event_description": "API documentation sample market",
        "expected_resolution_time_ms": "1735000000000",
        "market_description": "Yes",
        "reverse_description": "No",
        "sort_order": "SYMBOL_ASC",
        "tags": [
          "Docs"
        ],
        "topic": {
          "id": "docs",
          "description": "Documentation examples"
        }
      },
      "listing_ts_ms": "1731536000000",
      "rules_url": "https://sample-rules-url.com/events/SIM_EVENT_1/SIM_EVENT_1.MARKET_1.md",
      "stats": {
        "last_24h": {
          "mark_price_start": "0.520000",
          "taker_buy_volume": "120",
          "taker_sell_volume": "90",
          "taker_buy_volume_notional": "64.800000",
          "taker_sell_volume_notional": "48.600000",
          "taker_buy_trade_count": "18",
          "taker_sell_trade_count": "14",
          "window_end_ts_ms_exclusive": "1731535980000"
        },
        "all_time": {
          "taker_buy_volume": "1200",
          "taker_sell_volume": "900",
          "taker_buy_volume_notional": "648.000000",
          "taker_sell_volume_notional": "486.000000",
          "taker_buy_trade_count": "180",
          "taker_sell_trade_count": "140",
          "window_end_ts_ms_exclusive": "1731535980000"
        }
      },
      "mark_price": "0.550000",
      "open_interest": "250"
    }
  ],
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Resolved Markets#

GET <read_base_url>/api/v1/markets/resolved

Returns markets resolved within the requested lookback.

Query Parameters

order_by enum:

ResolvedMarketOrderBy#

Resolved market ordering field.

order_by behavior:

Resolved markets use the rolling-statistics semantics described under List Markets.

JSON Response Payload

Returns a JSON array of market objects. Same object shape as GET /api/v1/markets.

Market Symbols#

Symbols are uppercase ASCII identifiers up to 32 bytes long, of the form EVENT.MARKET. The event prefix groups markets that share a resolution event; the market suffix identifies the specific outcome.

For example, NYCMAYOR_25NOV04.MAMDANI denotes the "Mamdani" outcome of the 2025-11-04 New York City mayoral election event. A second outcome on the same event might be NYCMAYOR_25NOV04.ADAMS.

Symbols are immutable and globally unique.

curl 'https://data.pascal.trade/api/v1/markets/resolved?lookback=24h&order_by=resolution_time&limit=50'

{
  "status": "success",
  "data": [
    {
      "symbol": "SIM_EVENT_1.MARKET_1",
      "taker_fee_rate": "0.001000",
      "maker_rebate_share": "0.500000",
      "tick_size_min": "0.010000",
      "tick_sig_figs": 2,
      "display_attributes": {
        "event_description": "API documentation sample market",
        "expected_resolution_time_ms": "1731536000050",
        "market_description": "Yes",
        "reverse_description": "No",
        "sort_order": "SYMBOL_ASC",
        "tags": [
          "Docs"
        ],
        "topic": {
          "id": "docs",
          "description": "Documentation examples"
        }
      },
      "listing_ts_ms": "1731536000000",
      "rules_url": "https://sample-rules-url.com/events/SIM_EVENT_1/SIM_EVENT_1.MARKET_1.md",
      "stats": {
        "last_24h": {
          "mark_price_start": "0.520000",
          "taker_buy_volume": "120",
          "taker_sell_volume": "90",
          "taker_buy_volume_notional": "64.800000",
          "taker_sell_volume_notional": "48.600000",
          "taker_buy_trade_count": "18",
          "taker_sell_trade_count": "14",
          "window_end_ts_ms_exclusive": "1731535980000"
        },
        "all_time": {
          "taker_buy_volume": "1200",
          "taker_sell_volume": "900",
          "taker_buy_volume_notional": "648.000000",
          "taker_sell_volume_notional": "486.000000",
          "taker_buy_trade_count": "180",
          "taker_sell_trade_count": "140",
          "window_end_ts_ms_exclusive": "1731535980000"
        }
      },
      "mark_price": "1.000000",
      "open_interest": "0",
      "resolution": {
        "price": "1.000000",
        "seq": "67891",
        "market_resolution_ts_ms": "1731536000050"
      }
    }
  ],
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Market Search#

POST <read_base_url>/api/v1/markets/search

Returns markets matching any requested symbol, event, or game. Symbol, event, and game filters are exact-match filters combined with union semantics. At least one filter is required. Search results include resolved markets.

Requests may include at most 500 symbols, at most 50 event codes, and at most 50 games.

Markets are ordered by symbol.

Resolved markets use the rolling-statistics semantics described under List Markets.

JSON Request Body

JSON Response Payload

Returns a JSON array of market objects. Same object shape as GET /api/v1/markets.

curl -X POST https://data.pascal.trade/api/v1/markets/search \
  -H 'Content-Type: application/json' \
  --data @- <<'EOF'
{
  "symbols": [
    "SIM_EVENT_1.MARKET_1"
  ],
  "events": [
    "SIM_EVENT_1"
  ],
  "games": [
    "fifa-world-cup-fra-irq-2026-06-22"
  ]
}
EOF

{
  "status": "success",
  "data": [
    {
      "symbol": "SIM_EVENT_1.MARKET_1",
      "taker_fee_rate": "0.001000",
      "maker_rebate_share": "0.500000",
      "tick_size_min": "0.010000",
      "tick_sig_figs": 2,
      "display_attributes": {
        "event_description": "API documentation sample market",
        "expected_resolution_time_ms": "1735000000000",
        "market_description": "Yes",
        "reverse_description": "No",
        "sort_order": "SYMBOL_ASC",
        "tags": [
          "Docs"
        ],
        "topic": {
          "id": "docs",
          "description": "Documentation examples"
        }
      },
      "listing_ts_ms": "1731536000000",
      "rules_url": "https://sample-rules-url.com/events/SIM_EVENT_1/SIM_EVENT_1.MARKET_1.md",
      "stats": {
        "last_24h": {
          "mark_price_start": "0.520000",
          "taker_buy_volume": "120",
          "taker_sell_volume": "90",
          "taker_buy_volume_notional": "64.800000",
          "taker_sell_volume_notional": "48.600000",
          "taker_buy_trade_count": "18",
          "taker_sell_trade_count": "14",
          "window_end_ts_ms_exclusive": "1731535980000"
        },
        "all_time": {
          "taker_buy_volume": "1200",
          "taker_sell_volume": "900",
          "taker_buy_volume_notional": "648.000000",
          "taker_sell_volume_notional": "486.000000",
          "taker_buy_trade_count": "180",
          "taker_sell_trade_count": "140",
          "window_end_ts_ms_exclusive": "1731535980000"
        }
      },
      "mark_price": "0.550000",
      "open_interest": "250"
    }
  ],
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Market Text Search#

POST <read_base_url>/api/v1/markets/text-search

Returns markets whose symbol, event description, market description, or tag contains the requested text. Matching is case-insensitive substring matching. If tags is provided, every returned market must contain all requested tags exactly.

Requests must include a query between 3 and 64 characters after trimming. Missing or type-invalid fields fail JSON request parsing; blank, too-short, or too-long trimmed queries return INVALID_REQUEST.

Results are ordered by order_by. limit defaults to 50 and may not exceed 100.

Resolved markets use the rolling-statistics semantics described under List Markets.

JSON Request Body

status enum:

MarketStatusFilter#

Market lifecycle status filter.

order_by enum:

MarketSearchOrderBy#

Market text-search ordering field.

order_by behavior:

JSON Response Payload

Returns a JSON array of market objects. Same object shape as GET /api/v1/markets.

curl -X POST https://data.pascal.trade/api/v1/markets/text-search \
  -H 'Content-Type: application/json' \
  --data @- <<'EOF'
{
  "query": "api",
  "tags": [
    "Finance"
  ],
  "status": "live",
  "order_by": "volume_24h",
  "limit": 25
}
EOF

{
  "status": "success",
  "data": [
    {
      "symbol": "SIM_EVENT_1.MARKET_1",
      "taker_fee_rate": "0.001000",
      "maker_rebate_share": "0.500000",
      "tick_size_min": "0.010000",
      "tick_sig_figs": 2,
      "display_attributes": {
        "event_description": "API documentation sample market",
        "expected_resolution_time_ms": "1735000000000",
        "market_description": "Yes",
        "reverse_description": "No",
        "sort_order": "SYMBOL_ASC",
        "tags": [
          "Docs"
        ],
        "topic": {
          "id": "docs",
          "description": "Documentation examples"
        }
      },
      "listing_ts_ms": "1731536000000",
      "rules_url": "https://sample-rules-url.com/events/SIM_EVENT_1/SIM_EVENT_1.MARKET_1.md",
      "stats": {
        "last_24h": {
          "mark_price_start": "0.520000",
          "taker_buy_volume": "120",
          "taker_sell_volume": "90",
          "taker_buy_volume_notional": "64.800000",
          "taker_sell_volume_notional": "48.600000",
          "taker_buy_trade_count": "18",
          "taker_sell_trade_count": "14",
          "window_end_ts_ms_exclusive": "1731535980000"
        },
        "all_time": {
          "taker_buy_volume": "1200",
          "taker_sell_volume": "900",
          "taker_buy_volume_notional": "648.000000",
          "taker_sell_volume_notional": "486.000000",
          "taker_buy_trade_count": "180",
          "taker_sell_trade_count": "140",
          "window_end_ts_ms_exclusive": "1731535980000"
        }
      },
      "mark_price": "0.550000",
      "open_interest": "250"
    }
  ],
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Order Books#

GET <read_base_url>/api/v1/books

Returns order books for up to 50 comma-delimited symbols.

Single-symbol responses may be up to one second old. For live order books, use the book WebSocket channel, which starts with a full snapshot and then streams updates.

Query Parameters

JSON Response Payload

Each value in books is an order book object:

OrderBookMsg#

Order book message for API responses.

Levels are (price, size) tuples serialized as string arrays: [["0.50", "100"], ...]

spec object:

MarketSpec#

Specification for a tradeable market.

curl 'https://data.pascal.trade/api/v1/books?symbols=SIM_EVENT_1.MARKET_1,SIM_EVENT_1.MARKET_2'

{
  "status": "success",
  "data": {
    "books": {
      "SIM_EVENT_1.MARKET_1": {
        "asks": [
          [
            "0.560000",
            "12"
          ],
          [
            "0.570000",
            "20"
          ]
        ],
        "bids": [
          [
            "0.540000",
            "15"
          ],
          [
            "0.530000",
            "7"
          ]
        ],
        "spec": {
          "symbol": "SIM_EVENT_1.MARKET_1",
          "taker_fee_rate": "0.001000",
          "maker_rebate_share": "0.500000",
          "tick_size_min": "0.010000",
          "tick_sig_figs": 2
        }
      },
      "SIM_EVENT_1.MARKET_2": {
        "asks": [
          [
            "0.560000",
            "12"
          ],
          [
            "0.570000",
            "20"
          ]
        ],
        "bids": [
          [
            "0.540000",
            "15"
          ],
          [
            "0.530000",
            "7"
          ]
        ]
      }
    }
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Trade Candles#

GET <read_base_url>/api/v1/trade-candles

Legacy compatibility path: GET <read_base_url>/api/v1/candles.

Returns OHLCV trade candles for one market and interval. Ranges are end-exclusive. If start_time_ms is omitted, count_back controls how many candles are returned before end_time_ms. interval must be one of 1m, 5m, 15m, 1h, 4h, 12h, and 1d. count_back defaults to 100 and must be between 1 and 500.

Query Parameters

JSON Response Payload

Returns a JSON array of candle objects. Every element in the array is a JSON object:

CandleMsg#

OHLCV candle in TradingView-compatible format.

curl 'https://data.pascal.trade/api/v1/trade-candles?symbol=SIM_EVENT_1.MARKET_1&interval=1m&end_time_ms=1731536000000&count_back=2'

{
  "status": "success",
  "data": [
    {
      "time": "1731535960000",
      "open": "0.520000",
      "high": "0.570000",
      "low": "0.510000",
      "close": "0.550000",
      "volume": "120",
      "taker_buy_volume": "70",
      "taker_sell_volume": "50",
      "volume_notional": "66.000000",
      "taker_buy_volume_notional": "38.500000",
      "taker_sell_volume_notional": "27.500000",
      "trade_count": "8",
      "taker_buy_count": "5",
      "taker_sell_count": "3"
    }
  ],
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Mark Price Candles#

GET <read_base_url>/api/v1/mark-price-candles

Returns sparse mark price OHLC candles for one market and interval. Ranges are end-exclusive. If start_time_ms is omitted, count_back controls how many candles are returned before end_time_ms. interval must be one of 1m, 5m, 15m, 1h, 4h, 12h, and 1d. count_back defaults to 100 and must be between 1 and 500.

Query Parameters

JSON Response Payload

Returns a JSON array of mark price candle objects. Every element in the array is a JSON object:

MarkPriceCandleMsg#

Mark price OHLC candle.

curl 'https://data.pascal.trade/api/v1/mark-price-candles?symbol=SIM_EVENT_1.MARKET_1&interval=1m&end_time_ms=1731536000000&count_back=2'

{
  "status": "success",
  "data": [
    {
      "time": "1731535960000",
      "open": "0.540000",
      "high": "0.580000",
      "low": "0.530000",
      "close": "0.560000"
    }
  ],
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Batch Mark Price Candles#

GET <read_base_url>/api/v1/mark-price-candles/batch

Returns sparse mark price OHLC candles for up to 20 symbols sharing one interval and time range.

Uses the same range semantics as GET /api/v1/mark-price-candles, except count_back and explicit range queries are capped at 200 candles per symbol.

Unknown symbols are omitted from items; returned items preserve request order.

Query Parameters

JSON Response Payload

Each value in items is a JSON object:

MarkPriceCandlesBatchItem#

Mark price candle data for one requested symbol.

Each value in candles is a mark price candle object using MarkPriceCandleMsg.

curl 'https://data.pascal.trade/api/v1/mark-price-candles/batch?symbols=SIM_EVENT_1.MARKET_1,SIM_EVENT_1.MARKET_2&interval=1m&end_time_ms=1731536000000&count_back=2'

{
  "status": "success",
  "data": {
    "items": [
      {
        "symbol": "SIM_EVENT_1.MARKET_1",
        "candles": [
          {
            "time": "1731535960000",
            "open": "0.540000",
            "high": "0.580000",
            "low": "0.530000",
            "close": "0.560000"
          }
        ]
      },
      {
        "symbol": "SIM_EVENT_1.MARKET_2",
        "candles": []
      }
    ]
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Trades#

GET <read_base_url>/api/v1/trades

Returns trade history for up to 30 markets.

Query Parameters

JSON Response Payload

Returns a paginated JSON object:

Every element in items is a JSON object:

PublicTradeMsg#

Public trade message.

This is not the same as the account-specific FillMsg, which is a view of one side of a trade, from one account's perspective.

Next-page request using the data.next_cursor value above as before_cursor:

curl 'https://data.pascal.trade/api/v1/trades?symbols=SIM_EVENT_1.MARKET_1&limit=50'

{
  "status": "success",
  "data": {
    "items": [
      {
        "trade_id": "555001",
        "symbol": "SIM_EVENT_1.MARKET_1",
        "taker_side": "BID",
        "price": "0.550000",
        "size": "3",
        "maker": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
        "taker": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
        "seq": "67891",
        "trade_ts_ms": "1731536000050"
      }
    ],
    "next_cursor": "00000000000000067890:0000000000"
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

curl 'https://data.pascal.trade/api/v1/trades?symbols=SIM_EVENT_1.MARKET_1&before_cursor=00000000000000067890%3A0000000000&limit=50'

Batch Trades#

GET <read_base_url>/api/v1/trades/batch

Returns the most recent trades for up to 20 markets, newest-first per market. This is the batch equivalent of the first page of GET /api/v1/trades.

Unknown symbols are omitted from items; returned items preserve request order. limit defaults to 10 and must be between 1 and 50.

Query Parameters

JSON Response Payload

Each value in items is a JSON object:

TradesBatchItem#

Recent trades for one requested symbol.

Each value in trades is a public trade object using PublicTradeMsg.

curl 'https://data.pascal.trade/api/v1/trades/batch?symbols=SIM_EVENT_1.MARKET_1,SIM_EVENT_1.MARKET_2&limit=10'

{
  "status": "success",
  "data": {
    "items": [
      {
        "symbol": "SIM_EVENT_1.MARKET_1",
        "trades": [
          {
            "trade_id": "555001",
            "symbol": "SIM_EVENT_1.MARKET_1",
            "taker_side": "BID",
            "price": "0.550000",
            "size": "3",
            "maker": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
            "taker": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
            "seq": "67891",
            "trade_ts_ms": "1731536000050"
          }
        ]
      },
      {
        "symbol": "SIM_EVENT_1.MARKET_2",
        "trades": [
          {
            "trade_id": "555001",
            "symbol": "SIM_EVENT_1.MARKET_2",
            "taker_side": "BID",
            "price": "0.550000",
            "size": "3",
            "maker": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
            "taker": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
            "seq": "67891",
            "trade_ts_ms": "1731536000050"
          }
        ]
      }
    ]
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}

Top Holders#

GET <read_base_url>/api/v1/top-holders

Returns the largest active position holders across up to 50 comma-delimited symbols, split into longs (positive position size) and shorts (negative position size) per market. limit applies to each side independently. Each side is ordered by absolute contract size descending, then owner public-key byte order ascending. Requested symbols for resolved markets are returned with empty longs and shorts arrays because they no longer have active positions.

Query Parameters

JSON Response Payload

Each value in holders is a JSON object:

MarketTopHoldersMsg#

Largest active holders for one market, split by position side.

Every holder row in longs and shorts is a JSON object. See Realized and Unrealized PnL for the position lifecycle, average entry price, and PnL semantics:

TopHolderMsg#

Holder row for a market.

curl 'https://data.pascal.trade/api/v1/top-holders?symbols=SIM_EVENT_1.MARKET_1,SIM_EVENT_1.MARKET_2&limit=20'

{
  "status": "success",
  "data": {
    "holders": {
      "SIM_EVENT_1.MARKET_1": {
        "longs": [
          {
            "owner": "GmaDrppBC7P5ARKV8g3djiwP89vz1jLK23V2GBjuAEGB",
            "position": {
              "symbol": "SIM_EVENT_1.MARKET_1",
              "size": "3",
              "cumulative_fees_usd": "0.000742",
              "realized_pnl_usd": "0.000000",
              "unrealized_pnl_usd": "0.000000",
              "mark_price": "0.550000",
              "average_entry_price": "0.550000",
              "seq": "67880",
              "update_seq": "67891",
              "open_ts_ms": "1731535900000",
              "update_ts_ms": "1731536000050"
            }
          }
        ],
        "shorts": []
      },
      "SIM_EVENT_1.MARKET_2": {
        "longs": [],
        "shorts": [
          {
            "owner": "2KW2XRd9kwqet15Aha2oK3tYvd3nWbTFH1MBiRAv1BE1",
            "position": {
              "symbol": "SIM_EVENT_1.MARKET_2",
              "size": "-80",
              "cumulative_fees_usd": "0.019800",
              "realized_pnl_usd": "0.000000",
              "unrealized_pnl_usd": "1.600000",
              "mark_price": "0.530000",
              "average_entry_price": "0.550000",
              "seq": "67880",
              "update_seq": "67891",
              "open_ts_ms": "1731535900000",
              "update_ts_ms": "1731536000050"
            }
          }
        ]
      }
    }
  },
  "seq": "67891",
  "state_time_ms": "1731536000050",
  "server_time_ms": "1731536000123"
}