Skip to main content
GET
/
v1
/
marketdata
/
search
Search Symbols
curl --request GET \
  --url https://api.aries.com/v1/marketdata/search \
  --header 'Authorization: Bearer <token>'
[
  {
    "symbol": "AAPL",
    "description": "Apple Inc.",
    "tag": "XNAS",
    "type": "stock"
  },
  {
    "symbol": "AAPL240119C00190000",
    "description": "AAPL Jan 19 2024 190 Call",
    "tag": "OPRA",
    "type": "option"
  }
]

​
Overview

The symbol search endpoint finds symbols across stocks, indices, options, and futures. Only two prefixes change how your query is interpreted: a leading . for options and a leading / for futures. Any other leading character (including !) is treated as normal search text, not as a special prefix.

​
Query syntax (prefixes)

PrefixMeaningExample
(none)Search stocks and indices (combined results).ES, AAPL
.Search options (option-chain style lookup on the text after the dot)..AAPL, .ES
/Search futures (leading slash is stripped for the underlying lookup)./ES
!Not supported as a prefix. !ES is searched like a literal string, not “options only.”—
Short tickers such as ES can match both equities and index-related symbols; .ES and /ES target options vs futures respectively, which is why results and descriptions can differ for what looks like the “same” letters.

​
Search Types

​
Equity and index search (no prefix)

Search stocks and indices by symbol or name. Results can include both asset classes. 
GET /v1/marketdata/search?query=AAPL&limit=10

​
Options search (. prefix)

Prefix with . (not !): 
GET /v1/marketdata/search?query=.AAPL&limit=20

​
Futures search (/ prefix)

Prefix with /: 
GET /v1/marketdata/search?query=/ES&limit=10

​
Query Parameters

ParameterTypeRequiredDescription
querystringYesSearch term. Use . for options and / for futures; see Query syntax.
limitintegerNoMaximum number of results returned (1–100, default 20). The response never contains more than limit items. Unprefixed queries merge stock and index matches, then rank and trim to this cap. Prefer . or / when you want a single asset class without mixing.

​
Response Format

The handler returns a JSON array at the top level (no results object). Each element has symbol, description, tag (exchange or source tag such as XNAS or OPRA), and type (stock, index, option, or future). The sample below matches the OpenAPI example: 
[
  {
    "symbol": "AAPL",
    "description": "Apple Inc.",
    "tag": "XNAS",
    "type": "stock"
  },
  {
    "symbol": "AAPL240119C00190000",
    "description": "AAPL Jan 19 2024 190 Call",
    "tag": "OPRA",
    "type": "option"
  }
]

​
Search Examples

curl -X GET "https://api.aries.com/v1/marketdata/search?query=AAPL" \
  -H "X-API-Key: your-api-key" \
  -H "Authorization: Bearer your-token"

curl -X GET "https://api.aries.com/v1/marketdata/search?query=.AAPL&limit=50" \
  -H "X-API-Key: your-api-key" \
  -H "Authorization: Bearer your-token"

​
Error Handling

The endpoint returns standard HTTP status codes:
  • 200 - Success
  • 400 - Bad request (missing query parameter)
  • 401 - Unauthorized (invalid API key or token)
  • 500 - Internal server error

​
Rate Limits

This endpoint is subject to standard API rate limits. See the main API documentation for current limits.

​
Tips

  • Use . for options and / for futures; do not rely on ! — it is not a documented prefix.
  • Use specific symbols or names for tighter matches; very short queries (for example ES) can return broader mixes of symbols.
  • Options search with a . prefix is for option-chain style discovery; descriptions come from the upstream search provider.
  • Set limit to bound payload size; the API enforces it after merging stock and index results for unprefixed queries.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
query
string
required

Search query (required). Prefix with '.' for options (not '!') and '/' for futures. Other characters (including '!') are literal. Examples: 'AAPL' (stocks/indices), '.AAPL' (options), '/ES' (futures).

Minimum string length: 1
​
limit
integer
default:20

Maximum number of results returned (optional). Default 20, min 1, max 100. The response is capped at this value after merging and ranking (including unprefixed stock+index searches).

Required range: 1 <= x <= 100

Response

Search results retrieved successfully

​
description
string

Company or security description

​
symbol
string

Trading symbol (e.g., AAPL, GOOGL)

​
tag
string

Exchange or source tag (for example XNAS, OPRA, IND_CBOM)

​
type
string

Security class: stock, index, option, or future (see market-rest-xh-svc SymbolType)

Example:
[
  {
    "symbol": "AAPL",
    "description": "Apple Inc.",
    "tag": "XNAS",
    "type": "stock"
  },
  {
    "symbol": "AAPL240119C00190000",
    "description": "AAPL Jan 19 2024 190 Call",
    "tag": "OPRA",
    "type": "option"
  }
]