Skip to main content
GET
/
v1
/
marketdata
/
search
Search Symbols
curl --request GET \
  --url https://api.tradearies.dev/v1/marketdata/search \
  --header 'Authorization: Bearer <token>' \
  --header 'X-API-Key: <api-key>'
[
  {
    "symbol": "AAPL",
    "description": "Apple Inc.",
    "tag": "technology",
    "type": "stock"
  },
  {
    "symbol": "AAPLW",
    "description": "Apple Inc. Warrant",
    "tag": "warrant",
    "type": "warrant"
  }
]

​
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.tradearies.dev/v1/marketdata/search?query=AAPL" \
  -H "X-API-Key: your-api-key" \
  -H "Authorization: Bearer your-token"

curl -X GET "https://api.tradearies.dev/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

​
X-API-Key
string
header
required
​
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. Use '.' prefix for options search (e.g., '.AAPL')

Minimum length: 1
​
limit
integer
default:20

Maximum number of results to return

Required range: 1 <= x <= 100

Response

Search results retrieved successfully

​
symbol
string

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

​
description
string

Company or security description

​
tag
string

Category tag for the symbol

​
type
string

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

⌘I