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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-zq-titan007-com-api-58381fc3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-zq-titan007-com-api-58381fc3/get_1x2_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-zq-titan007-com-api-58381fc3/get_asian_handicap_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-zq-titan007-com-api-58381fc3/get_competitions_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-zq-titan007-com-api-58381fc3/get_league_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-zq-titan007-com-api-58381fc3/get_live_scores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-zq-titan007-com-api-58381fc3/get_match_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-zq-titan007-com-api-58381fc3/get_over_under_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_id":"<string>"}'
```
