Skip to main content
The instruments endpoints give you structured metadata for any symbol in the StratAlerts universe. Use the list endpoint to search or filter by symbol, then use the detail endpoint when you need a single record by exact ticker. Both endpoints require the metadata:read scope and return the same object shape.

​
GET /instruments

Returns a paginated list of instruments. You can filter by a comma-separated set of symbols, run a prefix/substring search, or simply page through the full universe. GET https://app.stratalerts.com/api/market/v1/instruments
Requires scope: metadata:read

​
Request parameters

​
symbols
string
Comma-separated list of ticker symbols to retrieve. Symbols are normalized to uppercase. Maximum 250. When provided alongside search, only symbols that also match the search string are returned.
​
search
string
Substring filter applied to the symbol field (case-insensitive). Useful for finding symbols when you only know part of the ticker.
​
limit
number
default:"50"
Maximum number of instruments to return. Clamped to the range 1–200.

​
Response fields

​
items
object[]
required
Array of instrument objects.

​
Code examples

curl -G "https://app.stratalerts.com/api/market/v1/instruments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "symbols=AAPL,MSFT,NVDA" \
  --data-urlencode "limit=10"

​
Example response

{
  "items": [
    {
      "symbol": "AAPL",
      "name": "Apple Inc.",
      "market": "stocks",
      "exchange": "NASDAQ",
      "type": "CS",
      "sector": "Information Technology",
      "active": true
    },
    {
      "symbol": "MSFT",
      "name": "Microsoft Corporation",
      "market": "stocks",
      "exchange": "NASDAQ",
      "type": "CS",
      "sector": "Information Technology",
      "active": true
    }
  ]
}

​
GET /instruments/

Returns a single instrument by its exact ticker symbol. The symbol in the path is normalized to uppercase before lookup. GET https://app.stratalerts.com/api/market/v1/instruments/{symbol}
Requires scope: metadata:read

​
Path parameters

​
symbol
string
required
The ticker symbol to look up (e.g., AAPL). Case-insensitive — the server normalizes to uppercase.

​
Response fields

Returns a single instrument object with the same fields as the list response above: symbol, name, market, exchange, type, sector, and active.

​
Code examples

curl "https://app.stratalerts.com/api/market/v1/instruments/AAPL" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Example response

{
  "symbol": "AAPL",
  "name": "Apple Inc.",
  "market": "stocks",
  "exchange": "NASDAQ",
  "type": "CS",
  "sector": "Information Technology",
  "active": true
}

​
Error codes

HTTP statusError codeMeaning
401missing_api_keyNo API key was provided or the key format is invalid.
403inactive_entitlementYour account does not have an active API entitlement.
403missing_scopeYour API key does not have the metadata:read scope.
404unknown_symbolThe requested symbol was not found (detail endpoint only).
Error responses use the following shape: 
{
  "error": {
    "code": "unknown_symbol",
    "message": "unknown symbol"
  }
}