{"uid":"cap_-9_Z6FLycdPi3I_l8Ah73","slug":"leaderboard-0000402-xyz-fd76162f","name":"Leaderboard Entry Write (leaderboard.0000402.xyz)","description":"Pay to create or update public leaderboards through one write endpoint. Public reads stay free.","url":"https://leaderboard.0000402.xyz/entry","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pXGU6ZQjTnjACkkmAZbtY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:31:15.926Z","isFirstParty":false}