Create a coinflip table

Create a coinflip-table order: stake one asset, flip after confirmation, a win pays the same asset (supply your own sessionId only with a valid integrator key).

Authentication: None required. Optional: integrator key in X-Integrator-Key.

#Request body

• asset · "xmr" · "btc" · "sol" · "eth" · "zec" · required — Coinflip-table pool asset key, never a display symbol.
• toAddress · string — Same-chain native address the balance is paid to. Optional at open: name it at cash-out instead.
• sessionId · string (pattern ^[0-9a-f-]{16,64}$) — Optional session credential for an integrator to group its own orders. Requires a valid integrator API key.
• refundAddress · string (max 256) — Refund destination. Its chain-specific validity is checked by the engine.

#Response

200 returns an object with:

• orderId · string · required
• sessionId · string · required
• product · "coinflip" · required
• asset · "xmr" · "btc" · "sol" · "eth" · "zec" · required — Coinflip-table pool asset key, never a display symbol.
• maxPayoutUsd · number
• status · "awaiting_deposit" · "awaiting_xmr1" · "awaiting_trx1" · "awaiting_zec1" · "processing" · "completed" · "failed" · "expired" · "refunded" · "needs_review" · required
• customerState · one of the variants below · required — Authoritative customer display/action state. Clients must not infer lifecycle from status or resource presence.
  • kind = "awaiting_deposit"
  • kind = "processing"
  • kind = "action_required"
  • kind = "paused"
  • kind = "completed"
  • kind = "refunded"
  • kind = "expired"
  • kind = "failed"
• destination · string
• depositAddress · string · required
• depositAddressForms · array of object
  • kind · "shielded" · "transparent" · required
  • address · string · required
• expiresAt · string · required
• minAtomic · string · required — Smallest accepted stake, in atomic units of the asset.
• feePercent · number · required — Intake fee percent skimmed from the stake before the flip.
• edgePercent · number · required — House band percent; the win chance per side is (100 − edge) / 2.

Errors use the standard error envelope: branch on code, never on the message.

#Example

curl -X POST 'https://api-beta.wagyu.xyz/v2/coinflips' \
  -H 'content-type: application/json' \
  -d '{
    "asset": "xmr",
    "toAddress": "<your-monero-address>"
  }'

const res = await fetch('https://api-beta.wagyu.xyz/v2/coinflips', {
  method: 'POST',
  headers: {"content-type":"application/json"},
  body: JSON.stringify({
    "asset": "xmr",
    "toAddress": "<your-monero-address>"
  }),
});
const data = await res.json();

import requests

res = requests.post('https://api-beta.wagyu.xyz/v2/coinflips', json={
        "asset": "xmr",
        "toAddress": "<your-monero-address>"
    }, timeout=30)
data = res.json()

No response is captured for this route: calling it creates or changes a real order. The response fields above come from the live contract.