# Features Financialjuice — 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.

> Get live financial news, economic calendar events, and in-depth articles to stay informed on market movements and economic indicators. Search and filter news by stock codes and calendar events to find the financial information most relevant to your trading or investment decisions.

**Category:** Finance & Markets | **Website:** [features.financialjuice.com/](https://features.financialjuice.com/) | **Docs:** [parse.bot/marketplace/15db8d14-04d5-4bd1-931d-9f2adf66ceb4/features-financialjuice-com-api](https://parse.bot/marketplace/15db8d14-04d5-4bd1-931d-9f2adf66ceb4/features-financialjuice-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-features-financialjuice-com-api-15db8d14/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_article_detail

Retrieves full content for a specific article by its numeric WordPress ID or URL slug. At least one identifier must be provided. Returns the complete article object including rendered HTML content, excerpt, categories, and metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `article_id` | integer | No | Numeric WordPress post ID (from get_articles results). |
| `slug` | string | No | URL slug of the article (from get_articles results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-features-financialjuice-com-api-15db8d14/get_article_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"article_id":"<integer>","slug":"<string>"}'
```

### get_articles

Retrieves paginated articles from the WordPress REST API in reverse chronological order. Supports filtering by category ID and free-text search. Each article includes rendered title, content HTML, excerpt, publication date, slug, and category IDs. Pagination uses integer page numbers; the default page size is 10.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | integer | No | Category ID to filter by. Known IDs: 73 (Daily Dose), 76 (US), 77 (EU). |
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of results per page (1-100). |
| `search` | string | No | Search keyword for filtering articles by title/content. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-features-financialjuice-com-api-15db8d14/get_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<integer>","page":"<integer>","per_page":"<integer>","search":"<string>"}'
```

### get_economic_calendar

Retrieves upcoming and recent economic calendar events including data releases, holidays, and speeches. Events are sorted in reverse chronological order and include forecast, previous, and actual values where applicable.

**Estimated cost:** Metered

_No parameters required._

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

### get_news_feed

Retrieves the live financial news feed showing the most recent headlines. Supports cursor-based pagination using the last seen NewsID to fetch older items. Returns news items with title, publication timestamp, importance level, labels, and source metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `old_id` | integer | No | The last NewsID seen in previous results for pagination. Use 0 (default) to get the latest news. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-features-financialjuice-com-api-15db8d14/get_news_feed \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"old_id":"<integer>"}'
```

### get_stock_codes

Searches for stock tickers and company names by keyword. Returns matching stocks with their exchange, ticker symbol, and company name. Useful for resolving company names to ticker symbols.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search query for stocks/tickers (e.g. 'Apple', 'Tesla', 'AAPL'). |

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

### search_news

Searches the live news feed by keyword. Returns matching news items sorted by recency. Each item includes title, publication timestamp, importance level, source name, and labels.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to filter news items. |

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