Skip to main content
GET
/
v1
/
markets
/
{market_id}
/
orders
/
{market_asset_id}
List Orders for Asset
curl --request GET \
  --url https://api.predictamarkets.com/v1/markets/{market_id}/orders/{market_asset_id} \
  --header 'X-Api-Key: <api-key>'
[
  {
    "id": 501,
    "market_id": 12,
    "market_asset_id": 34,
    "account_id": 1042,
    "order_type": "BUY",
    "opinion_side": "YES",
    "price": "65.00",
    "quantity": "10.00",
    "initial_quantity": "10.00",
    "status": "FILLED",
    "prediction_key": "mkt-12-yes",
    "auto_cancel_at": null,
    "created_at": "2025-04-10T09:00:00Z",
    "updated_at": "2025-04-10T09:01:00Z"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.predictamarkets.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Api-Key
string
header
default:your-api-key-here
required

Path Parameters

​
market_id
required

Flexible identifier type that accepts either a numeric integer ID or a human-readable qualified ID string (QID). QIDs follow a prefix convention: MA for markets, MAA for market assets, AP for account payouts. Most path parameters that accept an ID use this type so callers can use whichever form is more convenient.

​
market_asset_id
integer
required

Integer ID of the market asset (outcome)

Query Parameters

​
account_id
integer
required
​
limit
integer
default:10

Filter by order type (BUY/SELL)

​
skip
integer
default:0

Filter by order type (BUY/SELL)

​
order_type
enum<string> | null

Filter by order type (BUY/SELL)

Available options:
BUY,
SELL
​
status
enum<string> | null

Filter by order status (OPEN/FILLED/CANCELLED)

Available options:
OPEN,
PARTIAL,
FILLED,
CANCELLED
​
min_price
number | null

Minimum order price

​
max_price
number | null

Maximum order price

​
min_quantity
number | null

Minimum order quantity

​
max_quantity
number | null

Maximum order quantity

Response

Open orders

​
account_id
integer
required

Foreign key to accounts table

​
market_asset_id
integer
required

Foreign key to market_assets table

​
price
string
required

Price per share, 2 decimal places

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
quantity
string
required

Number of shares, 2 decimal places

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
initial_quantity
string
required

Initial number of shares, 2 decimal places

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
order_type
enum<string>
required

Type of order (BUY or SELL)

Available options:
BUY,
SELL
​
market_asset
MarketAssetSchema · object
required

Market asset

​
id
integer | null

Primary key, auto-generated

​
qid
string | null

Query identifier

​
opinion_side
enum<string>
default:YES

Market side (YES/NO)

Available options:
YES,
NO
​
status
enum<string>
default:OPEN

Order status

Available options:
OPEN,
PARTIAL,
FILLED,
CANCELLED
​
timestamp
string<date-time>

Order creation timestamp

​
is_dequeued
boolean
default:true

Internal processing flag. True when the order has been dequeued from the matching engine's input queue and is being or has been processed. False if still waiting in queue. Not meaningful for API consumers.

​
processing_status
enum<string>
default:PENDING

Internal state within the matching engine pipeline. PENDING means the order is queued; PROCESSING means the engine is working on it; COMPLETED means processing finished (check status for the trading result); FAILED means an error occurred.

Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED,
CANCELLED
​
error_message
string | null

Error message if processing fails

​
retry_count
integer
default:0

Number of processing retries

​
refund_status
enum<string>
default:NOT_REQUIRED

Refund status

Available options:
NOT_REQUIRED,
COMPLETED,
FAILED
​
trade_price
string | null

Actual trade price, if filled

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
last_processed_at
string<date-time> | null

Last processing timestamp