# Boursorama — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/boursorama/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/boursorama/get-cac40-price \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/boursorama/get-commodity-price \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/boursorama/get-forex-rate \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/boursorama/get-market-movers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/boursorama/get-stock-price \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/boursorama/get-stock-ticks-daily \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/boursorama/get-stock-ticks-intraday \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/boursorama/search-instrument \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.