# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/sumodb-sumogames/`
**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 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/credits/sumodb-sumogames/get-banzuke \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sumodb-sumogames/get-rikishi-kimarite-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sumodb-sumogames/get-rikishi-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sumodb-sumogames/get-yusho-winners \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sumodb-sumogames/search-rikishi \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name":"<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.