# Forex — 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.

> Access real-time forex prices and currency exchange rates, track client sentiment and pivot points, and browse economic calendar events. Search across multiple currency instruments and retrieve rollover rates.

**Category:** Finance & Markets | **Website:** [forex.com/](https://forex.com/) | **Docs:** [parse.bot/marketplace/a762f5d0-14ee-4d0a-9461-0a0ff17b4119/forex-com-api](https://parse.bot/marketplace/a762f5d0-14ee-4d0a-9461-0a0ff17b4119/forex-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-forex-com-api-a762f5d0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_client_sentiment

Retrieve real-time client sentiment data showing bullish/bearish percentages and volume percentages for major forex pairs on FOREX.com US.

**Estimated cost:** Metered

_No parameters required._

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

### get_currency_pair_price

Fetch the current indicative price for a specific forex currency pair. Returns bid, offer, spread, and direction. Pair is normalized to space-separated format internally (e.g. 'EUR USD' or 'EUR/USD' both work).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pair` | string | No | Currency pair separated by space or slash (e.g. 'EUR USD', 'GBP/USD', 'USD JPY'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-forex-com-api-a762f5d0/get_currency_pair_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pair":"<string>"}'
```

### get_economic_calendar

Retrieve upcoming economic events from the economic calendar including time, country, event name, volatility level, and actual/consensus/previous values. Returns events for the current trading day.

**Estimated cost:** Metered

_No parameters required._

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

### get_pivot_points

Fetch daily, weekly, and monthly pivot point data (S1-S3, R1-R3) for a specific currency pair using classic pivot point formulas. Returns current bid/offer alongside computed support and resistance levels for each time period.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pair` | string | No | Currency pair separated by space or slash (e.g. 'EUR USD', 'GBP/USD'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-forex-com-api-a762f5d0/get_pivot_points \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pair":"<string>"}'
```

### get_popular_currency_pairs

Retrieve a list of 10 popular/major currency pairs with their current prices, direction, and spread. No parameters needed. Covers EUR/USD, GBP/USD, USD/JPY, AUD/USD, USD/CAD, USD/CHF, NZD/USD, EUR/GBP, EUR/JPY, GBP/JPY.

**Estimated cost:** Metered

_No parameters required._

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

### get_rollover_rates

Fetch overnight rollover/swap rates for major forex instruments. Returns bid and offer rates for each pair.

**Estimated cost:** Metered

_No parameters required._

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

### search_instruments

Search for tradeable forex instruments by currency code or keyword. The search index covers forex pairs available on FOREX.com US. Returns matching instruments with title, description, URL, and type metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword, typically a currency code (e.g. 'EUR', 'USD', 'GBP', 'JPY', 'AUD', 'CAD', 'CHF', 'NZD'). |

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