# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/brokerchooser/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/brokerchooser/compare-brokers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/brokerchooser/get-best-brokers-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/brokerchooser/get-broker-full-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/brokerchooser/list-all-brokers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/brokerchooser/search-brokers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.