Interactive API reference

Explore the production API and try synthetic requests in the free sandbox. Existing API endpoints and integrations stay unchanged.

From sandbox to your first real order

Try a safe example first, then connect your own server in five steps.

Try it out works only in the sandbox below. Production reference is read-only; send real API requests from your server.

  1. Try a free test

    In the sandbox below, click Create session. Open an operation, then choose Try it out → Execute. Only test data and TEST_USDT are used; no real money is spent.

  2. Create your real API key

    Open the API key section in your profile. Create a key and complete the requested password/2FA check. Save the full key when it appears. Keep it only on your server, never in browser code or on this page.

  3. Check access from your server

    Use the base URL below and send your key in the X-API-Key header. First call GET /me or GET /balance to check access without creating an order.

  4. Choose a real product

    Call GET /catalog, then GET /catalog/{game_key}. Select the correct product and region. Use its returned game_key, variation_id and required inputs, such as player_id or zone_id. Do not send sandbox keys, sandbox_game, sandbox_pack or scenario.

  5. Create the order and check the result

    Make sure your real balance covers the price. Send POST /order as JSON with a unique Idempotency-Key for each new order. If the request times out, retry the exact same payload with the same key; do not create a new key for that retry.

    HTTP 201 means the order was created, not delivered. Check GET /order/{id}, or verify the signature of its webhook. Only COMPLETED confirms completion; also handle failed or refunded results.

Real API base URL

https://api.ludovex.org/api/v2

Set LUDOVEX_API_KEY as an environment variable on your own server. This example is text only; do not paste your real key into this page.

Try the sandbox belowOpen API key settingsRead the full integration guide

First read-only check: GET /balance

curl --fail-with-body "https://api.ludovex.org/api/v2/balance" \
  -H "X-API-Key: $LUDOVEX_API_KEY" \
  -H "Accept: application/json"

Synthetic catalogue, test balance and simulated orders. These fixtures are not a simulation of every production endpoint. No real money, provider calls or external webhook delivery.

Temporary test session

Use this page’s Create session button to connect the sandbox automatically. It supplies a temporary test key in memory; you do not need to paste a key.

Create a session to try session-protected operations.

Executing POST /sessions below creates a separate session. Use the page button above for automatic connection.

Endpoint names, schema fields and the Swagger viewer’s technical controls use the API’s English terminology.

Open this OpenAPI JSON

Loading the API reference…

Swagger UI 5.34.0 · Apache 2.0 license
Interactive API reference | Ludovex