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>'
[
  {
    "description": "<string>",
    "symbol": "<string>",
    "tag": "<string>",
    "type": "<string>"
  }
]

​
Overview

The symbol search endpoint allows you to find trading symbols across different asset classes including stocks, ETFs, and options. The endpoint supports both equity and options search with intelligent filtering.

​
Search Types

Search for stocks, ETFs, and other equity securities by providing the symbol or company name: 
GET /v1/marketdata/search?query=AAPL&limit=10
Search for options by prefixing your query with a dot (.): 
GET /v1/marketdata/search?query=.AAPL&limit=20

​
Query Parameters

ParameterTypeRequiredDescription
querystringYesSearch term. Use . prefix for options
limitintegerNoMax results (1-100, default: 20)

​
Response Format

The endpoint returns an array of search results with the following structure: 
[
  {
    "symbol": "AAPL",
    "description": "Apple Inc.",
    "tag": "technology",
    "type": "stock"
  }
]

​
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 specific symbols for exact matches
  • Partial company names work for broader searches
  • Options search with . prefix provides comprehensive option chain results
  • Limit parameter helps control response size for better performance

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
query
string
required

Search query (required). Prefix with '.' for options, '/' for futures.

Minimum string length: 1
​
limit
integer
default:20

Maximum number of results (optional). Default 20, min 1, max 100.

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

Category tag for the symbol

​
type
string

Security type (stock, option, index, etc.)