Skip to main content
GET
/
api
/
accounts
/
{accountId}
/
orders
Get Orders
curl --request GET \
  --url https://trade.predexon.com/api/accounts/{accountId}/orders \
  --header 'x-api-key: <api-key>'
{
  "orders": [
    {
      "orderId": "<string>",
      "venue": "<string>",
      "predexonId": "<string>",
      "outcome": "<string>",
      "createdAt": "<string>",
      "size": "<string>",
      "price": "<string>",
      "filled": "<string>",
      "market": {
        "tokenId": "<string>",
        "marketId": "<string>",
        "ticker": "<string>",
        "outcome": "<string>",
        "marketSlug": "<string>",
        "assetId": "<string>"
      },
      "fee": {
        "policyApplied": true,
        "feeBps": 123,
        "platformFeeBps": 123,
        "partnerFeeBps": 123,
        "grossAmount": "<string>",
        "netOrderAmount": "<string>",
        "maxFeeReserved": "<string>"
      },
      "message": "<string>"
    }
  ],
  "_meta": {
    "venues": [
      {
        "venue": "<string>"
      }
    ]
  }
}
Omit venue to get orders from every enabled venue, or pass one to filter. Each row carries the canonical predexonId for cross-referencing. The type field is null on list responses (we don’t yet extract it from the venue’s CLOB); placement responses include it from the request. Pass aggregated=true to strip the per-row venue field - useful when the consuming UI presents orders abstractly without surfacing which venue executed them.
Opinion does not return tokenId on order queries - the market bag contains marketId only. Placement responses include both.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
accountId
string
required

Query Parameters

​
venue
enum<string>
Available options:
polymarket,
predict,
opinion,
limitless,
hyperliquid
​
aggregated
boolean

When true, strips the per-row venue field for venue-agnostic UIs.

Response

Order list

​
orders
object[]
​
_meta
object

Per-plane status metadata on aggregated responses. Surfaces partial failures so clients can detect when a venue timed out or errored while others succeeded.