Skip to main content
GET
/
v1
/
accounts
/
{account_id}
/
orders
List Account Orders
curl --request GET \
  --url https://api.predictamarkets.com/v1/accounts/{account_id}/orders \
  --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

​
account_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.

Query Parameters

​
limit
integer
default:10
​
skip
integer
default:0

Response

List of 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