Forex
Forex Quote
/v2/forex/quote/{pair}Returns real-time forex pair quote.
Included in: Growth.
Authentication
Send your API key in the x-api-key header on every request to https://api.bavest.co. The samples read it from the BAVEST_API_KEY environment variable. Get an API key (free trial) · Authentication guide.
Parameters
- stringpath · yes
Currency pair (e.g.,
EURUSD,GBPJPY)Example
EURUSD
Response 200
Successful response · application/json
data- ForexQuote
Real-time forex pair quote.
9 fields in data
symbol- string
- required
Currency pair symbol
Example:
EURUSDprice- number (double)
- required
Current market price
Example:
1.15577change- number (double)
Absolute price change from previous close
Example:
-0.00015changesPercentage- number (double)
Percentage price change from previous close
Example:
-0.01297668dayHigh- number (double)
Highest price during the trading day
Example:
1.15724dayLow- number (double)
Lowest price during the trading day
Example:
1.15476open- number (double)
Opening price for the trading day
Example:
1.1559previousClose- number (double)
Previous trading day closing price
Example:
1.15592timestamp- string (date-time)
Quote timestamp (ISO 8601)
Example:
2026-03-30T11:59:59
meta- ResponseMeta
Response metadata, including server-side processing time and resolved request parameters. Successful and error responses use the same metadata shape.
2 fields in meta
time- integer
Server-side processing time in milliseconds
Example:
17parameters- object
Echo of the request parameters the endpoint resolved
Errors
- 400 Invalid request parameters. Returned when required query parameters are missing, have invalid types, or violate constraints (e.g., providing both symbol and isin when they are mutually exclusive).
- 401 Missing or invalid API key.
- 404 Resource not found.
- 429 Rate limit exceeded. Retry after the `Retry-After` header interval.
- 500 An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.
- 502 Upstream data provider returned an error or is temporarily unavailable. Retry after a short delay.
- 504 The request timed out waiting for a response from the upstream data provider. This may occur for complex queries or during peak load.
- default An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.
403from the gateway: the API key is invalid or switched off.429with messageLimit Exceeded: the monthly quota of the key is used up. WithToo Many Requests: the key is throttled, or this route is not in the key's plan. Wait forRetry-Afterwhen it is sent.

