How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

OnTopX402 API

Read the leaderboard, read a single entry, and bid for rank. GET /api/leaderboard returns the board unauthenticated; POST /api/bid returns an x402 payment challenge rather than requiring an account.

This API exposes 3 operations across 3 paths, organized into 2 resource areas, and defines 9 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://ontopx402.com.

3 operations 3 paths 9 schemas 2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://ontopx402.com
Contact
Resource Areas
2

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 2 GET, 1 POST. They span 2 resource areas: leaderboard, bidding. Each is listed below with its method, path, parameters, and response codes.

leaderboard 2
GET
/api/leaderboard
Read the leaderboard
api_leaderboard_api_leaderboard_get 2 params → 200429
GET
/api/entry
Look up one entry
api_entry_api_entry_get 1 param → 200400404429
bidding 1
POST
/api/bid
Bid for a rank
api_bid_api_bid_post 3 params body → 200400429402

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are Entry (11 properties), BidSuccess (5 properties), Leaderboard (5 properties), ValidationError (5 properties). Each schema is shown below with its type and property counts.

BidRequest
object
A bid: which link to rank, what to say about it, and how much to pay. All three are required. The amount you name is the amount you pay and the amount that dec…
3 properties 3 required
HTTPValidationError
object
1 property
ValidationError
object
5 properties 3 required
Entry
object
One listing on the board.
11 properties 10 required
Leaderboard
object
5 properties 5 required
EntryLookup
object
A listed link returns its entry plus what it would take to pass the one above it. An unlisted link returns 404 with the price of first place.
2 properties
BidSuccess
object
The bid settled and the board has already changed.
5 properties 4 required
Error
object
2 properties 1 required
PaymentRequired
object
An x402 v2 payment-required object, priced at exactly the amount you asked to bid, on Base and Solana. The same object is also sent base64-encoded in the PAYME…
5 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ontopx402-api-openapi.yml Raw ↑
Where this information came from

This is an independent, third-party profile of OnTopX402 API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.