{"openapi":"3.1.0","info":{"title":"BidRank","version":"0.1.0","summary":"Public pay-to-rank leaderboard","description":"BidRank (https://bidrank.lol) is a public pay-to-rank leaderboard. This document describes GET /api/board only. No auth. CORS is open.","contact":{"email":"support@bidrank.lol"}},"servers":[{"url":"https://bidrank.lol"}],"paths":{"/api/board":{"get":{"operationId":"getBoard","summary":"Live board","description":"Current listings, ladder, takeover, and visitor counts. Public. No auth. Paginate with ?page=.","parameters":[{"name":"page","in":"query","required":false,"description":"Listings page. pageSize is 50.","schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Board payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Board"}}}}}}}},"components":{"schemas":{"Board":{"type":"object","additionalProperties":false,"required":["listings","ladder","total","page","pageSize","pageCount","topAmountCents","takeover","visitors"],"properties":{"listings":{"type":"array","description":"Ranked rows on this page.","items":{"$ref":"#/components/schemas/RankedListing"}},"ladder":{"type":"array","description":"Amounts used to compute what rank a bid would buy.","items":{"$ref":"#/components/schemas/LadderEntry"}},"total":{"type":"integer","description":"Listing count."},"page":{"type":"integer"},"pageSize":{"type":"integer","description":"Always 50."},"pageCount":{"type":"integer"},"topAmountCents":{"type":"integer","description":"Current #1 amount in US cents."},"takeover":{"description":"Active 3-hour page-1 lock, or null.","oneOf":[{"$ref":"#/components/schemas/Takeover"},{"type":"null"}]},"visitors":{"$ref":"#/components/schemas/Visitors"}}},"Listing":{"type":"object","additionalProperties":false,"required":["id","listing_key","url","display_host","title","description","favicon_url","amount_cents","clicks","created_at","updated_at"],"properties":{"id":{"type":"integer"},"listing_key":{"type":"string"},"url":{"type":"string"},"display_host":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"favicon_url":{"type":["string","null"]},"amount_cents":{"type":"integer"},"clicks":{"type":"integer"},"created_at":{"type":"integer","description":"Unix ms."},"updated_at":{"type":"integer","description":"Unix ms."}}},"RankedListing":{"allOf":[{"$ref":"#/components/schemas/Listing"},{"type":"object","additionalProperties":false,"required":["rank","isTakeover"],"properties":{"rank":{"type":"integer"},"isTakeover":{"type":"boolean"}}}]},"LadderEntry":{"type":"object","additionalProperties":false,"required":["listing_key","amount_cents","created_at","isTakeover"],"properties":{"listing_key":{"type":"string"},"amount_cents":{"type":"integer"},"created_at":{"type":"integer","description":"Unix ms."},"isTakeover":{"type":"boolean"}}},"Takeover":{"type":"object","additionalProperties":false,"required":["id","listing_id","amount_cents","starts_at","ends_at","created_at","listing"],"properties":{"id":{"type":"integer"},"listing_id":{"type":"integer"},"amount_cents":{"type":"integer"},"starts_at":{"type":"integer","description":"Unix ms."},"ends_at":{"type":"integer","description":"Unix ms."},"created_at":{"type":"integer","description":"Unix ms."},"listing":{"$ref":"#/components/schemas/Listing"}}},"Visitors":{"type":"object","additionalProperties":false,"required":["online","lastHour"],"properties":{"online":{"type":"integer","description":"Unique browsers in the last 5 minutes. Not accounts."},"lastHour":{"type":"integer","description":"Unique browsers in the last hour. Not accounts."}}}}}}