Recent Updates
Critical endpoint corrections and response schema updates to align documentation with backend implementation.Summary of changes by endpoint:
Breaking Changes:
| Endpoint | Section | Change (short & precise) |
|---|---|---|
| GET /v1/analytics/insights | Analytics | Fixed endpoint path typo: /v1/analyst/insights → /v1/analytics/insights (breaking) |
| GET /v1/stock/dividend2 | Corporate Actions | Deprecated - Endpoint removed completely from API and documentation |
| GET /v1/news | News | Request params changed to symbols, topics; response changed from articles to news array (breaking) |
| GET /v1/news/ | News | Added new endpoint to retrieve single news item by ID with newsType query param |
| GET /v1/company/profile | Company | Added 404/500 error responses; updated response example with all fields including masked logo URL |
| GET /v1/users/me | Users | Added response fields: avatar_url, email_verified, primary_phone_number |
/v1/analyst/insights→/v1/analytics/insights(path correction)/v1/stock/dividend2removed (use/v1/corporate-actions/dividends)/v1/newsresponse:articles→newsarray
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
| Endpoint | Section | Change (short & precise) |
|---|---|---|
| GET /v1/stock/revenue-estimate | Stock Estimates | Response root key renamed: data → revenueEstimates (breaking) |
| GET /v1/stock/ebitda-estimate | Stock Estimates | Response root key renamed: data → ebitdaEstimates (breaking) |
| GET /v1/stock/ebit-estimate | Stock Estimates | Response root key renamed: data → ebitEstimates (breaking) |
| GET /v1/stock/eps-estimate | Stock Estimates | Response root key renamed: data → epsEstimates (breaking) |
| GET /v1/stock/earnings | Earnings | Response root key renamed: data → earningSurprises (breaking) |
| GET /v1/financials/reported | Fundamentals | Added accessNumber, freq; from/to now use date format |
| GET /v1/financials/revenue-breakdown | Fundamentals | Removed from and to; only symbol and cik remain |
| GET /v1/financials/statements | Fundamentals | Required: symbol, statement, freq; optional: preliminary; removed from, to |
| POST /v1/watchlist | Watchlist | account_id replaced by user_id (integer) |
| PUT /v1/watchlist | Watchlist | Request/response updated to use user_id |
| GET /v1/watchlist | Watchlist | Response requires user_id and watchlist; symbols minItems removed |
| GET /v1/analytics/ratings | Analytics – Ratings | Added query params: action, analystId, firmId |
| GET /v1/analytics/ratings | Analytics – Ratings | Pagination defaults/max removed; importance min/max removed |
| GET /v1/analytics/ratings | Analytics – Ratings | Schemas switched to snake_case; new Rating & Accuracy fields added |
| GET /v1/analytics/ratings | Analytics – Ratings | GetRatingsResponse now requires ratings |
| GET /v1/marketdata/equities/details | Market Data | Response now requires data and errors; equity fields expanded |
| GET /v1/marketdata/search | Market Data | Added futures search example (query: "/ES") |
| POST /v1/orders | Orders | timeInForce enum extended |
| POST /v1/orders | Orders | exDestination removed from request schema |
| POST /v1/orders/preview | Orders | cost renamed to estimatedCost; added estimatedMargin |
| POST /v1/orders/preview | Orders | Removed reject/warn fields; added warnings and errors arrays |
| POST /v1/oauth2/authorize | OAuth2 | OAuth paths standardized under /v1/oauth2/ |
| POST /v1/oauth2/authorize | OAuth2 | New encrypted password example; response_type enum = code |
| POST /v1/oauth2/authorize/confirm | OAuth2 | Examples include is_mfa and consent_required |
| POST /v1/oauth2/authorize/mfa | OAuth2 | is_mfa appears only on MFA authorize responses |
| wss://api.aries.com/v1/market/ws | WebSockets | Market Data WebSocket endpoint renamed |
| wss://api.aries.com/v1/charts/ws | WebSockets | New Charting WebSocket endpoint |
| /v1/charts/ws | WebSockets | Docs expanded; “Under Development” warning removed |
*.data; symbol and freq stay in the same wrapper. For earnings, the root value is the array: { "earningSurprises": [ ... ] }. Docs and backend use /v1/oauth2/... (not /oauth/...).Release date: February 6, 2025Added 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
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
Real-time WebSocket streaming is now available across all asset types, enabling live data feeds for trading applications.New WebSocket Connections:
- Market Data WebSocket - Stream live quotes, trades, and Level 2 orderbook data with support for
equities,indices, andoptions - TradingView Chart WebSocket - Real-time chart data integration for custom charting solutions
- Account Updates WebSocket - Instant notifications for order fills, position changes, and balance updates
- Watchlist WebSocket - Live synchronization of watchlist changes across devices
- NDJSON message framing for efficient parsing
- Subscription-based model with granular control over data streams
- Available across production, staging, and development environments
Expanded market data capabilities with 32 new supplemental endpoints providing institutional-grade analytics and company intelligence.Analytics Endpoints (11 total):
- 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
- Economic indicators and events to track macro factors affecting markets
- Historical data for backtesting strategies against economic releases
- Earnings announcements with date range filtering by symbol
- Company profiles, executive information, and peer comparisons
- Institutional ownership, insider transactions, and fund holdings
- Financial statements, revenue breakdowns, and reported financials
- SEC filings, IPO calendar, and dividend history
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 volatilityGET /v1/calendars/earnings- Monitor upcoming earnings with symbol and date filteringGET /v1/calendars/historical/{symbol}- Access historical indicator data for backtesting
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
- 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
Initial release of Aries API with OAuth2 authentication, order execution, and account management capabilities for building trading applications.Release date: August 5, 2025