Skip to content

HivePredict is now in English

We picked this from your browser settings. You can switch any time from the bottom of every page.

Or choose another language

Endpoints

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. Each market in a list (here and in the feeds below) carries recentPredictors: up to three accounts with an open stake, most recent first.
  • /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

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

Platform

  • /stats: platform totals (markets, volume, predictions, users, payouts). totalVolume adds pools across every token; totalVolumeHive counts HIVE pools only. totalPredictors counts accounts that have placed a prediction; totalUsers also counts accounts that have only signed in.
  • /payouts/recent: the latest winnings sent on-chain, with the winner, amount, transaction id and market. limit defaults to 5, up to 20.
  • /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.