# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-predictparity-com-api-e80d0638/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-predictparity-com-api-e80d0638/get_market \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-predictparity-com-api-e80d0638/get_tags \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-predictparity-com-api-e80d0638/get_traders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-predictparity-com-api-e80d0638/search_markets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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>"}'
```