Docs › Build with Beluga › API reference › Bridge orders

Create deposit

Start a bridge deposit XMR → XMR2. Returns the order ID; the one-time Monero subaddress follows within about 20 seconds.

POST/api/deposit

The order starts in state new. Poll Get order until depositAddress is set (state awaiting_deposit), then send XMR to it within 120 minutes. XMR2 is sent to hlAddress after 5 confirmations (10 for deposits of 200 XMR or more; see confsNeeded). Not idempotent: every call creates a new order.

Request body

JSON, Content-Type: application/json, max 4 KB.

Name	Type	Description
`hlAddress`required	string	Hyperliquid address that receives XMR2: `0x` + 40 hex characters.

Responses

201Order created.

Field	Type	Description
`id`	string	Order ID. Store it; it is the only handle to the order.
`note`	string	Human-readable next step.

400Invalid address or malformed JSON.

{
  "error": "hlAddress must be 0x + 40 hex"
}

429Rate limit reached; retry after the current minute.

{
  "error": "rate limit"
}