# Forexfactory — 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 economic calendar events, market quotes, and financial news from ForexFactory to stay informed on forex market movements and trading opportunities. Retrieve detailed event information, market overviews, and forum discussions to enhance your trading decisions and market analysis.

**Category:** Finance & Markets | **Website:** [forexfactory.com/](https://forexfactory.com/) | **Docs:** [parse.bot/marketplace/51d6a4a2-b821-47d6-a943-47015b35e73f/forexfactory-com-api](https://parse.bot/marketplace/51d6a4a2-b821-47d6-a943-47015b35e73f/forexfactory-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-forexfactory-com-api-51d6a4a2/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_calendar

Fetch economic calendar events for a specific week or the current week. Returns all scheduled events with date, time, currency, impact level, country, and actual/forecast/previous values. Events are grouped by day and include IDs usable with get_event_detail for historical data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `week` | string | No | Week start date in 'monDD.YYYY' format (e.g. 'jun09.2026'). If omitted, returns current week's events. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-forexfactory-com-api-51d6a4a2/get_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"week":"<string>"}'
```

### get_calendar_filtered

Fetch calendar events filtered by impact levels and/or currencies. Applies client-side filtering over the full calendar week. Optionally converts event times to a specified IANA timezone. The event_time_utc field is derived from the source's machine-readable UTC timestamp (dateline). The display time field is converted from event_time_utc to the requested timezone.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currencies` | string | No | Comma-separated currency codes to include (e.g. 'USD,EUR,GBP'). |
| `impact_levels` | string | No | Comma-separated impact levels to include: 'high', 'medium', 'low', 'holiday'. |
| `timezone` | string | No | IANA timezone name (e.g. 'America/New_York', 'Europe/London'). When supplied, the time field is converted from UTC to this timezone. |
| `week` | string | No | Week start date in 'monDD.YYYY' format (e.g. 'jun09.2026'). If omitted, returns current week. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-forexfactory-com-api-51d6a4a2/get_calendar_filtered \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currencies":"<string>","impact_levels":"<string>","timezone":"<string>","week":"<string>"}'
```

### get_event_detail

Fetch historical release data for a specific economic event by ID. Returns all past releases with actual, forecast, and revision values, plus metadata like decimal precision and release interval. Event IDs are obtained from get_calendar results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Numeric economic event ID (e.g. '149579'). Obtainable from get_calendar events[*].id. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-forexfactory-com-api-51d6a4a2/get_event_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### get_market_overview

Fetch real-time market overview for major currency pairs (EUR/USD, GBP/USD, USD/JPY, USD/CHF, USD/CAD, AUD/USD, NZD/USD, Gold/USD). Returns instrument metadata, price metrics across multiple timeframes (M5 through D2), and quotes from multiple data sources with bid/ask spreads.

**Estimated cost:** Metered

_No parameters required._

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

### get_member_posts

Fetch posts made by a specific ForexFactory forum member. Initiates a server-side search by username and returns paginated results (20 posts per page). Each post includes a content preview, the thread it was posted in, and whether it contains an image attachment. Requires two HTTP requests: one to initiate the search and one for the requested page (page 1 reuses the initial response).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (20 posts per page). |
| `username` | string | Yes | ForexFactory username (e.g. 'canyouu'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-forexfactory-com-api-51d6a4a2/get_member_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","username":"<string>"}'
```

### get_news_latest

Fetch the latest news stories from ForexFactory's news feed. Returns headlines, URLs, impact levels, and preview text. Stories are ordered most-recent-first.

**Estimated cost:** Metered

_No parameters required._

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

### get_thread_posts

Fetch posts from a specific ForexFactory forum thread. Returns post content, author username, date, and embedded image URLs. Supports pagination for long threads. Thread IDs include a numeric ID and URL slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `thread_id` | string | Yes | Thread ID and slug (e.g. '1362090-gold-with-no-drama'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-forexfactory-com-api-51d6a4a2/get_thread_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","thread_id":"<string>"}'
```