{"uid":"cap_uRiDiIA916PdGjDRc2sUr","slug":"ontopx402-link-ranking-bid-3e399e59","name":"OnTopX402 Link Ranking Bid","description":"Rank on ontopx402.com for example.com","url":"https://ontopx402.com/api/bid?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","description":"The link you want ranked. One entry per link; bidding again on the same link adds to its total."},"amount":{"type":"string","description":"How much to bid, in US dollars, minimum $1. This is the amount you pay AND the amount that decides your rank — the 402 is priced at exactly this figure."},"description":{"type":"string","description":"What the link is, in at most 255 characters. Shown on the board next to your entry."}}},"responseSchema":{"type":"json","example":{"ok":true,"url":"https://example.com","name":"example.com","page":"https://ontopx402.com/e/example-com","rank":1,"network":"eip155:8453","paid_usd":"1.00","amount_usd":"1.00","description":"What this link is.","transaction":"0x…"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","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":"$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_uRN8z9zkIbEAlBZJlRwz7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submit a paid bid to rank a URL on the OnTopX402 leaderboard — higher bids earn higher placement, and repeated bids on the same URL accumulate.","exampleAgentPrompt":"Bid $5 on ontopx402 to rank my site https://example.com — describe it as 'The best example domain on the web' so it shows up prominently on the board.","exampleUseCases":[{"title":"Promote a new product launch page","prompt":"Place a $10 bid on ontopx402 to rank my product page https://mystore.com/launch — use the description 'New gadget launch, limited edition, ships worldwide.'"},{"title":"Boost a blog post's visibility","prompt":"I want to get my article https://myblog.com/top-ai-tools ranked on ontopx402. Bid $3 and set the description to 'Best AI tools roundup for 2025 — updated weekly.'"},{"title":"Accumulate bids to dominate the leaderboard","prompt":"Keep bidding $2 at a time on https://myagency.com on ontopx402 until I tell you to stop — description is 'Award-winning web design agency.'"}],"resultDescription":"A confirmation that the bid was recorded, updating the leaderboard position of the submitted URL. The URL's total accumulated bid amount determines its rank among all entries on the board.","failureModes":["Bid amount below $1 minimum — rejected with validation error","URL missing or malformed — schema validation failure","Description exceeds 255 characters — truncation or rejection","Payment failure via x402 protocol — bid not recorded","Duplicate URL bid accepted but accumulates rather than replacing previous bid"],"whenToPreferThis":"Use this endpoint when the goal is to gain public leaderboard visibility on ontopx402.com by paying a variable bid amount. The rank is directly determined by bid size, making it ideal for competitive link promotion where the user controls their spend. Prefer this over free SEO or traditional ad networks when the user wants instant, transparent, pay-to-rank placement with no auction complexity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T00:32:08.433Z","isFirstParty":false,"canonicalSlug":"ontopx402-link-ranking-bid-3e399e59"}