# Propfirmmatch — 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 proprietary trading firm challenge data including futures and forex opportunities, filter by your preferences, and browse available firms to find the perfect trading challenge. Get detailed information about challenge requirements, firm listings, and all available filtering options to streamline your search for the right prop trading opportunity.

**Category:** Finance & Markets | **Website:** [propfirmmatch.com/futures](https://propfirmmatch.com/futures) | **Docs:** [parse.bot/marketplace/ac13fa7c-b566-4473-bde0-972391907c6f/propfirmmatch-com-api](https://parse.bot/marketplace/ac13fa7c-b566-4473-bde0-972391907c6f/propfirmmatch-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-propfirmmatch-com-api-ac13fa7c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_filtering_options

Retrieve all available filtering options for challenge listings. Returns lists of firms, trading platforms, supported countries, instruments, and numerical limits (min/max values for account size, drawdown, profit split, etc.).

**Estimated cost:** Metered

_No parameters required._

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

### list_challenges

Search and filter prop firm challenges (evaluation programs). Results are deduplicated by program — each distinct challenge program appears once with a pricing_by_size array showing all available account sizes and their prices. Returns pricing, profit targets, drawdown limits, payout info, active promos, and optionally news_trading_status. Supports filtering by asset class, account size, number of steps, billing type, text search, and economic news trading policy. Manual offset pagination via skip/limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `account_size` | string | No | Comma-separated account sizes in USD to filter by (e.g. 50000,100000,150000). Omitted returns challenges at all account sizes. |
| `apply_discount` | boolean | No | Whether to apply available discounts to prices. |
| `assets` | string | No | Comma-separated asset classes to filter by (e.g. futures, forex, crypto, stocks). |
| `billing_type` | string | No | Comma-separated billing types to filter by: monthly, one_time. The default 'monthly,one_time' returns all challenges including those with no billing type set. |
| `economic_news` | string | No | Filter challenges by economic news trading policy. 'allowed' returns challenges where news trading is fully allowed, 'not_allowed' returns challenges where news trading is prohibited, 'restricted' returns challenges where news trading is allowed but with restrictions (e.g. no trading around Tier 1 events). |
| `limit` | integer | No | Maximum number of distinct challenge programs to return (1-50). |
| `order_by` | string | No | Field to order results by. |
| `order_direction` | string | No | Sort direction for results. |
| `search` | string | No | Text search query to filter challenges by name or firm name. Omitted returns all. |
| `skip` | integer | No | Number of results to skip for pagination. |
| `steps` | string | No | Comma-separated challenge step programs to filter by (e.g. '1 Step', '2 Step', '3 Step', 'Instant'). Omitting returns all step types. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-propfirmmatch-com-api-ac13fa7c/list_challenges \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account_size":"<string>","apply_discount":"<boolean>","assets":"<string>","billing_type":"<string>","economic_news":"<string>","limit":"<integer>","order_by":"<string>","order_direction":"<string>","search":"<string>","skip":"<integer>","steps":"<string>"}'
```

### list_firms

List all prop trading firms for a given category. Returns basic firm info including name, review score, review count, and popularity (likes). No pagination — returns all firms in the category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category of prop firms to list. |

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