{"uid":"cap_dPS7O4h499b97f6v0dIkF","slug":"agenticcommerce-lol-x402-resource-leaderboard-bid-ae248c0e","name":"agenticcommerce.lol — x402 Resource Leaderboard Bid","description":"A ranked leaderboard of x402 resources. Pay $1 via x402 to rank your API, agent, or tool. Let your agent outfit itself from a ranked list of x402 endpoints.","url":"https://agenticcommerce.lol/api/bid","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["url","bidAmount"],"properties":{"url":{"type":"string","example":"https://example-x402-api.com","minLength":4,"description":"Homepage or canonical URL of the x402 resource you are ranking (a bare domain is accepted)."},"name":{"type":"string","example":"Example API","maxLength":200,"description":"Display name"},"network":{"type":"string","example":"base","maxLength":50,"description":"Network the resource settles on"},"bidAmount":{"type":"integer","example":1,"maximum":10000,"minimum":1,"description":"Whole USDC to add to this URL's cumulative bid. New URLs start at $1. Re-bidding the same URL adds to its total (you only pay the amount you send)."},"description":{"type":"string","example":"Pay-per-call weather data via x402","maxLength":280,"description":"One-line description of what the resource does"},"resourceUrl":{"type":"string","format":"uri","example":"https://example-x402-api.com/api/weather","description":"The actual x402-gated endpoint, if different from url"},"pricePerCall":{"type":"string","example":"$0.001","maxLength":50,"description":"The resource's own per-call price, for display"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","data"],"properties":{"data":{"type":"object","required":["listing","amountCharged","isNew"],"properties":{"isNew":{"type":"boolean","description":"true if this URL was not listed before"},"txHash":{"type":["string","null"],"description":"On-chain settlement transaction hash"},"listing":{"type":"object","required":["id","name","url","bidUsdc","resourceUrl","network","asset"],"properties":{"id":{"type":"integer"},"url":{"type":"string","format":"uri","description":"Canonical URL of the resource"},"name":{"type":"string"},"rank":{"type":"integer","description":"1 = top of the leaderboard"},"asset":{"type":"string","description":"Payment asset (e.g. USDC)"},"clicks":{"type":"integer"},"bidUsdc":{"type":"number","description":"Cumulative USDC bid. Higher = ranked higher."},"iconUrl":{"type":["string","null"],"description":"Resolved favicon URL of the resource"},"network":{"type":"string","description":"Network the resource accepts payment on (e.g. base)"},"createdAt":{"type":"string","format":"date-time"},"lastBidAt":{"type":"string","format":"date-time"},"description":{"type":"string"},"resourceUrl":{"type":"string","format":"uri","description":"The actual x402 endpoint URL"},"pricePerCall":{"type":"string","description":"The resource's own price per call, e.g. $0.001"}}},"paymentMode":{"enum":["x402","mock"],"type":"string"},"amountCharged":{"type":"number","description":"USDC charged for this bid"}}},"success":{"type":"boolean"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"isNew":true,"txHash":"0x082a4b68ec1d5d08248c72238e3f8122334722a5f671cb51946638a24536d015","listing":{"id":1,"url":"https://example-x402-api.com","name":"Example API","rank":1,"asset":"USDC","clicks":0,"bidUsdc":1,"iconUrl":"https://example-x402-api.com/icon.svg","network":"base","createdAt":"2026-08-21T15:58:48.181Z","lastBidAt":"2026-08-21T15:58:48.181Z","description":"Pay-per-call weather data via x402","resourceUrl":"https://example-x402-api.com/api/weather","pricePerCall":"$0.001"},"paymentMode":"x402","amountCharged":1},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_E91krTe5DPW-ZUAFxDnM6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submit a $1 USDC bid via x402 to rank an API, agent, or tool on the x402 resource leaderboard","exampleAgentPrompt":"Add my x402 API at https://myweatherapi.com/api/weather to the agenticcommerce.lol leaderboard — call it 'MyWeather API', describe it as 'Pay-per-call weather data via x402', set the price per call to $0.001, and bid $1 USDC to get it listed.","exampleUseCases":[{"title":"Launch a new x402 API listing","prompt":"List my new x402 API at https://dataenrich.io/api/enrich on the agenticcommerce.lol leaderboard — the display name is 'DataEnrich', describe it as 'Pay-per-call data enrichment via x402', and place a $1 USDC bid to get it ranked."},{"title":"Boost existing listing with extra bid","prompt":"I already have my tool listed at https://agenttools.xyz on the x402 leaderboard — can you add another $5 USDC bid to push it higher in the rankings?"},{"title":"Agent self-equipping from ranked directory","prompt":"Find me the top-ranked x402 endpoints on agenticcommerce.lol so I can pick the best tools for my agent to use, then submit my own API at https://myllm.app/api/chat with the name 'MyLLM' and a $2 USDC bid."}],"resultDescription":"Returns a JSON object with success status, the updated listing record (id, url, name, rank, bidUsdc, description, resourceUrl, pricePerCall, network, iconUrl, createdAt, lastBidAt, clicks), the amount charged in USDC, a transaction hash for the on-chain settlement, and a boolean indicating whether this was a newly created listing.","failureModes":["Payment failure — x402 payment of the bid amount not fulfilled, resulting in a 402 or payment error","Invalid URL — url field too short or malformed, rejected by schema validation","Bid amount out of range — bidAmount below 1 or above 10000 USDC","Missing required fields — url or bidAmount absent, returns validation error","Network mismatch — specified network not supported for settlement","Description too long — description exceeds 280 characters, rejected at schema level"],"whenToPreferThis":"Use this endpoint when you want to register or promote an x402-compatible API, agent, or tool on a ranked discovery leaderboard that other AI agents browse to find callable resources. It is specifically suited for x402 ecosystem participants who want their endpoint discovered by agents willing to pay per call. Prefer this over generic API directories when your resource uses x402 payment gating and you want visibility in agentic commerce contexts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:38:49.161Z","isFirstParty":false}