Provider API

Sandbox — virtual credits only

One shared order book, many front-ends. Send your users' orders through this API and they match against every other provider's flow and the seed market maker — the tightest available spread, without you running a book.

This sandbox exists to prove matching quality. It settles in virtual credits and involves no real money, no wagering and no financial obligation. Real-money deployment would require the relevant licences and is out of scope here.

Authentication

Every request carries your provider key in an X-API-Key header. Keys are issued by us and shown once; we store only their hash. Each provider gets a namespace, so your client_ref values never collide with another provider's.

Endpoints

GET/v1/provider/meKey identity and tier.

GET/v1/provider/marketsTradable markets with live spread, depth and 24h flow.

GET/v1/provider/markets/{id}/bookAggregated depth per price level.

POST/v1/provider/ordersPlace a market or limit order for one of your users.

DELETE/v1/provider/orders/{id}Cancel a resting order (yours only).

GET/v1/provider/clients/{ref}That user's balance, positions and open orders.

Place an order

curl -X POST https://api.oddrail.com/v1/provider/orders \
  -H "X-API-Key: odr_your_key" \
  -H "content-type: application/json" \
  -d '{
    "client_ref": "user-4821",
    "contract_id": 1,
    "intent": "buy_yes",
    "order_type": "market",
    "qty": 25
  }'

{
  "client_ref": "user-4821",
  "order": { "id": 812, "intent": "buy_yes", "price": 32.0,
             "qty": 25, "remaining": 0 },
  "fills": [ { "price": 31.5, "qty": 10 },
             { "price": 32.0, "qty": 15 } ],
  "balance": 9207.5,
  "market": { "best_bid": 30.0, "best_ask": 32.5, "spread": 2.5,
              "bid_depth": 250, "ask_depth": 225, "volume_24h": 610 }
}

Pricing and the seed market maker

Contracts pay 100 credits when the answer is yes, 0 when no, so a price is a probability. Our model quotes both sides of every market as seed liquidity, so your first user never faces an empty book; as real flow arrives, the model steps aside.

Venue liquidity

Get a key

Sandbox keys are issued manually while we validate demand. Tell us the integration you have in mind and we will set up a namespace.

Fully virtual simulation for entertainment and education. Credits have no monetary value and cannot be bought, sold, or redeemed. Not betting, financial, or investment advice. 18+