# Boursorama — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track live stock prices, forex rates, and commodity prices from Boursorama, plus search for any financial instrument and analyze intraday or daily price movements. Stay updated on market movers and major indices like the CAC 40 to make informed investment decisions.

**Category:** Finance & Markets | **Website:** [boursorama.com/](https://boursorama.com/) | **Docs:** [parse.bot/marketplace/8ceb5a83-e461-4d4f-8258-a61cf2853311/boursorama-com-api](https://parse.bot/marketplace/8ceb5a83-e461-4d4f-8258-a61cf2853311/boursorama-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-boursorama-com-api-8ceb5a83/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cac40_price

Returns the current CAC 40 index quote including open, high, low, close, volume, and day-offset timestamp. No parameters required — always fetches the CAC 40 (symbol 1rPCAC).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boursorama-com-api-8ceb5a83/get_cac40_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_commodity_price

Returns the current price for a commodity using its Boursorama symbol. Verified symbols: '8xBRN' (Brent Crude Oil), '_GC' (Gold). Discover other commodity symbols via search_instrument.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Boursorama commodity symbol. Verified: '8xBRN' (Brent Crude Oil), '_GC' (Gold). Discover others via search_instrument. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boursorama-com-api-8ceb5a83/get_commodity_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### get_forex_rate

Returns the current exchange rate for a currency pair using Boursorama forex symbols. Verified working symbol: '1xEURUS' (EUR/USD). Other pairs may be discoverable via search_instrument.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Boursorama forex symbol. Verified: '1xEURUS' for EUR/USD. Discover other forex symbols via search_instrument. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boursorama-com-api-8ceb5a83/get_forex_rate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### get_market_movers

Returns the top gainers from the French stock market (SBF 120 palmares), sorted by percentage change descending. Includes a mix of stocks, commodities, and indices from the page footer. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boursorama-com-api-8ceb5a83/get_market_movers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_stock_price

Returns the real-time current quote for any instrument by its Boursorama symbol. Works for stocks, indices, forex pairs, and commodities. Use search_instrument to discover symbols.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Boursorama symbol (e.g., '1rPTTE' for TotalEnergies, '1rPCAC' for CAC 40, '1xEURUS' for EUR/USD). Discover symbols via search_instrument. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boursorama-com-api-8ceb5a83/get_stock_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### get_stock_ticks_daily

Retrieves daily historical OHLCV data (period=1) for any Boursorama instrument. Returns an array of daily candles for the requested number of days.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `length` | integer | No | Number of days of historical data to retrieve. |
| `symbol` | string | Yes | Boursorama symbol (e.g., '1rPCAC', '1rPTTE'). Discover symbols via search_instrument. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boursorama-com-api-8ceb5a83/get_stock_ticks_daily \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"length":"<integer>","symbol":"<string>"}'
```

### get_stock_ticks_intraday

Retrieves short-term OHLCV tick data (period=0) for any Boursorama instrument. Returns an array of daily OHLCV candles for the requested length. Some symbols may require a minimum length of 20-30 to return data successfully.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `length` | integer | No | Number of ticks to retrieve. Minimum effective value varies by symbol; 30 is a safe default. |
| `symbol` | string | Yes | Boursorama symbol (e.g., '1rPCAC', '1rPTTE'). Discover symbols via search_instrument. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boursorama-com-api-8ceb5a83/get_stock_ticks_intraday \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"length":"<integer>","symbol":"<string>"}'
```

### search_instrument

Searches for financial instruments by name or ISIN. Returns matching symbols with metadata including type (Action, ETF, Indice, BND, OPCVM) and market. Results span stocks, indices, ETFs, bonds, and funds from multiple exchanges.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or ISIN (e.g., 'Total', 'LVMH', 'FR0000120271'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boursorama-com-api-8ceb5a83/search_instrument \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```