Skip to content
OCTHERA

Developers

API documentation

The full reference for both integrations: endpoints, the wallet contract, signatures, errors and testing. API keys, your wallet or callback URL and sandbox testing live in the company portal.

Start here / Two integrations

Two integrations

Octhera connects to your platform in one of two ways. Your company uses one of them, chosen when your account was created; the menu marks it as Your integration. Both are documented here so you can compare them.

Company wallet · API v2

Your wallet keeps the balances. You launch a game with your player's id and current balance; Octhera calls your Wallet URL for every bet (a debit you accept or refuse at once) and sends every win and refund to it until your wallet accepts it. No player registration, no deposits at Octhera. Best when you already run a wallet with other game providers, so each player keeps one balance.

Hosted wallet · API v1

Octhera keeps the balances. You register players, fund them in the portal, launch games, and receive a signed webhook for every bet, win, refund and withdrawal step. Best when you do not run a wallet of your own.

The same in both

  1. API keys and the IP allowlist (API keys page), and the Lobby URL (Settings).
  2. The game catalog: GET /games and GET /games/providers.
  3. Your Octhera balance and its GGR fee (Billing), and Reports.

Base URLs

Value
Company wallet: https://api.octhera.org/api/v2
Hosted wallet:  https://api.octhera.org/api/v1

Changing integration

Octhera can switch your company to the other integration only while it has no players. Each API only answers keys of its own integration: the other returns 403.

Need help integrating? Contact Tech Support

Get started

Ready to integrate?

Sandbox access is issued after a short conversation about your platform and markets. Existing companies sign in to the portal for their keys.

Prefer to write directly? Email sales@octhera.org or message our team on Telegram.