Rest API


Hxro provides a self hosted REST API as a Docker container for those who wish to continue running their trading bots or build on top of the parimutuel protocol without having to rewrite to a web3 interface.

How to get it

The image is available on our public registry This remains in preview mode and is generally automatically updated by our CI/CD pipelines subject to our tests passing. While the endpoints are now mostly stable, minor changes might still occur, we will aim to announce those on our Discord.


Configuration of the API server is done via passing environment variables in the usual way when creating a container. The following parameters are supported:
  • VALIDATOR_URL: A URL to a public or private validator (for Devnet or Mainnet accordingly)
  • PROGRAM_ID: The program id on devnet is 3kjK4HA6A4K86NgNB93gGhSt257wtN4QAqXMNPQ4fVTm and on mainnet is GUhB2ohrfqWspztgCrQpAmeVFBWmnWYhPcZuwY52WWRe
  • PRIVATE_KEY: The private key for the owner of the system account that will be used to pay for transactions and which owns the ATAs holding the settlement token (USDC) and any HXRO tokens. Note you can get an airdrop for both using our devnet UI, see Web3 Example UI (Devnet Version) for more information.
  • CORS: Set to true to allow cross origin requests.


The REST API attempts to replicate the existing API described here at Currently the following endpoints are supported:
  • GET /api/contestseries/running
  • GET /api/contests/by-series/<id>
  • GET /api/contests/<id>
  • POST /api/ContestEntry/add-contest-entry
  • GET /api/ContestEntry/by-user-entry/<user_id>/<entry_id>
  • GET /api/ContestEntry/by-user/<user_id>

Comments, Feedback, Suggestions

Please find us on the #dev-chat channel on Discord at