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.

/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.

/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.
/sports/:league/events: upcoming fixtures for supported leagues.
/health: service health.