Endpoints

All paths are relative to https://hivepredict.app/api. Every endpoint is GET. For the always-current list, fetch /api/public.

Markets

/markets: list markets. Query: status, category, token, search, sort, page, limit.
/markets/featured, /markets/new, /markets/open, /markets/trending, /markets/ending-soon: curated open-market feeds.
/markets/resolved and /markets/closed: finished markets with outcomes.
/markets/:id: full market detail including per-outcome pools (outcomePools), participant count and trading cutoff.
/markets/:id/predictions, /markets/:id/payouts, /markets/:id/comments, /markets/:id/proofs: per-market history.
/markets/:id/snapshots?range=7d: probability history for charting odds movement.
/markets/:id/stake/:username: one user's stake totals in one market.
/markets/:id/holders: the five largest open stakes on each outcome.
/markets/quote?asset=bitcoin: live USD price for a coin or commodity offered when creating a price market.

/users/:username: profile and prediction stats.
/users/:username/predictions and /users/:username/markets: prediction history and created markets.
/users/:username/positions: open positions grouped by market.
/users/:username/eligibility: whether the account can bet or create markets.
/users/:username/follow: follower count.
/users/:username/referrals: who referred the account, how many accounts it has referred and its referral earnings per token.

/stats: platform totals (markets, volume, predictions, users, payouts).
/leaderboard: ranked boards. Query: board (accuracy, profit, volume, creators), period (weekly, monthly, all), limit.
/activity: the public activity feed. Query: types, marketId, account, page, limit.
/categories and /tokens: market categories and supported betting tokens.
/prices: HIVE and HBD prices in USD from CoinGecko, cached for five minutes. A price is null when CoinGecko could not be reached.
/sports/:league/events: upcoming fixtures for supported leagues.
/tipping: open, in-progress and recently settled tipping competitions.
/tipping/:slug: one competition with its fixtures and ladder.
/tipping/:slug/entries/:username: one entrant’s tips and points.
/health: service health.