Skip to main content
GET
/
api
/
v1
/
search
curl -X GET "https://stocks-dev.up.railway.app/api/v1/search?q=apple" \
  -H "X-API-Key: your_api_key"

{
  "bestMatches": [
    {
      "symbol": "AAPL",
      "name": "Apple Inc.",
      "type": "Equity",
      "region": "United States",
      "marketOpen": "09:30",
      "marketClose": "16:00",
      "timezone": "UTC-04",
      "currency": "USD",
      "matchScore": "1.0000"
    },
    {
      "symbol": "APLE",
      "name": "Apple Hospitality REIT, Inc.",
      "type": "Equity",
      "region": "United States",
      "marketOpen": "09:30",
      "marketClose": "16:00",
      "timezone": "UTC-04",
      "currency": "USD",
      "matchScore": "0.8571"
    },
    {
      "symbol": "APLD",
      "name": "Applied Digital Corporation",
      "type": "Equity",
      "region": "United States",
      "marketOpen": "09:30",
      "marketClose": "16:00",
      "timezone": "UTC-04",
      "currency": "USD",
      "matchScore": "0.7500"
    }
  ]
}
Search for financial instruments by company name, symbol, or keywords. This endpoint helps you find the correct ticker symbols for your analysis.

​
Parameters

​
q
string
required
Search query (company name, symbol, or keywords)

​
Response

​
bestMatches
array
Array of search results matching the query
curl -X GET "https://stocks-dev.up.railway.app/api/v1/search?q=apple" \
  -H "X-API-Key: your_api_key"

{
  "bestMatches": [
    {
      "symbol": "AAPL",
      "name": "Apple Inc.",
      "type": "Equity",
      "region": "United States",
      "marketOpen": "09:30",
      "marketClose": "16:00",
      "timezone": "UTC-04",
      "currency": "USD",
      "matchScore": "1.0000"
    },
    {
      "symbol": "APLE",
      "name": "Apple Hospitality REIT, Inc.",
      "type": "Equity",
      "region": "United States",
      "marketOpen": "09:30",
      "marketClose": "16:00",
      "timezone": "UTC-04",
      "currency": "USD",
      "matchScore": "0.8571"
    },
    {
      "symbol": "APLD",
      "name": "Applied Digital Corporation",
      "type": "Equity",
      "region": "United States",
      "marketOpen": "09:30",
      "marketClose": "16:00",
      "timezone": "UTC-04",
      "currency": "USD",
      "matchScore": "0.7500"
    }
  ]
}

​
Search Tips

​
Company Names

Search by full or partial company names:
  • apple → Apple Inc. (AAPL)
  • microsoft → Microsoft Corporation (MSFT)
  • tesla → Tesla, Inc. (TSLA)

​
Ticker Symbols

Search by exact or partial symbols:
  • AAPL → Apple Inc.
  • MSFT → Microsoft Corporation
  • QQQ → Invesco QQQ Trust

​
Keywords

Search by industry or business keywords:
  • electric vehicle → Tesla, Rivian, etc.
  • cloud computing → Amazon, Microsoft, etc.
  • semiconductor → NVIDIA, Intel, AMD, etc.

​
Security Types

  • Equity: Common stocks
  • ETF: Exchange-traded funds
  • Mutual Fund: Mutual funds
  • Index: Market indices
  • Cryptocurrency: Digital assets
  • Forex: Currency pairs
  • Commodity: Commodity futures

​
Use Cases

  • Symbol Lookup: Find correct ticker symbols
  • Company Discovery: Discover companies in specific sectors
  • Investment Research: Explore similar companies
  • Data Validation: Verify symbol accuracy before analysis

​
Data Source

This endpoint uses Alpha Vantage search functionality with comprehensive coverage of global markets.

​
Notes

  • Results are ranked by relevance (matchScore)
  • Search is case-insensitive
  • Supports partial matches for flexible searching
  • Maximum 10 results returned per query
  • Includes both US and international securities