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

> Search and explore prediction markets with detailed information on specific markets, trader performance rankings, and category tags. Track market listings, filter by categories, and monitor top traders all in one place.

**Category:** Finance & Markets | **Website:** [predictparity.com/live-trades?sd=BUY&bot=0&inc=highest-temperature&exc=&szMin=&pMin=5000&wrMin=80&bMin=1000](https://predictparity.com/live-trades?sd=BUY&bot=0&inc=highest-temperature&exc=&szMin=&pMin=5000&wrMin=80&bMin=1000) | **Docs:** [parse.bot/marketplace/e80d0638-41b2-42ad-9091-31e5c07c73d8/predictparity-com-api](https://parse.bot/marketplace/e80d0638-41b2-42ad-9091-31e5c07c73d8/predictparity-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/predictparity/`
**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

### Get market

Get detailed information about a specific prediction market by its slug. Returns full market description, outcomes with APY and spread, order book details, platform market metadata, and net flow volumes. The slug is available from search_markets results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `platform` | string | No | Platform identifier. |
| `slug` | string | Yes | Market slug identifier (e.g. will-china-invade-taiwan-before-2027). Available from search_markets results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/predictparity/get-market \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"platform":"<string>","slug":"<string>"}'
```

### Get tags

List available market tags with their active market counts. Use to discover tag slugs for filtering in search_markets. Optionally filter tags by a text search query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Text search to filter tags by name (e.g. weather, politics). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/predictparity/get-tags \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Get traders

List traders on the platform with analytics, badges, and trading traits. Returns paginated results sorted by specified field. Pagination is offset-based with manual offset/limit control. Each trader includes all-time volume, PnL, rank, win rate, and other behavioral traits.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page (1-100). |
| `offset` | integer | No | Pagination offset (0-based). |
| `query` | string | No | Text search to filter traders by name/username. |
| `sort_by` | string | No | Field to sort by. |
| `sort_order` | string | No | Sort direction. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/predictparity/get-traders \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>","sort_by":"<string>","sort_order":"<string>"}'
```

### Search markets

Search and list prediction markets with optional filters for tags, status, and text search. Returns paginated results sorted by the specified field. Pagination is offset-based with manual offset/limit control. Each market includes outcomes with current midPoint prices, volume metrics, and associated tags.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `excluded_tags` | string | No | Comma-separated list of tag slugs to exclude (e.g. sports,crypto). |
| `limit` | integer | No | Number of results per page (1-100). |
| `offset` | integer | No | Pagination offset (0-based). |
| `query` | string | No | Text search query to filter markets by question/title. |
| `sort_by` | string | No | Field to sort results by. |
| `sort_order` | string | No | Sort direction. |
| `status` | string | No | Market status filter. |
| `tags` | string | No | Comma-separated list of tag slugs to include (e.g. highest-temperature,weather,politics). Use get_tags endpoint to discover available tag slugs. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/predictparity/search-markets \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"excluded_tags":"<string>","limit":"<integer>","offset":"<integer>","query":"<string>","sort_by":"<string>","sort_order":"<string>","status":"<string>","tags":"<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.