List Symbols

List symbols for all available instruments with optional pagination.

Attributes

skip

integer

Number of symbols to skip for pagination. Defaults to 0. Symbols are returned in storage order, which is stable between pages.

limit

integer

Maximum number of symbols to return. Defaults to 10, maximum 1000. To list every symbol, page with skip until a page comes back short.

API Request

Example Request with cURL

curl \
--request GET \
--url     'https://guavy.com/api/v2/stocks/instruments/list-symbols?limit=<integer>&skip=<integer>' \
--header 'Authorization: Bearer YOUR-GUAVY-ACCESS-TOKEN' \
--header 'Content-Type: application/json'

This request format works across all modern HTTP clients, including Python requests, JavaScript fetch, and other programming language libraries.

Example Response for `/api/v2/stocks/instruments/list-symbols?limit=4&skip=0`

{
  "symbols": [
    "AAPL",
    "AMGN",
    "AMZN",
    "AXP"
  ]
}

Response Object

symbols

array[string]

An array of instrument symbols.

Token Costs

Each API call consumes tokens from your monthly budget. Endpoints that return richer or deeper data cost more tokens. Historical endpoints scale with the amount of data requested.

You never have to guess how much is left: every metered response carries your balance in x-tokens-* headers: x-tokens-cost (what this call cost), x-tokens-limit / x-tokens-remaining (monthly), and x-tokens-limit-today / x-tokens-remaining-today (daily). The remaining values are net of any credit applied to the same request. A 401 refused at your limit carries them too, with x-tokens-cost at 0 because nothing was charged.

Endpoint	Token Cost
GET /api/v2/stocks/instruments/list-symbols	1
GET /api/v2/stocks/newsroom/get-recent-briefs/:symbol	3 – 8 (scales with limit)
GET /api/v2/stocks/newsroom/search-briefs/:symbol	3 – 8 (scales with limit)
GET /api/v2/stocks/newsroom/get-article/:id	3
GET /api/v2/stocks/sentiment/get-sentiment-history/:symbol	3 – 12 (scales with limit)
GET /api/v2/stocks/technical-analysis/get-price-history/:symbol	2 – 5 (5 for the full series, less with limit, from or to)
GET /api/v2/stocks/technical-analysis/get-indicators/:symbol	8
GET /api/v2/stocks/instruments/scorecard/:symbol	10
GET /api/v2/stocks/trades/get-current-trend/:symbol	3
GET /api/v2/stocks/trades/get-trend-segments/:symbol	5

Account Limits

Each plan includes a monthly token budget: 3,000 for Sandbox, 250,000 for Quant, and 1,000,000 for Pro. Each market has its own budget, and a daily cap as well (500 tokens a day on Sandbox). The monthly budget resets to the full amount on the 1st of the month for an account with no active monthly subscription, or on your subscription's renewal date once its payment clears. Unused base tokens don't carry over. You can top up at any time with a one-time token pack; pack tokens never expire and any unused pack balance rolls forward. If you exceed your budget, the API returns a 401 until the next reset or until you purchase more tokens.

Connection Limits

The Guavy API allows 300 requests per minute per API key, returning 429 above that. We recommend caching responses that don't change frequently to reduce token consumption and improve performance.

Was this helpful?

Get Scorecard