# Zq Titan007 — 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.

> Track live football scores and match results across multiple leagues, while accessing detailed odds from various bookmakers including 1x2, Asian handicap, and over/under betting lines. Get comprehensive match information and browse competitions to stay updated on games and betting opportunities.

**Category:** Sports | **Website:** [zq.titan007.com/](https://zq.titan007.com/) | **Docs:** [parse.bot/marketplace/58381fc3-e09d-4eb5-9447-e3bea6877458/zq-titan007-com-api](https://parse.bot/marketplace/58381fc3-e09d-4eb5-9447-e3bea6877458/zq-titan007-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/zq-titan007/`
**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 1x2 odds

Retrieve European 1x2 (Win/Draw/Loss) odds from multiple bookmakers for a given match. Returns opening and current odds for home win, draw, and away win. Odds may be empty for minor league matches without bookmaker coverage.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | Numeric match ID from get_live_scores or get_league_matches. |

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

### Get asian handicap odds

Retrieve Asian Handicap odds from multiple bookmakers for a given match. Returns opening and current handicap lines with home and away odds. Each entry includes both text and numeric handicap values. Odds may be empty for minor league matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | Numeric match ID from get_live_scores or get_league_matches. |

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

### Get competitions list

List available football competitions and their IDs. Returns all leagues and cups available on the platform with their numeric identifiers. Names are in Chinese. Use the returned id values as league_id in get_league_matches.

**Estimated cost:** Metered

_No parameters required._

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

### Get league matches

Retrieve the match schedule, results, and team roster for a specific league and season. Returns league metadata, team list, and all match results for the specified season. Match results include scores and half-time scores. Teams include Chinese, Traditional Chinese, and English names.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_id` | string | Yes | Numeric league ID from get_competitions_list. |
| `season` | string | No | Season string in YYYY-YYYY format. |

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

### Get live scores

Fetch all current live and today's match scores. Returns all matches scheduled or in progress for the current day, including scores and match status. Matches include both major and minor leagues worldwide. Status field indicates match state (0=not started, 1=first half, 2=half time, 3=second half, -1=finished).

**Estimated cost:** Metered

_No parameters required._

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

### Get match detail

Get detailed match statistics and events for a given match ID. Returns match stats (corners, fouls, shots, possession), event timeline, and basic match info including weather. Stats may be empty for matches not yet played or from minor leagues without tracking.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | Numeric match ID from get_live_scores or get_league_matches. |

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

### Get over under odds

Retrieve Over/Under (Total Goals) odds from multiple bookmakers for a given match. Returns opening and current total lines with over and under odds. Each entry includes both text and numeric total values. Odds may be empty for minor league matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | Numeric match ID from get_live_scores or get_league_matches. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/zq-titan007/get-over-under-odds \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"match_id":"<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.