Python (SDK)
from finance_dev import FinanceDev, models
with FinanceDev(
security=models.Security(
client_id="<YOUR_CLIENT_ID_HERE>",
client_secret="<YOUR_CLIENT_SECRET_HERE>",
),
) as fd_client:
res = fd_client.predictions.orders.get_prediction_order(order_id="26cc5dad-e417-4e9f-acfd-09d65e80b551")
assert res.object is not None
# Handle response
print(res.object)import { FinanceDev } from "@ariesdotcom/finance-dev";
const financeDev = new FinanceDev({
security: {
clientID: "<YOUR_CLIENT_ID_HERE>",
clientSecret: "<YOUR_CLIENT_SECRET_HERE>",
},
});
async function run() {
const result = await financeDev.predictions.orders.get({
orderId: "26cc5dad-e417-4e9f-acfd-09d65e80b551",
});
console.log(result);
}
run();curl --request GET \
--url https://api.aries.com/v1/predictions/orders/{orderId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/predictions/orders/{orderId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v1/predictions/orders/{orderId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v1/predictions/orders/{orderId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aries.com/v1/predictions/orders/{orderId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/predictions/orders/{orderId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"order": {
"accountId": "ACCOUNT-0001",
"avgPx": "0",
"contract": {
"description": "Shelley Moore Capito",
"eventDisplayName": "West Virginia Senate General Election November 3 2026",
"eventId": "AXXWV_110326",
"question": "Will Shelley Moore Capito win the West Virginia general election for US Senate in 2026?",
"state": "ACTIVE",
"resultOutcome": "YES",
"settledAt": "2023-11-07T05:31:56Z",
"settlementValue": "1"
},
"createdAt": "2023-11-07T05:31:56Z",
"cumQty": "0",
"leavesQty": "10",
"orderId": "0b9f3c2e-5d6a-4f1b-8e7c-9a0d1e2f3a4b",
"orderType": "limit",
"outcome": "YES",
"quantity": "10",
"side": "buy",
"state": "pending_new",
"symbol": "HORC_1126_Republican",
"timeInForce": "day",
"updatedAt": "2023-11-07T05:31:56Z",
"workingQuantity": "10",
"certainty": "certain",
"certaintyReason": "<string>",
"clOrdId": "<string>",
"clientOrderRef": "7d1c8e0a-4b8f-4e3a-9f43-2a6b1d0c9e11",
"closedAt": "2023-11-07T05:31:56Z",
"expireTime": "2023-11-07T05:31:56Z",
"firstAckAt": "2023-11-07T05:31:56Z",
"pendingAction": "none",
"placedBy": "<string>",
"price": "0.54",
"rejectReason": "<string>",
"rejectText": "<string>",
"sentAt": "2023-11-07T05:31:56Z",
"stopPx": "0.50",
"venueOrderId": "<string>",
"version": 123,
"workingOrderType": "<string>",
"workingPrice": "0.54"
},
"reports": [
{
"execId": "<string>",
"execType": "trade",
"status": "filled",
"transactTime": "2023-11-07T05:31:56Z",
"avgPx": "0.54",
"bustedAt": "2023-11-07T05:31:56Z",
"cumQty": "10",
"lastPx": "0.54",
"lastQty": "10",
"leavesQty": "0",
"text": "<string>"
}
],
"events": [
{
"applied": true,
"clOrdId": "<string>",
"execId": "<string>",
"execType": "<string>",
"expireTime": "2023-11-07T05:31:56Z",
"kind": "cancel_requested",
"lastPx": "<string>",
"lastQty": "<string>",
"massCancelId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"notAppliedReason": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"price": "<string>",
"quantity": "<string>",
"reason": "<string>",
"requestedBy": "<string>",
"status": "<string>",
"stopPx": "<string>",
"text": "<string>",
"timeInForce": "<string>",
"transactTime": "2023-11-07T05:31:56Z",
"version": 123
}
]
}
}
Orders
Get Prediction Order
Returns one prediction-market order on an account, with every fill against it and every step of its history: placement, amends, cancels and the venue’s answers.
Use Case: Read the venue’s answer to an order after placing it: acknowledgement, rejection reason, or fills.
GET
/
v1
/
predictions
/
orders
/
{orderId}
Python (SDK)
from finance_dev import FinanceDev, models
with FinanceDev(
security=models.Security(
client_id="<YOUR_CLIENT_ID_HERE>",
client_secret="<YOUR_CLIENT_SECRET_HERE>",
),
) as fd_client:
res = fd_client.predictions.orders.get_prediction_order(order_id="26cc5dad-e417-4e9f-acfd-09d65e80b551")
assert res.object is not None
# Handle response
print(res.object)import { FinanceDev } from "@ariesdotcom/finance-dev";
const financeDev = new FinanceDev({
security: {
clientID: "<YOUR_CLIENT_ID_HERE>",
clientSecret: "<YOUR_CLIENT_SECRET_HERE>",
},
});
async function run() {
const result = await financeDev.predictions.orders.get({
orderId: "26cc5dad-e417-4e9f-acfd-09d65e80b551",
});
console.log(result);
}
run();curl --request GET \
--url https://api.aries.com/v1/predictions/orders/{orderId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/predictions/orders/{orderId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v1/predictions/orders/{orderId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v1/predictions/orders/{orderId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aries.com/v1/predictions/orders/{orderId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/predictions/orders/{orderId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"order": {
"accountId": "ACCOUNT-0001",
"avgPx": "0",
"contract": {
"description": "Shelley Moore Capito",
"eventDisplayName": "West Virginia Senate General Election November 3 2026",
"eventId": "AXXWV_110326",
"question": "Will Shelley Moore Capito win the West Virginia general election for US Senate in 2026?",
"state": "ACTIVE",
"resultOutcome": "YES",
"settledAt": "2023-11-07T05:31:56Z",
"settlementValue": "1"
},
"createdAt": "2023-11-07T05:31:56Z",
"cumQty": "0",
"leavesQty": "10",
"orderId": "0b9f3c2e-5d6a-4f1b-8e7c-9a0d1e2f3a4b",
"orderType": "limit",
"outcome": "YES",
"quantity": "10",
"side": "buy",
"state": "pending_new",
"symbol": "HORC_1126_Republican",
"timeInForce": "day",
"updatedAt": "2023-11-07T05:31:56Z",
"workingQuantity": "10",
"certainty": "certain",
"certaintyReason": "<string>",
"clOrdId": "<string>",
"clientOrderRef": "7d1c8e0a-4b8f-4e3a-9f43-2a6b1d0c9e11",
"closedAt": "2023-11-07T05:31:56Z",
"expireTime": "2023-11-07T05:31:56Z",
"firstAckAt": "2023-11-07T05:31:56Z",
"pendingAction": "none",
"placedBy": "<string>",
"price": "0.54",
"rejectReason": "<string>",
"rejectText": "<string>",
"sentAt": "2023-11-07T05:31:56Z",
"stopPx": "0.50",
"venueOrderId": "<string>",
"version": 123,
"workingOrderType": "<string>",
"workingPrice": "0.54"
},
"reports": [
{
"execId": "<string>",
"execType": "trade",
"status": "filled",
"transactTime": "2023-11-07T05:31:56Z",
"avgPx": "0.54",
"bustedAt": "2023-11-07T05:31:56Z",
"cumQty": "10",
"lastPx": "0.54",
"lastQty": "10",
"leavesQty": "0",
"text": "<string>"
}
],
"events": [
{
"applied": true,
"clOrdId": "<string>",
"execId": "<string>",
"execType": "<string>",
"expireTime": "2023-11-07T05:31:56Z",
"kind": "cancel_requested",
"lastPx": "<string>",
"lastQty": "<string>",
"massCancelId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"notAppliedReason": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"price": "<string>",
"quantity": "<string>",
"reason": "<string>",
"requestedBy": "<string>",
"status": "<string>",
"stopPx": "<string>",
"text": "<string>",
"timeInForce": "<string>",
"transactTime": "2023-11-07T05:31:56Z",
"version": 123
}
]
}
}
This endpoint is in closed beta. It is available only to accounts enrolled in the beta. Request and response shapes may change before general availability.
Overview
Place Prediction Order returns before the venue answers. Use the returnedorderId and its accountId here to see what happened. data.order is the order’s current state, data.reports lists its fills, and data.events is every step that got it there. All three are read from one snapshot, so they agree.
accountId is required. Orders belong to the account: any user acting on it can read every order on it, and placedBy says who placed each.
Reading the order
| Field | Notes |
|---|---|
state | pending_new until the venue acknowledges, then new, partially_filled, filled, canceled, rejected, expired, or done_for_day. |
quantity, price, stopPx | The terms you submitted. They never change. |
workingQuantity, workingPrice, workingOrderType | The terms the venue is working. |
cumQty, leavesQty, avgPx | Filled quantity, remaining quantity, and average fill price. |
rejectReason, rejectText | Set on rejection. rejectText is the venue’s own wording and usually carries the useful detail. |
version | Rises with every change to the order. Stream Prediction Orders uses it to order updates. |
certainty, certaintyReason | Anything other than certain means the order’s state could not be confirmed. state is unknown in that case. |
contract | The contract the order is in: its event, label, question and lifecycle. See Contract. |
Contract
Every order carriescontract, read from the event catalogue, so you can show an order without looking its symbol up:
| Field | Description |
|---|---|
eventId | The event the contract belongs to. Use it to group orders and to link to the event. |
eventDisplayName | The event’s title, for cards and order details. |
description | The contract’s short label within its event, such as Republican or Shelley Moore Capito. |
question | The contract’s full question. |
state | ACTIVE while the contract trades, CLOSED once trading has ended and the result is not yet known, SETTLED once it is, and DELETED if the venue withdrew it. A contract never leaves CLOSED or SETTLED. |
settlementValue | Only once SETTLED: what one YES contract pays, from "0" to "1". One NO contract pays 1 less it. |
resultOutcome | Only once SETTLED: the winning outcome, YES or NO, when settlementValue is "1" or "0". |
settledAt | Only once SETTLED: when the contract settled. |
contract is null when the catalogue does not have the contract, or cannot be read at that moment. The order is returned either way.
"contract": {
"eventId": "HORC_1126",
"eventDisplayName": "US House of Representatives Control November 2026",
"description": "Republican",
"question": "Will the Republican Party win a majority in the United States House of Representatives in the 2026 general election?",
"state": "SETTLED",
"settlementValue": "1",
"resultOutcome": "YES",
"settledAt": "2026-11-04T15:00:00Z"
}
Execution reports
Each entry indata.reports is one venue report. For a fill, lastQty and lastPx give the quantity and price of that fill. bustedAt is set if the venue later cancelled the trade.
{
"success": true,
"data": {
"order": {
"orderId": "0b9f3c2e-5d6a-4f1b-8e7c-9a0d1e2f3a4b",
"accountId": "ACCOUNT-0001",
"clientOrderRef": "7d1c8e0a-4b8f-4e3a-9f43-2a6b1d0c9e11",
"symbol": "HORC_1126_Republican",
"contract": {
"eventId": "HORC_1126",
"eventDisplayName": "US House of Representatives Control November 2026",
"description": "Republican",
"question": "Will the Republican Party win a majority in the United States House of Representatives in the 2026 general election?",
"state": "ACTIVE"
},
"outcome": "YES",
"side": "buy",
"orderType": "limit",
"timeInForce": "day",
"quantity": "10",
"price": "0.54",
"workingQuantity": "10",
"workingPrice": "0.54",
"state": "filled",
"cumQty": "10",
"leavesQty": "0",
"avgPx": "0.54",
"certainty": "certain",
"createdAt": "2026-10-08T14:02:11.482Z",
"updatedAt": "2026-10-08T14:02:12.031Z"
},
"reports": [
{
"execId": "string",
"execType": "trade",
"status": "filled",
"lastQty": "10",
"lastPx": "0.54",
"cumQty": "10",
"leavesQty": "0",
"avgPx": "0.54",
"transactTime": "2026-10-08T14:02:12.018Z"
}
]
}
}
History
data.events has one entry per change to the order, in version order. kind says what happened:
| Kind | Meaning |
|---|---|
placed, not_sent | You placed the order, or it never reached the venue. |
replace_requested, cancel_requested | A user asked to amend or cancel. requestedBy is that user, and the amend’s terms are on the event. |
request_withdrawn | The amend or cancel never reached the venue. |
acknowledged, replaced, canceled, expired, rejected, trade | The venue’s answer. execId and transactTime are the venue’s. |
replace_rejected, cancel_rejected, business_rejected | The venue refused the request. text is its reason, and the order keeps working. |
massCancelId. An event with applied false is a venue report the order recorded without changing, for example a fill reported after the order was already closed.
"events": [
{ "version": 1, "kind": "placed", "applied": true, "requestedBy": "user-1", "quantity": "10", "price": "0.54", "occurredAt": "2026-10-08T14:02:11.482Z" },
{ "version": 2, "kind": "acknowledged", "applied": true, "execId": "1HPT7DPFMC5KW", "occurredAt": "2026-10-08T14:02:11.497Z" },
{ "version": 3, "kind": "cancel_requested", "applied": true, "requestedBy": "user-2", "occurredAt": "2026-10-08T14:05:40.120Z" },
{ "version": 4, "kind": "canceled", "applied": true, "execId": "1HPT7DPFMC5LA", "occurredAt": "2026-10-08T14:05:40.131Z" }
]
Example
curl -X GET "https://api.tradearies.dev/v1/predictions/orders/0b9f3c2e-5d6a-4f1b-8e7c-9a0d1e2f3a4b?accountId=ACCOUNT-0001" \
-H "Authorization: Bearer $ACCESS_TOKEN"
Errors
| Status | code | Meaning |
|---|---|---|
401 | — | Missing or invalid credentials. |
400 | INVALID_ORDER | accountId is missing. |
404 | ORDER_NOT_FOUND | No such order on accountId. A malformed orderId returns the same 404. |
500 | ORDER_REQUEST_FAILED | Unexpected server error. |
Authorizations
OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.
Path Parameters
orderId returned by Place Prediction Order or List Prediction Orders.
Query Parameters
The account the order is on.
Was this page helpful?