Skip to main content
GET
/
v1
/
accounts
/
{account_id}
/
trades
List Account Trades
curl --request GET \
  --url https://api.predictamarkets.com/v1/accounts/{account_id}/trades \
  --header 'X-Api-Key: <api-key>'
[
  {
    "id": 201,
    "market_id": 12,
    "market_asset_id": 34,
    "buyer_account_id": 1042,
    "seller_account_id": 1099,
    "price": "65.00",
    "quantity": "10.00",
    "created_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 trades

​
trade_timestamp
string<date-time>
required

Timestamp of the trade

​
market_asset
MarketAssetSchema · object
required

Market asset

​
id
integer | null

Primary key, auto-generated

​
qid
string | null

Query identifier

​
market_asset_id
integer | null

Market asset ID

​
yes_order_id
integer | null

ID of the order on the YES side of this trade. The YES order holder believes the event will occur.

​
no_order_id
integer | null

ID of the order on the NO side of this trade.

​
yes_trade_price
string | null

YES trade price

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
no_trade_price
string | null

NO trade price

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
trade_quantity
string | null

Quantity traded

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
trade_cost
string | null

Total cost of the trade

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
yes_account_id
integer | null

Account ID of the participant who held the YES side of this trade.

​
no_account_id
integer | null

Account ID of the participant who held the NO side of this trade.

​
seller_account_id
integer | null

Account ID of the sell-side participant in this trade. In the continuous double auction, this is the account that placed the SELL order that was matched.

​
buyer_account_id
integer | null

Account ID of the buy-side participant in this trade — the account that placed the BUY order that triggered the match.

​
asset_identifier
string | null

Unique asset identifier