{"name":"HivePredict Public API","readOnly":true,"methods":["GET","HEAD","OPTIONS"],"endpoints":[{"method":"GET","path":"/api/health","description":"Service health"},{"method":"GET","path":"/api/markets","description":"List markets","query":["status","category","token","marketGroup","sort","page","limit"]},{"method":"GET","path":"/api/markets/featured","description":"Featured markets"},{"method":"GET","path":"/api/markets/new","description":"Newest open markets","query":["category","token","marketGroup","page","limit"]},{"method":"GET","path":"/api/markets/open","description":"Open markets feed","query":["category","token","marketGroup","sort","page","limit"]},{"method":"GET","path":"/api/markets/trending","description":"Open markets with the most bets in the last seven days","query":["category","token","marketGroup","page","limit"]},{"method":"GET","path":"/api/markets/ending-soon","description":"Open markets closing soonest","query":["category","token","marketGroup","page","limit"]},{"method":"GET","path":"/api/markets/resolved","description":"Recently resolved markets","query":["category","token","marketGroup","page","limit"]},{"method":"GET","path":"/api/markets/closed","description":"Finalized markets (resolved, voided, cancelled)","query":["category","token","marketGroup","page","limit"]},{"method":"GET","path":"/api/markets/:id","description":"Market detail"},{"method":"GET","path":"/api/markets/:id/predictions","description":"Predictions in a market","query":["page","limit"]},{"method":"GET","path":"/api/markets/quote","description":"Live USD price for an asset offered in the create flow (cached five minutes)","query":["asset"]},{"method":"GET","path":"/api/markets/:id/holders","description":"Largest open stakes on each outcome of a market"},{"method":"GET","path":"/api/markets/:id/payouts","description":"Payouts for a market","query":["page","limit"]},{"method":"GET","path":"/api/markets/:id/snapshots","description":"Market probability snapshots","query":["range"]},{"method":"GET","path":"/api/markets/:id/comments","description":"Market comments","query":["page","limit"]},{"method":"GET","path":"/api/markets/:id/proofs","description":"Manual market proofs","query":["page","limit","username"]},{"method":"GET","path":"/api/markets/:id/stake/:username","description":"User stake totals in one market"},{"method":"GET","path":"/api/activity","description":"Platform activity feed","query":["types","marketId","account","mine","page","limit"]},{"method":"GET","path":"/api/users/:username","description":"User profile and stats"},{"method":"GET","path":"/api/users/:username/eligibility","description":"Eligibility check","query":["action"]},{"method":"GET","path":"/api/users/:username/safety","description":"User safety controls and history"},{"method":"GET","path":"/api/users/:username/predictions","description":"User prediction history","query":["page","limit"]},{"method":"GET","path":"/api/users/:username/achievements","description":"Prediction streaks and milestone badges"},{"method":"GET","path":"/api/users/:username/markets","description":"Markets created by a user","query":["page","limit"]},{"method":"GET","path":"/api/users/:username/positions","description":"Open positions and created markets needing attention"},{"method":"GET","path":"/api/users/:username/referrals","description":"Referrer, referred user counts and referral earnings"},{"method":"GET","path":"/api/users/:username/xp","description":"XP, level and how the XP was earned"},{"method":"GET","path":"/api/users/:username/follow","description":"Follower count and follow status","query":["viewer"]},{"method":"GET","path":"/api/stats","description":"Platform-wide stats"},{"method":"GET","path":"/api/leaderboard","description":"Ranked user boards (accuracy, profit, volume, creators, xp)","query":["board","period","limit"]},{"method":"GET","path":"/api/tokens","description":"Supported betting tokens"},{"method":"GET","path":"/api/tokens/balance/:username/:symbol","description":"Token balance lookup (best-effort preflight)"},{"method":"GET","path":"/api/categories","description":"Market categories"},{"method":"GET","path":"/api/sports/:league/events","description":"Upcoming sports events"},{"method":"GET","path":"/api/tipping","description":"Open, in-progress and recently settled tipping competitions"},{"method":"GET","path":"/api/tipping/:slug","description":"One tipping competition with its fixtures and ladder"},{"method":"GET","path":"/api/tipping/:slug/entries/:username","description":"One entrant's tips and points in a tipping competition"},{"method":"GET","path":"/api/prices","description":"HIVE and HBD prices in USD (CoinGecko, cached five minutes)"},{"method":"GET","path":"/api/transparency","description":"Platform financials: volume, fees, payouts, recent on-chain transfers"}],"onChainWrites":{"placePrediction":{"docs":"/docs/api/place-predictions","operationId":"hivepredict_place_prediction","authority":"active","sameTransaction":true,"amountPrecision":3,"minimumAmount":"1.000","platformAccount":"hivepredict","requirements":{"marketStatuses":["pending","active"],"beforeField":"tradingCutoff","tokenField":"token","outcomeField":"outcomes"},"preflight":{"market":"/api/markets/{marketId}","eligibility":"/api/users/{username}/eligibility?action=predict","tokens":"/api/tokens"},"nativeTransferOperation":{"operation":"transfer","tokens":["HIVE","HBD"],"fields":{"from":"{username}","to":"hivepredict","amount":"{amount} {token}","memo":"{marketId}:{outcome}"}},"hiveEngineTransferOperation":{"operation":"custom_json","customJsonId":"ssc-mainnet-hive","requiredAuths":["{username}"],"requiredPostingAuths":[],"jsonPayload":[{"contractName":"tokens","contractAction":"transfer","contractPayload":{"symbol":"{token}","to":"hivepredict","quantity":"{amount}","memo":"{marketId}:{outcome}","isSignedWithActiveKey":true}}]},"predictionOperation":{"operation":"custom_json","requiredAuths":["{username}"],"requiredPostingAuths":[],"id":"hivepredict_place_prediction","jsonPayload":{"market_id":"{marketId}","outcome":"{outcome}","amount":"{amount} {token}","tx_id":""},"optionalFields":{"referrer":"Hive username of the account that referred the bettor. Only honoured on the bettor's first indexed prediction, when it is a valid existing user other than the bettor or the platform account. Ignored otherwise."}},"confirmation":"/api/markets/{marketId}/predictions"},"claimReferrer":{"operationId":"hivepredict_claim_referrer","authority":"active","operation":{"operation":"custom_json","requiredAuths":["{username}"],"requiredPostingAuths":[],"id":"hivepredict_claim_referrer","jsonPayload":{"referrer":"{referrer}"}},"rules":"Records a referrer before the first bet, for accounts that cannot bet yet. Honoured only when the account has no referrer, no predictions and no tipping entries, and the referrer is an existing user other than the account or the platform account. The referral window starts at the first bet or tipping entry.","confirmation":"/api/users/{username}/referrals"}},"notes":["REST endpoints are read-only.","Financial writes must be signed by the user and broadcast to Hive."]}