HivePredict
API Overview

API Overview

HivePredict exposes a free, read-only public API over the same endpoints the web app uses. No API key or registration is required. Use it to build bots, dashboards, Hive dApp integrations, or anything else that needs live market data.

Base URL

https://hivepredict.app/api

Ground Rules

  • Read-only: only GET, HEAD and OPTIONS requests are accepted. Writes happen on the Hive blockchain, not through this API. To place a prediction or create a market programmatically, broadcast the corresponding transfer and custom_json operations to Hive directly.
  • JSON everywhere: every endpoint returns application/json.
  • Rate limits: endpoints are rate limited per IP, typically 60 to 240 requests per minute depending on the endpoint. Back off when you receive HTTP 429.
  • Pagination: list endpoints accept page (from 1) and limit query parameters and return total, page and limit alongside the rows.
  • CORS: enabled, so you can call the API straight from a browser.

Machine-Readable Manifest

The API describes itself at /api/public: a JSON manifest listing every public endpoint and its query parameters. If you are building a client, start there. It always reflects the deployed API.

Data Freshness

The API serves data from the platform indexer, which streams Hive blocks as they are produced, so responses typically lag the chain head by a few seconds. The blockchain remains the source of truth: every market, prediction and payout links back to on-chain transactions you can verify independently.