Bavest QuantOS
QuantOS Performance Chart
/v2/quant-os/chartGenerate performance chart data for a portfolio over a date range.
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
This route takes no path or query parameters.
Request body
JSON, required. Symbols, weights, and date range for analysis.
Draft from the schema. Review and fill in required fields before sending.
portfolioItems- array of object
- required
Portfolio positions with symbol, allocation weight, and purchase date
4 fields in portfolioItems
symbol- string
- required
Ticker symbol
Example:
AAPLweight- number
- required
Allocation weight (all weights must sum to 1.0)
Example:
0.4buyDate- string (date)
- required
Purchase date (YYYY-MM-DD).
Example:
2026-09-01amount- number
Number of shares held
startDate- string (date)
Analysis start date (YYYY-MM-DD)
Example:
2026-09-01endDate- string (date)
Analysis end date (YYYY-MM-DD)
Example:
2026-09-30currency- string
Target currency for valuation (ISO 4217)
Example:
USDresolution- string
Data resolution for time series
One of
D,W,M.Example:
D
Response 200
Successful response · application/json
data- QuantOSChart
Total portfolio performance chart as a candle series.
2 fields in data
t- array of number
Unix timestamps (seconds)
c- array of number
Closing values at each timestamp
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.

