Skip to main content
GET
/
v2
/
accounts
/
{id}
/
orders
/
history
List order history (v2)
curl --request GET \
  --url https://api.aries.com/v2/accounts/{id}/orders/history \
  --header 'Authorization: Bearer <token>'
{
  "orders": [
    {
      "clOrdId": "clord-20260310-msft-001",
      "ordId": "ord-hist-0001",
      "accountId": "TEST-ACCOUNT-001",
      "clientId": "demo-oauth-client",
      "symbol": "MSFT",
      "side": "SELL",
      "type": "LIMIT",
      "timeInForce": "DAY",
      "qty": "10",
      "price": "410.00",
      "stopPrice": "",
      "ordStatus": "FILLED",
      "cumQty": "10",
      "leavesQty": "0",
      "avgPrice": "410.25",
      "currency": "USD",
      "exDestination": "NASDAQ",
      "text": "",
      "ordRejReason": "",
      "securityType": "EQUITY",
      "category": "SINGLE_LEG",
      "legs": [],
      "createdAt": "2026-03-10T15:00:00Z",
      "updatedAt": "2026-03-10T15:00:12Z"
    }
  ],
  "nextCursor": 0
}

Documentation Index

Fetch the complete documentation index at: https://finance.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Prerequisites

You must pass from (RFC 3339 with timezone). If you omit to, the service uses the current time truncated to the minute (UTC) and caps the span at 90 days from from.

​
Pagination and sorting

Use the same cursor / nextCursor contract as List active orders (v2): start with cursor=0, then pass the last nextCursor until it returns 0. Sorting is by order_created_at; set order_by to asc or desc (default desc).

​
Demo response

Same envelope as active orders — orders plus nextCursor. Each order matches the v2 domain shape so it aligns with WebSocket and cache-backed reads. 
{
  "orders": [
    {
      "clOrdId": "clord-20260310-msft-001",
      "ordId": "ord-hist-0001",
      "accountId": "TEST-ACCOUNT-001",
      "clientId": "demo-oauth-client",
      "symbol": "MSFT",
      "side": "SELL",
      "type": "LIMIT",
      "timeInForce": "DAY",
      "qty": "10",
      "price": "410.00",
      "stopPrice": "",
      "ordStatus": "FILLED",
      "cumQty": "10",
      "leavesQty": "0",
      "avgPrice": "410.25",
      "currency": "USD",
      "exDestination": "NASDAQ",
      "text": "",
      "ordRejReason": "",
      "securityType": "EQUITY",
      "category": "SINGLE_LEG",
      "legs": [],
      "createdAt": "2026-03-10T15:00:00Z",
      "updatedAt": "2026-03-10T15:00:12Z"
    }
  ],
  "nextCursor": 0
}

Authorizations

​
Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Path Parameters

​
id
string
required

Account ID

Query Parameters

​
from
string<date-time>
required

Inclusive lower bound on order_created_at. RFC 3339 with timezone (for example 2026-04-01T00:00:00Z).

​
to
string<date-time>

Inclusive upper bound. Defaults to current time truncated to the minute (UTC). Combined range from from is capped at 90 days.

​
order_by
enum<string>
default:desc

Sort direction by order_created_at.

Available options:
asc,
desc
​
exclude_today
boolean
default:false

When true, caps to at just before midnight ET so intraday activity is omitted from this history response.

​
limit
integer
default:50

Page size. Default 50; server maximum 500.

Required range: 1 <= x <= 500
​
cursor
integer<int64>
default:0

Opaque pagination cursor for DB keyset walk. Pass 0 for the first page.

Response

Page of historical orders

Paginated v2 orders response from GET /v2/accounts/{id}/orders and GET /v2/accounts/{id}/orders/history (trade-xh-svc).

​
orders
object[]
required

Orders in v2 domain shape

​
nextCursor
integer<int64>
required

Pass as cursor on the next request. Value 0 means this page is the last.