# Matchroom Pool — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 professional pool event schedules, player profiles, rankings, and real-time match updates from Matchroom Pool. Retrieve news articles and detailed tournament information across World Nineball Tour events.

**Category:** Sports | **Website:** [matchroompool.com/](https://matchroompool.com/) | **Docs:** [parse.bot/marketplace/bfd3aa77-2f73-4419-a37f-9375fa2f41ad/matchroompool-com-api](https://parse.bot/marketplace/bfd3aa77-2f73-4419-a37f-9375fa2f41ad/matchroompool-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/matchroom-pool/`
**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 event details

Retrieve detailed information about a specific event using its slug. Returns title, description, broadcast status, and participating players when available. Some events use image-based banners without structured date/location fields, in which case those fields will be null. The participating_players array is populated only for invitation-style events with a confirmed player list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Event slug from the event URL path, e.g. 'premier-league-pool' or 'mosconi-cup' |

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

### Get latest news

Retrieve the latest news articles from Matchroom Pool. Returns article titles, dates, URLs, and thumbnail images. Some entries may be YouTube video embeds with null URLs and dates.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/matchroom-pool/get-latest-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get news article

Retrieve the full content of a news article using its URL. Returns the article title, publication date, and full text content. The content field contains the complete article body as plain text.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the news article from matchroompool.com |

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

### Get player profile

Retrieve detailed profile information for a specific player using their slug. Returns biographical information, current rank, and career statistics including alias, country, hometown, age, height, highest rank, majors won, and prize money.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Player slug from the player URL path, e.g. 'fedor-gorst', 'francisco-sanchez-ruiz', 'carlo-biado' |

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

### Get players list

Retrieve the list of all players on the World Nineball Tour with their rank, country, slug, and profile URL. Players without a current ranking have null rank values.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/matchroom-pool/get-players-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get rankings

Retrieve the World Nineball Tour player rankings. Returns ranked players with name, rank number, country, and total prize money. Rankings are ordered by rank ascending.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/matchroom-pool/get-rankings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get schedule

Retrieve the full list of events from the World Nineball Tour schedule page. Returns all upcoming and past events with title, date, location, slug, and URL. Events are ordered chronologically. The response includes a count field for the total number of events returned.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/matchroom-pool/get-schedule \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

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