boursorama.com APIboursorama.com ↗
Access real-time French stock prices, CAC 40 data, forex rates, commodity prices, and historical OHLCV candles from Boursorama via a single API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/90d33d56-60a4-4ea2-8f5d-7eb28c3ef99d/get_cac40_price' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the current CAC 40 index price including open, high, low, volume, and timestamp.
No input parameters required.
{
"type": "object",
"fields": {
"low": "number, daily low",
"high": "number, daily high",
"name": "string, index name",
"open": "number, opening price",
"price": "number, current price in points",
"symbol": "string, Boursorama symbol",
"volume": "integer, trading volume",
"timestamp": "integer, Boursorama internal day offset"
},
"sample": {
"data": {
"low": 8131.53,
"high": 8344.89,
"name": "CAC 40",
"open": 8134.95,
"price": 8299.42,
"symbol": "1rPCAC",
"volume": 6164,
"timestamp": 20579
},
"status": "success"
}
}About the boursorama.com API
The Boursorama API covers 8 endpoints that return real-time and historical financial data from France's largest retail brokerage portal. You can fetch current prices for stocks, indices, forex pairs, and commodities, pull intraday or daily OHLCV candle arrays via get_stock_ticks_intraday and get_stock_ticks_daily, search instruments by name or ISIN, and retrieve SBF 120 market movers — all using Boursorama's native symbol identifiers.
Instruments and Symbol Discovery
All price and tick endpoints take a symbol parameter using Boursorama's internal notation (e.g., 1rPTTE for TotalEnergies, 1rPCAC for the CAC 40, 1xEURUS for EUR/USD, 8xBRN for Brent Crude). The search_instrument endpoint accepts a plain-language name or a full ISIN (e.g., FR0000120271) and returns an array of matching instruments, each with name, symbol, type, market, and url fields — making it the natural starting point for discovering symbols before calling any other endpoint.
Real-Time Prices and Market Movers
The get_stock_price endpoint returns open, high, low, price, volume, currency, and a timestamp field representing a Boursorama internal day offset. The dedicated get_cac40_price endpoint exposes the same fields for the CAC 40 index without requiring a symbol parameter. get_forex_rate uses the same response shape; note that volume is often 0 for forex instruments and currency may return an empty string. get_market_movers returns the top gainers from the SBF 120 palmares as an array of objects containing name, symbol, last (price as a string), and change_pct (percentage change as a string), sorted by percentage change descending.
Historical OHLCV Data
Two tick endpoints cover different time resolutions. get_stock_ticks_intraday (period 0) and get_stock_ticks_daily (period 1) both return a QuoteTab array of candle objects keyed as d (day offset), o (open), h (high), l (low), c (close), and v (volume), plus Name, SymbolId, and Xperiod at the envelope level. The length parameter controls how many candles are returned. For get_stock_ticks_intraday, some symbols require a minimum length of 20–30 before the endpoint returns data; 30 is the recommended safe default.
Coverage Notes
Commodity support is verified for Brent Crude (8xBRN) and Gold (_GC). Other commodity symbols can be discovered via search_instrument but availability is not guaranteed. Forex coverage is confirmed for EUR/USD (1xEURUS); other pairs should be verified individually through the search endpoint before building dependent workflows.
- Monitor real-time CAC 40 index levels using get_cac40_price for a dashboard or alert system.
- Build a French equities screener by combining search_instrument (ISIN lookup) with get_stock_price for live quotes.
- Feed daily OHLCV candles from get_stock_ticks_daily into a backtesting engine for SBF 120 constituents.
- Track intraday price action for individual French stocks using get_stock_ticks_intraday with a length of 30.
- Display top-gaining SBF 120 stocks in a market summary widget using get_market_movers.
- Retrieve EUR/USD exchange rates via get_forex_rate to support currency conversion in a financial application.
- Pull Brent Crude and Gold prices using get_commodity_price to monitor energy and precious metal exposure alongside equities.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Boursorama offer an official public developer API?+
What does the `timestamp` field returned by price endpoints represent?+
timestamp field is a Boursorama internal day offset integer, not a Unix timestamp or ISO date string. It is consistent across endpoints but requires mapping to a calendar date if you need human-readable time values.Does get_stock_ticks_intraday return true intraday (minute-level) candles?+
QuoteTab field, but the granularity behaves as daily candles for the requested length rather than sub-daily bars. If true minute-level tick data is required, the current API does not expose that resolution. You can fork this API on Parse and revise it to add a finer-grained tick endpoint if Boursorama exposes one for the symbols you need.Does the API cover non-French markets such as US equities, German stocks, or Asian indices?+
Is historical data available beyond what the `length` parameter controls?+
length parameter on get_stock_ticks_daily and get_stock_ticks_intraday determines how many candles are returned, but the API does not expose a date-range filter or pagination — you cannot request candles starting from a specific date. The maximum retrievable history depth depends on what Boursorama makes available for a given symbol. You can fork this API on Parse and revise it to add date-based filtering if that capability is needed.