Get prediction order
curl --request GET \
--url https://api.tradearies.dev/v1/predictions/orders/{orderId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.tradearies.dev/v1/predictions/orders/{orderId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.tradearies.dev/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.tradearies.dev/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.tradearies.dev/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.tradearies.dev/v1/predictions/orders/{orderId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tradearies.dev/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",
"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",
"price": "0.54",
"rejectReason": "<string>",
"rejectText": "<string>",
"sentAt": "2023-11-07T05:31:56Z",
"stopPx": "0.50",
"venueOrderId": "<string>",
"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>"
}
]
}
}Orders
Get Prediction Order
Returns one of the authenticated user’s prediction-market orders together with every venue execution report against it.
Use Case: Read the venue’s answer to an order after placing it: acknowledgement, rejection reason, or fills.
GET
/
v1
/
predictions
/
orders
/
{orderId}
Get prediction order
curl --request GET \
--url https://api.tradearies.dev/v1/predictions/orders/{orderId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.tradearies.dev/v1/predictions/orders/{orderId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.tradearies.dev/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.tradearies.dev/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.tradearies.dev/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.tradearies.dev/v1/predictions/orders/{orderId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tradearies.dev/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",
"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",
"price": "0.54",
"rejectReason": "<string>",
"rejectText": "<string>",
"sentAt": "2023-11-07T05:31:56Z",
"stopPx": "0.50",
"venueOrderId": "<string>",
"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>"
}
]
}
}This endpoint is in closed beta. It is available only to accounts enrolled in the beta, and only on staging (
https://api.tradearies.dev). Request and response shapes may change before general availability.Overview
Place Prediction Order returns before the venue answers. Use the returnedorderId here to see what happened. data.order is the order’s current state, and data.reports lists every venue execution report against it. Both are read from one snapshot, so they agree.
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. |
certainty, certaintyReason | Anything other than certain means the order’s state could not be confirmed. state is unknown in that case. |
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",
"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"
}
]
}
}
Example
curl -X GET "https://api.tradearies.dev/v1/predictions/orders/0b9f3c2e-5d6a-4f1b-8e7c-9a0d1e2f3a4b" \
-H "Authorization: Bearer $ACCESS_TOKEN"
Errors
| Status | code | Meaning |
|---|---|---|
401 | — | Missing or invalid credentials. |
404 | ORDER_NOT_FOUND | No such order. An order placed by another user, or 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.
FlowAuthorization Code
- Authorization URL
- https://app.aries.com/oauth2/authorize
- Token URL
- https://api.aries.com/v1/oauth2/token
- Refresh URL
- https://api.aries.com/v1/oauth2/token
FlowClient Credentials
- Token URL
- https://api.aries.com/v1/oauth2/token
- Refresh URL
- https://api.aries.com/v1/oauth2/token
Path Parameters
orderId returned by Place Prediction Order or List Prediction Orders.
Was this page helpful?