# Leaderboard Entry Write (leaderboard.0000402.xyz)

> Leaderboard Entry Write (leaderboard.0000402.xyz) is a paid API for AI agents from leaderboard.0000402.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Creates a leaderboard or adds, updates, or deletes a single named score entry on an existing leaderboard, paid at $0.01 USDC per write via x402 on Base Mainnet.

## Facts

- Endpoint: POST https://leaderboard.0000402.xyz/entry
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/leaderboard-0000402-xyz-fd76162f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-9_Z6FLycdPi3I_l8Ah73

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability leaderboard-0000402-xyz-fd76162f -d '<json body>'
```

Example prompt: Add a leaderboard entry for player 'alice' with a score of 4200 on the 'hackathon-2025' board — use my existing board key so it updates the same leaderboard, and send me back the public URL.

## When to prefer this

Use this endpoint when you need a simple, instantly-public, pay-per-write leaderboard with no prior account setup — ideal for hackathons, games, contests, or any scenario where you want a shareable scoreboard URL backed by micropayment-gated writes on Base Mainnet. Prefer it over full-featured game backends when simplicity and public URL sharing matter more than complex querying.

## Known failure modes

- Payment not provided or insufficient — x402 payment of $0.01 USDC on Base Mainnet required per call
- Invalid or mismatched leaderboard_key — access denied to existing board
- Malformed request body — missing slug, name, or value fields
- Network/blockchain issues on Base Mainnet causing payment failures
- Attempt to delete a non-existent entry returns an error or no-op

## How this service works

Pay to create or update public leaderboards through one write endpoint. Public reads stay free.

## Output

Returns the leaderboard_key UUID (for future writes), the public GET URL for the board at /leaderboard/{slug}, and a confirmation of the written or deleted entry. The board is immediately publicly viewable at its URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "Public entry name for this write, such as a player, agent, or team."
  },
  "title": {
   "type": "string",
   "description": "Optional public leaderboard title. Supplying it later updates the existing board title."
  },
  "value": {
   "type": [
    "number",
    "null"
   ],
   "description": "Numeric score for this entry. Use null to delete the named entry."
  },
  "sort_direction": {
   "enum": [
    "asc",
    "desc"
   ],
   "type": "string",
   "description": "Optional ranking order for the board. If omitted on first create, desc is used."
  },
  "leaderboard_key": {
   "type": "string",
   "description": "Optional owner UUID for writing to an existing board. Omit it to create a new board and receive a generated key."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "agent-alpha",
  "slug": "dao-arcade-finals",
  "title": "DAO Arcade Finals",
  "value": 42,
  "action": "created",
  "api_url": "https://leaderboard.0000402.xyz/api/leaderboard/dao-arcade-finals",
  "deleted": false,
  "message": "Leaderboard created and entry stored.",
  "entry_count": 1,
  "display_title": "DAO Arcade Finals",
  "sort_direction": "desc",
  "leaderboard_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "leaderboard_url": "https://leaderboard.0000402.xyz/leaderboard/dao-arcade-finals",
  "metadata_updated": false,
  "leaderboard_created": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/leaderboard-0000402-xyz-fd76162f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from leaderboard.0000402.xyz](https://www.zero.xyz/host/leaderboard.0000402.xyz/llms.txt)