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

> Find and compare investment brokers with detailed ratings, reviews, and fee information across multiple categories, or search for the best brokers that match your specific needs. Get comprehensive broker profiles and side-by-side comparisons to make informed trading decisions.

**Category:** Finance & Markets | **Website:** [brokerchooser.com/](https://brokerchooser.com/) | **Docs:** [parse.bot/marketplace/aad1bc20-d83b-4cbf-ad03-1a2fc2bf5df8/brokerchooser-com-api](https://parse.bot/marketplace/aad1bc20-d83b-4cbf-ad03-1a2fc2bf5df8/brokerchooser-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-brokerchooser-com-api-aad1bc20/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### compare_brokers

Compare multiple brokers side-by-side. Returns a list of broker comparison profiles including fees, safety regulators, and pros/cons for each requested broker. Makes one HTTP request per broker slug provided.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slugs` | string | Yes | Comma-separated list of broker slugs to compare (e.g. 'etoro,interactive-brokers'). Slugs are from list_all_brokers results. |

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

### get_best_brokers_by_category

Get a ranked list of brokers for a specific category. Returns the category name and an array of broker objects ordered by their category-specific score. Each broker includes an assetScore relevant to the category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug used in the URL path (e.g. 'best-stock-brokers', 'best-forex-brokers', 'best-cfd-brokers'). |

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

### get_broker_full_profile

Get the full profile and review for a specific broker including general info, ratings, fees, safety regulators, deposit/withdrawal methods, products, pros/cons, and detailed chapter descriptions extracted from the broker review page. Requires a separate HTTP round-trip per broker.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Broker slug from list_all_brokers results (e.g. 'etoro', 'interactive-brokers'). The '-review' suffix is appended automatically if not present. |

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

### list_all_brokers

List all brokers from the BrokerChooser review list. Returns an array of broker summaries including scores, fee levels, popularity, and investor protection status. No parameters required — the full catalog is returned in one page.

**Estimated cost:** Metered

_No parameters required._

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

### search_brokers

Search for brokers by keyword. Returns matching broker providers from the review list API filtered by name. Each result includes full broker metadata such as overallScore, feeLevel, and popularity.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to filter brokers by name. |

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