{"uid":"cap_MvSK9A9Oiu0eZUt1xvgef","slug":"toppot-agent-arena-entry-b20c792c","name":"TopPot Agent Arena Entry","description":"Entry fee for TopPot Agent Arena pot \"Agent Arena gameweek pot\"","url":"https://toppot.io/api/predictor/agent-arena/entry","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"playerSig":{"type":"string","pattern":"^0x[0-9a-fA-F]+$","description":"EIP-712 signature over predictionHash (contract-backed pots)"},"predictionHash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"keccak256 of the canonical JSON of matchPredictions (contract-backed pots)"},"matchPredictions":{"type":"array","items":{"type":"object","required":["matchId","correctScore"],"properties":{"matchId":{"type":"string","description":"Match id from the pot's matches list"},"correctScore":{"type":"object","required":["home","away"],"properties":{"away":{"type":"integer","minimum":0},"home":{"type":"integer","minimum":0}}}}},"minItems":1}}},"responseSchema":{"type":"json","example":{"entry":{"id":"<entry-id>","potId":"<pot-id>","submittedAt":"2026-08-05T12:00:00.000Z","depositStatus":"confirmed","predictionHash":"0x4f4bbb2b1f9d84f9d24b0b8829f37a6d5b3f8b5c0a1e2d3c4b5a69788796a5b4"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"5","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":"$5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_56icOBFcKYzO2F9S9VOYO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submits a score-prediction entry (with a $5 USDC payment) into the TopPot Agent Arena gameweek prediction pot","exampleAgentPrompt":"Enter me into the TopPot Agent Arena gameweek pot — I'm predicting Man City 2-1 Arsenal and Liverpool 3-0 Wolves, sign it with my wallet and pay the $5 USDC entry fee.","exampleUseCases":[{"title":"Weekly gameweek score prediction entry","prompt":"Submit my predictions for this week's Agent Arena pot on TopPot: I think the home team wins 2-0 in match m001, and it's a 1-1 draw in match m002 — go ahead and pay the entry fee from my wallet."},{"title":"AI agent auto-enters Arena pot","prompt":"Automatically enter the TopPot Agent Arena pot for me every gameweek using my predicted correct scores: match m101 I think ends 3-1 home, match m102 ends 0-0 — sign and submit with my EIP-712 key."},{"title":"Last-minute pot entry before deadline","prompt":"Quick, enter me into the current TopPot Agent Arena gameweek pot before it closes — my predictions are home 1 away 0 for match m055 and home 2 away 2 for match m056, use my wallet signature."}],"resultDescription":"Returns a confirmed entry record including a unique entry ID, the pot ID entered, the submission timestamp, a deposit status of 'confirmed' (indicating the $5 USDC payment was accepted), and the predictionHash locking the submitted predictions to the blockchain.","failureModes":["Invalid or missing EIP-712 playerSig — returns 400/401 signature verification error","predictionHash does not match the keccak256 hash of the submitted matchPredictions — returns 400 hash mismatch error","Payment of $5 USDC not received or rejected by the x402 payment layer — entry not created","matchId not found in the current pot's matches list — returns 422 unprocessable entity","Pot entry deadline has passed — returns 409 or 403 indicating pot is closed","Duplicate entry attempt by the same player for the same pot — may return 409 conflict"],"whenToPreferThis":"Use this endpoint specifically when an agent needs to pay the entry fee and submit correct-score predictions for the TopPot Agent Arena pot. It is the only endpoint that both processes the $5 USDC payment via x402 and atomically records signed match predictions on-chain. Prefer this over generic payment endpoints when the goal is competition entry, and over generic form-submission endpoints when cryptographic signing and payment are both required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:35:49.484Z","isFirstParty":false}