Skip to main content

Recent Updates

Order Leg Ticker Symbol
Order responses now include tickerSymbol on each leg. For an option leg it is the full OCC contract symbol, for example AAPL261023C00340000. Equity legs carry the plain symbol. The field is omitted on orders stored before it existed.Summary of changes by endpoint:
Earnings Calendar Market Cap
The Earnings Calendar’s marketCap is now a decimal in millions of dollars, rounded to four decimal places, instead of an integer. When no provided market cap is available, it is calculated as sharesOutstanding × lastPrice. The field is omitted when neither source is available.Summary of changes by endpoint:
Bid and Ask Sizes on Quotes
The Quotes endpoint now returns the size at the bid and at the ask.Summary of changes by endpoint:
Account Balance v2 Withdrawable Cash
The Account Balance (v2) endpoint no longer returns fundsAvailableForWithdrawal. amountAvailableToWithdraw is the cash available to withdraw.Summary of changes by endpoint:
Account Balance v2 Fields by Account Type
The Account Balance (v2) endpoint now returns cashBalance only for cash accounts and intradayMarginBalance only for margin accounts. Before, both were returned for every account.Summary of changes by endpoint:
No Bid Events on asks=true Streams
A live price stream opened with asks=true no longer sends bid events, because its ask events already carry the best bid and ask that a new bid moves. Streams without asks=true are unchanged.Summary of changes by endpoint:
Best Bids on the Live Price Stream
With asks=true, the live price stream now carries each outcome’s best bid beside its best ask, and sends ask events only when a price moves. Streams without asks=true are unchanged.Summary of changes by endpoint:
Best Asks on the Live Price Stream
The live price stream can show what each outcome can be bought at now. It is opt-in: without the new parameter, the stream is unchanged.Summary of changes by endpoint:
Search Sort Order; Conditional Contracts Hidden; Partial Live Streams
Search takes a sortBy, and its default order is now by symbol rather than open interest. Contracts under the venue’s Conditional category are no longer served. A live price stream that names one now streams everything else and reports it in an unavailable event, rather than refusing the whole request.Summary of changes by endpoint:
Pagination and Validation Fixes
Paging errors now return the documented status codes, the last page of paged responses omits the cursor, and stocks/aggs pagination advances correctly.Summary of changes by endpoint:
Candidate Party, Front Runner and Incumbent; Election Map Leader
Election contracts now carry the venue’s candidate metadata: party, whether the candidate is still in the race, whether they hold the seat, and FEC status. The election map uses it to colour every race by its leader, shows which party holds each seat, and hides candidates no longer in the race. Available on staging.Summary of changes by endpoint:
Candidate Photos on Search Results
Every contract in search results now carries photo, the same candidate portrait the event-contracts and base-event responses return. Available on staging.Summary of changes by endpoint:
Candidate Photos on Event Contracts and Base Events
Every contract in the event-contracts and base-event responses now carries photo: the candidate’s portrait on an election contract that has one, the same one the election map returns. Available on staging.Summary of changes by endpoint:
Election Map
Added an endpoint that returns every 2026 Senate, House and governor race in all 50 states, with each candidate’s price, plus the chamber-control markets, in one response. Available on staging.Summary of changes by endpoint:
Order Ownership Check on Cancel and Replace Order
Cancel and replace now check that origClOrdId is an order on accountId before anything is sent to the broker.Summary of changes by endpoint:
Contract Info on Prediction Orders and Positions
Every prediction-market order and position now carries contract: the event it belongs to, a readable label and the question, and the contract’s lifecycle, including its result once settled. Clients no longer need to look a symbol up to show it.Summary of changes by endpoint:
Replace, Cancel and Mass Cancel Prediction Orders; Order History
Added endpoints to amend and cancel prediction-market orders, to cancel every working order on an account in one request, and to read an order’s full history. Orders belong to an account: every order endpoint names accountId, and reads cover every order on it, whoever placed it. The default order list is now the current trading day, and older orders have their own paged endpoint.Summary of changes by endpoint:
Get User Info
Added an endpoint that returns the authenticated user’s ID and current email address.Summary of changes by endpoint:
Prediction Order Stream
Added a server-sent-events stream of one account’s prediction-market orders, and a version on every order.Summary of changes by endpoint:
Removed clientId from Place and Replace Order
The place-order and replace-order requests no longer accept clientId.Summary of changes by endpoint:
Prediction Search Ranked by Open Interest
Search now ranks by open interest, and event and base-event hits carry their most-held contracts, so you can list an event’s top contracts without a second call.Summary of changes by endpoint:
Pagination and Parameter Corrections
The reference now matches what these endpoints return and accept. The API itself hasn’t changed.Summary of changes by endpoint:
Deprecated account:information for Positions
The account:information scope is deprecated for Account Positions. Request position:information instead.Summary of changes by endpoint:
Prediction Order Idempotency Key
Place Prediction Order now takes an Idempotency-Key header for safe retries. clientOrderRef is no longer a retry key.Summary of changes by endpoint:
Prediction Live Prices Stream
Added a server-sent-events stream of live prediction-market prices, bids, and trades.Summary of changes by endpoint:Release date: October 9, 2026
Prediction Categories
Added a categories endpoint for the prediction market, and a category filter on search.Summary of changes by endpoint:Release date: October 9, 2026
Prediction Base Event Names and Categories
Get Base Event now returns the venue’s display name and categories for each base event.Summary of changes by endpoint:Release date: October 8, 2026
Prediction Market Orders (Closed Beta)
Added three prediction-market order endpoints in closed beta. They are available only to accounts enrolled in the beta, only on staging (https://api.tradearies.dev), and require an authenticated user. Request and response shapes may change before general availability.Summary of changes by endpoint:
Watchlist Endpoints
Added five watchlist endpoints under two new OAuth2 scopes, watchlist:information (read) and watchlist:management (write), and moved the existing Delete Watchlist endpoint onto watchlist:management.Summary of changes by endpoint:Release date: October 1, 2026
Market Data Error Codes, Resolution Validation, and Equity Timestamps
Company endpoints now return 404 for symbols with no data instead of an empty 200, and malformed query parameters on ETF, earnings surprise, and technical analysis endpoints now return 400 instead of 500. Technical analysis endpoints now validate resolution against a smaller set of values. Equity details timestamps are now RFC 3339.Summary of changes by endpoint:Release date: October 1, 2026
Account WebSocket Snapshot Fields
Documented the additional account and position fields returned in the account topic’s initial snapshot, and removed the legacy orders array from the snapshot contract.Summary of changes by endpoint:
Scope Changes and Request/Response Updates
Deprecated GET /v1/accounts/{id}/balances in favor of GET /v2/accounts/{id}/balance. Changed the required scope on Analytics, Options, and Accounts endpoints, and updated request and response contracts across Orders, OAuth2, Chart, Stocks, Options, Accounts, and other sections.Summary of changes by endpoint:Release date: September 28, 2026
Prediction Market Response Trimming
Prediction responses now carry only the level that was asked for. These are breaking changes to three endpoints; no endpoint was added or removed.Summary of changes by endpoint:Release date: September 28, 2026
Prediction Market API
Added the Prediction API: five endpoints covering prediction-market historical ticks, reference data, and full-text search. The catalogue is organized as base event → event → contract, and a contract’s symbol is the key shared across every endpoint. None of these routes requires an API key or bearer token. Each endpoint offers a server dropdown for https://api.aries.com (production) and https://api.tradearies.dev (staging); this selector applies to the prediction endpoints only. No existing endpoint changed.These replace the prediction-market endpoints documented before May 2026, which used the retired product / instrument vocabulary: GET /v1/predictions/events/\{eventId\}/instruments and GET /v1/predictions/products/\{productId\} are gone and now return 404.Summary of changes by endpoint:Release date: September 27, 2026
Account Balance v2 Withdrawable Cash and Margin Fields
Added six response fields to the Account Balance (v2) endpoint covering withdrawable cash and the intraday margin balance. No existing field changed.Summary of changes by endpoint:Release date: September 17, 2026
Easy-to-Borrow Endpoints
Added two endpoints exposing today’s easy-to-borrow (ETB) list — the complete set of US equities that can be sold short without first locating shares. Membership in the list is the whole signal: a symbol on the list is easy to borrow, and a symbol absent from it is hard to borrow. Neither endpoint is account-scoped. No existing endpoint changed.Summary of changes by endpoint:Release date: August 25, 2026
Economics and Earnings Calendar Updates
Added support for date-range queries on the Economics Calendar endpoint, and new time and importance fields on the Earnings Calendar endpoint.Summary of changes by endpoint:
Tick-Based Chart Data Endpoint
Added a new endpoint for tick-based chart bars — candles that close every N trades instead of every N minutes, useful for visualizing market activity on fast-moving symbols. Historical Bars no longer accepts tick resolutions; it previously served them silently as 1-minute bars.Summary of changes by endpoint:Release date: July 27, 2026
Market Data WebSocket Fundamental Quote Fields
Documented fundamental and reference fields that the market data WebSocket accepts in quoteFields and returns from the symbol snapshot. These were already supported by the backend but previously undocumented.Summary of changes by endpoint:
Account Balance v2 and Positions Fields
Documented additional response fields now returned by the Account Balance (v2) and Account Positions endpoints.Summary of changes by endpoint:
Account Positions and Balance v2
Removed the availability block from the Account Positions response and added a v2 Account Balance endpoint.Summary of changes by endpoint:
Streaming API Watchlist Merge Alignment
Updated the Streaming API documentation to match the backend account WebSocket contract. Watchlist streaming is now documented only under the account WebSocket, and the watchlist request and response examples now reflect the backend’s full-watchlist snapshot and full-watchlist event payloads.Summary of changes by endpoint:
Account Positions P&L Fields
Aligned the Account Positions response P&L fields with the live API.Summary of changes by endpoint:
Single-Ticker Query Parameter Rename
Renamed the single-symbol query parameter from tickers to ticker on six endpoints. The multi-symbol parameter tickersAnyOf is unchanged. This is a breaking change for callers that sent ?tickers=AAPL — switch to ?ticker=AAPL.Summary of changes by endpoint:
Account Positions Availability Source
Corrected the availability.source response field for the Account Positions endpoint to match the live API.Summary of changes by endpoint:
Calendar and Options Request Contract Updates
Documentation updated for current public request-contract changes reflected in the backend.Summary of changes by endpoint:
Sort Parameter Input Alignment
Corrected sort parameter documentation across the API reference so Mintlify renders text inputs for sort instead of enum/default selectors.Summary of changes by endpoint:
Orders, Watchlist, Indices, and Options Changes
Request and response field changes across Orders, Watchlist, Indices, and Options endpoints.Summary of changes by endpoint:
Market Exchange Codes and v2 Orders Schema Alignment
Documented supported market exchange query values and aligned v2 orders schemas and companion pages with the trading API.Summary of changes by endpoint:
API Response Documentation Fixes
Corrected documented response schemas and examples to match current API payloads.Summary of changes by endpoint:
v2 Orders API Documentation Updates
Added v2 account orders endpoint documentation and clarified request/response contracts for active and historical order retrieval.Summary of changes by endpoint:
API Request/Response Documentation Fixes
Documentation was updated to match current backend query validation, public endpoint auth behavior, and response shapes.Summary of changes by endpoint:
API Request/Response Documentation Updates
Request and response docs were updated to align endpoint contracts with live API behavior.Summary of changes by endpoint:
API Request/Response Updates
Request and response docs were aligned to live API payloads across Accounts, Financials, Market Data, Orders, and Options. This update also adds the new option snapshot endpoints and broadens documented error response coverage.Summary of changes by endpoint:Updated on: April 13, 2026
API Documentation Updates
Critical endpoint corrections and response schema updates to align documentation with the API.Summary of changes by endpoint:Breaking Changes:
  • /v1/analyst/insights → /v1/analytics/insights (path correction)
  • /v1/stock/dividend2 removed (use /v1/corporate-actions/dividends)
  • /v1/news response: articles → news array
Release date: February 16, 2026
API & Documentation
API and documentation updates: response renames for stock estimates and earnings, Fundamentals and Watchlist schema changes, Analytics ratings and equity details, order and OAuth schema changes, and WebSocket docs and endpoints.Summary of changes by endpoint:For stock estimate endpoints, the array remains under *.data; symbol and freq stay in the same wrapper. For earnings, the root value is the array: { "earningSurprises": [ ... ] }. Docs and API use /v1/oauth2/... (not /oauth/...).Release date: February 6, 2025
Documentation
Added official SDK documentation for Python, Go, and JavaScript. Each SDK includes installation instructions, authentication setup, and complete API references.What’s included:
  • Quick Start Guides - Get started with code examples for placing orders, checking balances, and retrieving market data
  • Authentication - OAuth2 flows with PKCE, MFA support, and automatic token refresh
  • API References - Full documentation for 9 endpoints: Accounts, Orders, Users, Analytics, Market Data, Watchlist, Chart, News & Calendars, and Settings
  • Code Examples - 30+ examples covering market orders, limit orders, stop losses, bracket strategies, and portfolio management
  • Error Handling - Common error patterns and how to handle them in each language
  • TypeScript Support - Full type definitions for JavaScript/TypeScript users
All three SDKs provide the same functionality with language-specific conventions and idioms.Release date: December 16, 2025
Documentation
Complete documentation overhaul for Fundamentals API with enhanced schemas and real-world examples to streamline integration.Enhanced Documentation Coverage:
  • All 18 Fundamentals API endpoints now include comprehensive request/response examples
  • Added detailed field descriptions for company metrics, financials, and ownership data
  • Included common use cases and filtering patterns for faster implementation
This documentation update makes it significantly easier to integrate company data, financials, and ownership information into trading applications.Release date: December 12, 2025
API Feature Releases
Added WebSocket streaming APIs and supplemental REST endpoints.New WebSocket connections:
  • Market Data WebSocket for quotes, trades, and Level 2 orderbook data across equities, indices, and options
  • TradingView Chart WebSocket for real-time chart data
  • Account Updates WebSocket for order, position, balance, and P&L updates
  • Watchlist WebSocket for live watchlist synchronization
New supplemental endpoints:
  • Market movers: GET /v1/equity/top-gainers, GET /v1/equity/top-losers, GET /v1/equity/top-most-active
  • Sector analysis: GET /v1/equity/sector-tickers, GET /v1/equity/sector-wise-change
  • Options flow: GET /v1/options/stocks/top-volume, GET /v1/options/etfs/top-volume
  • Market indicators: GET /v1/analytics/market-breadth, GET /v1/analytics/net-inflow
  • Calendar, company, ownership, financials, filings, IPO, and dividend endpoints
Release date: December 11, 2025
New Feature
Enhanced market intelligence with calendar events, detailed equity information, and advanced analytics for systematic trading strategies.Calendar Integration:
  • GET /v1/calendars/economics - Track economic events that impact market volatility
  • GET /v1/calendars/earnings - Monitor upcoming earnings with symbol and date filtering
  • GET /v1/calendars/historical/{symbol} - Access historical indicator data for backtesting
Enhanced Market Data:
  • GET /v1/marketdata/equities/details - Batch retrieve detailed equity information for up to 50 symbols in a single request, reducing API calls and improving performance
Analytics Suite:
  • Analyst ratings with filtering by ticker, date range, and importance level
  • Real-time market breadth showing advancers vs. decliners across exchanges
  • Net inflow data for NASDAQ and NYSE to track institutional money flow
These endpoints provide the data foundation for building algorithmic trading strategies and market surveillance tools.Release date: October 27, 2025
New Feature
Initial release of Aries API with OAuth2 authentication, order execution, and account management capabilities for building trading applications.Release date: August 5, 2025