{"openapi":"3.1.0","info":{"title":"outbidtao API","version":"1.0.0","description":"Pay-to-rank leaderboard for Bittensor. One τ price per rank; pay in TAO, alpha or locked alpha. See /llms.txt for the payment recipe."},"servers":[{"url":"https://outbidtao.ai"}],"paths":{"/api/ranking":{"get":{"summary":"Board page (all-time, or window=24h for the Today board)","parameters":[{"name":"page","in":"query","schema":{"type":"integer"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"window","in":"query","schema":{"type":"string","enum":["all","24h"]},"description":"24h: rank by τ paid in the past 24 hours"}],"responses":{"200":{"description":"entries, rankedBids, totalCount, categories, taoUsd"}}}},"/api/quote":{"get":{"summary":"Price a rank or rank an amount","parameters":[{"name":"rank","in":"query","schema":{"type":"integer"}},{"name":"amountRao","in":"query","schema":{"type":"integer"}},{"name":"identity","in":"query","schema":{"type":"string"},"description":"URL, sn64, ss58 or @handle; accounts for an existing listing"},{"name":"netuid","in":"query","schema":{"type":"integer"},"description":"Add alpha quantity at this subnet's pool price"},{"name":"window","in":"query","schema":{"type":"string","enum":["all","24h"]},"description":"24h: price against the Today board"}],"responses":{"200":{"description":"rank, amountRao, chargeRao, usd, alpha?"}}}},"/api/checkout":{"post":{"summary":"Create a checkout (list or raise)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"example":{"input":"sn64","categorySlug":"inference-llm","amountRao":80000000,"rail":"alpha","payNetuid":64,"src":"agent"},"properties":{"chargeRao":{"type":"integer","description":"Instead of amountRao: pay exactly this much more. Counts on the Today board and the all-time board."},"input":{"type":"string","description":"URL, sn64, ss58 or @handle"},"categorySlug":{"type":"string","description":"Primary category; required for new listings"},"categorySlugs":{"type":"array","items":{"type":"string"},"description":"Up to two extra categories. Subnet listings are always tagged 'subnets' too."},"amountRao":{"type":"integer","description":"Desired total on the board, in rao"},"rail":{"type":"string","enum":["tao","alpha","locked_alpha"],"default":"tao"},"netuid":{"type":"integer","description":"Subnet whose alpha you pay with (alpha rails)"},"src":{"type":"string","description":"Referral / channel tag"}}}}}},"responses":{"201":{"description":"Checkout","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["open","paid","expired","unmatched"]},"identityType":{"type":"string","enum":["subnet","hotkey","website","x"]},"identityKey":{"type":"string"},"displayName":{"type":"string"},"rail":{"type":"string","enum":["tao","alpha","locked_alpha"]},"payNetuid":{"type":"integer","nullable":true},"amountRao":{"type":"integer","description":"Amount in rao (1 τ = 1e9 rao)"},"assetQuantity":{"type":"integer","description":"Exact rao (TAO) or alpha-rao to send, including a unique suffix"},"priceRaoPerAlpha":{"type":"number","nullable":true},"remark":{"type":"string"},"treasuryColdkey":{"type":"string"},"treasuryLockHotkey":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"},"txHash":{"type":"string","nullable":true},"rankAfter":{"type":"integer","nullable":true},"instructions":{"type":"object","properties":{"btcli":{"type":"string"},"python":{"type":"string"}}},"url":{"type":"string"}}}}}},"400":{"description":"Validation error { error }"}}}},"/api/checkout/{id}":{"get":{"summary":"Checkout status","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Checkout","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["open","paid","expired","unmatched"]},"identityType":{"type":"string","enum":["subnet","hotkey","website","x"]},"identityKey":{"type":"string"},"displayName":{"type":"string"},"rail":{"type":"string","enum":["tao","alpha","locked_alpha"]},"payNetuid":{"type":"integer","nullable":true},"amountRao":{"type":"integer","description":"Amount in rao (1 τ = 1e9 rao)"},"assetQuantity":{"type":"integer","description":"Exact rao (TAO) or alpha-rao to send, including a unique suffix"},"priceRaoPerAlpha":{"type":"number","nullable":true},"remark":{"type":"string"},"treasuryColdkey":{"type":"string"},"treasuryLockHotkey":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"},"txHash":{"type":"string","nullable":true},"rankAfter":{"type":"integer","nullable":true},"instructions":{"type":"object","properties":{"btcli":{"type":"string"},"python":{"type":"string"}}},"url":{"type":"string"}}}}}}}},"patch":{"summary":"Re-quote on another rail","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["rail"],"properties":{"rail":{"type":"string","enum":["tao","alpha","locked_alpha"]},"netuid":{"type":"integer"}}}}}},"responses":{"200":{"description":"Checkout"}}}},"/api/treasury":{"get":{"summary":"Treasury coldkey, lock hotkey, RPC endpoints, rules","responses":{"200":{"description":"ok"}}}},"/api/categories/top":{"get":{"summary":"Top N per category","responses":{"200":{"description":"ok"}}}},"/api/activity":{"get":{"summary":"Latest confirmed bids","responses":{"200":{"description":"ok"}}}},"/api/revenue":{"get":{"summary":"τ taken since launch","responses":{"200":{"description":"ok"}}}},"/api/stats":{"get":{"summary":"Online now, visitors since launch, listings, revenue","responses":{"200":{"description":"ok"}}}},"/api/clicks":{"post":{"summary":"Record an outbound click","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"listingId":{"type":"string"}}}}}},"responses":{"200":{"description":"{ clickCount }"}}}}}}