Tools (5)

get_price
get_historical
get_fx_rate
get_crypto_price
report_feedback

get_price

Get the latest market quote for a stock or ETF.

Uses Alpha Vantage (requires ALPHA_VANTAGE_API_KEY env var).

Args:
ticker: Stock ticker symbol (e.g. "AAPL", "TSLA", "SPY").

Returns:
Latest price, open/high/low, volume, previous close, and change %.

Parameter	Type	Required	Description
`ticker`	`string`	required	Stock ticker symbol (e.g. "AAPL", "TSLA", "SPY").

Request Body

{
  "ticker": "example"
}

get_historical

Get historical OHLCV data for a stock or ETF.

Args:
ticker: Stock ticker symbol (e.g. "AAPL", "MSFT").
start: Start date in YYYY-MM-DD format (inclusive).
end: End date in YYYY-MM-DD format (inclusive).
interval: Data interval — "daily", "weekly", or "monthly" (default: "daily").

Returns:
Symbol, interval, count, and list of OHLCV entries (open, high, low, close, volume).

Parameter	Type	Required	Description
`ticker`	`string`	required	Stock ticker symbol (e.g. "AAPL", "MSFT").
`start`	`string`	required	Start date in YYYY-MM-DD format (inclusive).
`end`	`string`	required	End date in YYYY-MM-DD format (inclusive).
`interval`	`string`	optional	Data interval — "daily", "weekly", or "monthly" (default: "daily"). (default: "daily")

Request Body

{
  "ticker": "example",
  "start": "example",
  "end": "example"
}

get_fx_rate

Get the daily exchange rate between two currencies.

Uses ECB reference rates (updated daily ~16:00 CET on business days).
Supports all major currencies. Cross-rates are derived from EUR-based data.

Args:
base: Base currency ISO 4217 code (e.g. "USD", "EUR", "GBP").
quote: Quote currency ISO 4217 code (e.g. "NOK", "JPY", "CHF").

Returns:
Exchange rate (1 base = N quote), with the ECB reference date.

Parameter	Type	Required	Description
`base`	`string`	required	Base currency ISO 4217 code (e.g. "USD", "EUR", "GBP").
`quote`	`string`	required	Quote currency ISO 4217 code (e.g. "NOK", "JPY", "CHF").

Request Body

{
  "base": "example",
  "quote": "example"
}

get_crypto_price

Get the current price and market data for a cryptocurrency.

Accepts common ticker symbols (e.g. "BTC", "ETH", "SOL") or CoinGecko IDs
(e.g. "bitcoin", "ethereum"). Prices are in USD via CoinGecko's free API.

Args:
symbol: Cryptocurrency symbol (e.g. "BTC") or CoinGecko ID (e.g. "bitcoin").

Returns:
Current USD price, market cap, and 24-hour change percentage.

Parameter	Type	Required	Description
`symbol`	`string`	required	Cryptocurrency symbol (e.g. "BTC") or CoinGecko ID (e.g. "bitcoin").

Request Body

{
  "symbol": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/alpha-vantage/get_price" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"ticker": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/alpha-vantage/get_price",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "ticker": "example"
},
)
print(resp.json())