# outbidtao: the pay-to-rank leaderboard for Bittensor

> Rank is the bid. One τ price per rank, payable in TAO, any subnet's alpha, or locked (Conviction) alpha. No accounts.
> Current #1: nobody yet · listings: 0

## Rules (authoritative constants)
- Minimum new listing: τ0.03 (30000000 rao). Step: τ0.01 (10000000 rao). Max: τ5,000.
- Taking #1 costs ≥ current #1 + τ0.05. Any other rank: ≥ holder's amount + τ0.01.
- Equal amounts keep placement order (older wins).
- Re-listing the same identity raises it; you pay only the difference. The listing's amount is the sum of everything credited to it.
- 1 τ = 1000000000 rao. All API amounts are integer rao.
- Two boards, one payment: the all-time board ranks by total τ ever paid; the Today board (https://outbidtao.ai/today, window=24h on the API) ranks by τ paid in the past 24 hours, so a new listing can own today's #1 without beating the all-time #1. Every payment counts on both. To spend on the Today board, quote with window=24h and open the checkout with chargeRao (the increment) instead of amountRao.

## Identities
- Subnet: "sn64" / "subnet 64" / "64" → key subnet:64
- Validator or miner hotkey: ss58 address → key hotkey:<ss58>
- Website: any https URL → key website:<domain>[/path for github, app stores, huggingface, ...]
- X handle: "@name" → key x:name
Chat/invite links and adult content are rejected. Shorteners are resolved.

## Read the board
- GET https://outbidtao.ai/api/ranking?page=1&category=<slug>   → entries[], rankedBids[{identityKey, amountRao}], totalCount, categories[]
- GET https://outbidtao.ai/api/quote?rank=3[&identity=<...>][&netuid=64]  → { rank, amountRao, chargeRao, usd, alpha? }
- GET https://outbidtao.ai/api/quote?amountRao=<rao>[&identity=<...>]       → the rank that amount would take
- GET https://outbidtao.ai/api/categories/top  · GET https://outbidtao.ai/api/activity  · GET https://outbidtao.ai/api/revenue  · GET https://outbidtao.ai/api/stats
- GET https://outbidtao.ai/api/treasury  → treasury coldkey, lock hotkey, RPC endpoints, remark prefix

## List or raise (3 calls, no browser)
1. POST https://outbidtao.ai/api/checkout  {"input":"sn64","categorySlug":"inference-llm","categorySlugs":["compute-storage"],"amountRao":30000000,"rail":"tao","src":"agent"}
   categorySlug is the primary category; categorySlugs adds up to two more. Subnets are always tagged "subnets" as well, so they lead both the Subnets board and their functional category.
   → { id, status, amountRao, assetQuantity, remark, treasuryColdkey, treasuryLockHotkey, expiresAt, rankAfter, instructions:{btcli, python}, url }
   rail ∈ tao | alpha | locked_alpha. For alpha rails pass "netuid" (the subnet whose alpha you pay with); assetQuantity is then alpha-rao.
   Re-quote another rail later: PATCH https://outbidtao.ai/api/checkout/{id} {"rail":"alpha","netuid":64}
2. Pay exactly assetQuantity (it includes a unique suffix that identifies your payment):
   - TAO:   utility.batch_all([balances.transfer_keep_alive(treasuryColdkey, assetQuantity), system.remark_with_event("outbidtao:{id}")])
            btcli: instructions.btcli  ·  python: instructions.python
   - alpha / locked alpha: subtensorModule.transfer_stake(destination_coldkey=treasuryColdkey, hotkey=<hotkey holding your alpha>, origin_netuid=N, destination_netuid=N, alpha_amount=assetQuantity)
            Locked (Conviction) alpha moves with the same call (5 args, no dest_hotkey on runtime 448). Locked mass lands on the hotkey it arrives from; if the treasury already holds a lock on that subnet, treasuryLockHotkey in the checkout tells you which hotkey your locked alpha must be on.
   The remark is optional; exact-amount matching always works. Quote holds 15 minutes; later payments are credited at the pool price of their block.
3. Poll GET https://outbidtao.ai/api/checkout/{id} until status == "paid"; rankAfter is your rank.

## Categories
subnets, inference-llm, training-finetuning, data-scraping, compute-storage, finance-defi-prediction, agents, media-generation, science, validators, mining-infra, wallets-explorers, staking-liquidity, dev-tools-apis, analytics-research, media-newsletters-communities, jobs-bounties, people, other

## MCP
- Remote MCP server (Streamable HTTP): https://outbidtao.ai/mcp  →  claude mcp add --transport http outbidtao https://outbidtao.ai/mcp
  Tools: get_board, quote_rank, create_checkout, requote_checkout, get_checkout, get_categories, get_activity, get_treasury
- Pages: https://outbidtao.ai/subnet/<netuid>, https://outbidtao.ai/hotkey/<ss58>, https://outbidtao.ai/category/<slug>, https://outbidtao.ai/dashboard (sign in with the paying coldkey for clicks + outbid alerts)

## More
- OpenAPI: https://outbidtao.ai/openapi.json (interactive: https://outbidtao.ai/docs)
- X: https://x.com/outbidtao
- Rules page: https://outbidtao.ai/rules
- Outbound links from the board carry utm_source=outbidtao.