# Sumodb Sumogames — 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 for sumo wrestlers and access detailed profiles, rankings, techniques, and historical tournament winners from the comprehensive Sumo Reference Database. Get current banzuke standings and analyze wrestler kimarite (winning technique) statistics to explore sumo's rich competitive history.

**Category:** Sports | **Website:** [sumodb.sumogames.de/](https://sumodb.sumogames.de/) | **Docs:** [parse.bot/marketplace/d98558c2-fcba-4951-a3df-59c67a72f3be/sumodb-sumogames-de-api](https://parse.bot/marketplace/d98558c2-fcba-4951-a3df-59c67a72f3be/sumodb-sumogames-de-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-sumodb-sumogames-de-api-d98558c2/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_banzuke

Retrieve the official banzuke (ranking sheet) for a given basho (tournament). Returns all ranked wrestlers with their physical measurements and rank information. The basho parameter accepts YYYY.MM or YYYYMM format. Tournaments are held in January, March, May, July, September, and November.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `basho` | string | Yes | The tournament date in YYYY.MM or YYYYMM format (e.g., '2024.01' for January 2024). Tournaments are held in January, March, May, July, September, and November. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sumodb-sumogames-de-api-d98558c2/get_banzuke \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"basho":"<string>"}'
```

### get_rikishi_kimarite_stats

Get a breakdown of all winning and losing techniques (kimarite) used by a specific rikishi, with counts for each technique. Useful for analyzing a wrestler's fighting style and tendencies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | The numeric ID of the rikishi. Obtained from search_rikishi results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sumodb-sumogames-de-api-d98558c2/get_rikishi_kimarite_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### get_rikishi_profile

Fetch a wrestler's full profile by numeric ID. Returns physical attributes (height, weight), career record, stable, birthplace, and a basho-by-basho career history array. The id is obtained from search_rikishi results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | The numeric ID of the rikishi (e.g., '1123' for Hakuho). Obtained from search_rikishi results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sumodb-sumogames-de-api-d98558c2/get_rikishi_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### get_yusho_winners

Retrieve the complete list of all makuuchi division tournament (yusho) winners across history, ordered from most recent to oldest. Each entry includes the tournament date, the winner's rank and name, and their numeric ID.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sumodb-sumogames-de-api-d98558c2/get_yusho_winners \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_rikishi

Full-text search over sumo wrestlers by shikona (ring name). Returns a list of matching rikishi with their IDs and profile URLs. Matches are partial — searching 'Hakuho' also returns wrestlers whose real names match. Each result carries an id usable with get_rikishi_profile and get_rikishi_kimarite_stats.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Shikona (ring name) of the wrestler to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sumodb-sumogames-de-api-d98558c2/search_rikishi \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>"}'
```