Open app

API reference

Markdown

List a session’s orders

GET/v2/orders

List orders owned by a session.

Authentication: Required: the order’s owner session in X-Session-ID.

A session with no orders returns { "orders": [] }. Without X-Session-ID, or with a malformed one, the API answers 400 invalid_request (checked live).

#Parameters

Name In Type Required Description
limit query integer (1–200) No (default 200) Page size for this session's order history.
offset query integer No (default 0) Number of orders to skip. History is ordered most-recent first, so this pages backwards through it.

#Response

200 returns an object with:

  • orders · array of object · required
    • orderId · string · required
    • product · "swap" · "bridge" · "coinflip" · required
    • status · "awaiting_deposit" · "awaiting_xmr1" · "awaiting_trx1" · "awaiting_zec1" · "processing" · "completed" · "failed" · "expired" · "refunded" · "needs_review" · required
    • asset · "xmr" · "trx" · "zec" — Registered native-bridge asset key, never a display symbol.
    • direction · "deposit" · "withdraw" — deposit mints the wrapped asset from a native-coin deposit; withdraw returns the native coin against the wrapped asset.
    • chainId · integer or null · required — Non-negative integer chain identifier.
    • toAddress · string or null · required
    • depositAddress · string or null · required
    • createdAt · string or null · required
    • updatedAt · string or null · required
    • fromChainId · integer or null — Non-negative integer chain identifier.
    • depositChainId · integer or null — Non-negative integer chain identifier.
    • fromToken · string
    • depositToken · string
    • fromTokenSymbol · string
    • depositTokenSymbol · string
    • fromTokenDecimals · integer (0–36)
    • depositTokenDecimals · integer (0–36)
    • fromAmount · string
    • depositAmount · string
    • toChainId · integer or null — Non-negative integer chain identifier.
    • toToken · string
    • toTokenSymbol · string
    • toTokenDecimals · integer (0–36)
    • expectedOutput · string
    • depositTxHash · string or null
    • receivingTxHash · string or null
    • sessionId · string or null
    • refundAddress · string or null
    • refundRequestedAt · string or null
    • expiresAt · string
    • amountUsd · number
    • bonusStage · "none" · "coinflip"
    • coinflipRequested · boolean
    • fundingProvider · "privy" or null
    • integratorFeeUsd · number or null

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

#Example

curl
curl 'https://api-beta.wagyu.xyz/v2/orders' \
  -H 'x-session-id: <your-session-id>'
JavaScript
const res = await fetch('https://api-beta.wagyu.xyz/v2/orders', {
  headers: {"x-session-id":"<your-session-id>"},
});
const data = await res.json();
Python
import requests

res = requests.get('https://api-beta.wagyu.xyz/v2/orders', headers={"x-session-id":"<your-session-id>"}, timeout=30)
data = res.json()
Response · 200 · captured 4 Nov 2026, 08:24 UTC
{
  "orders": []
}

Tip: every page is also plain Markdown, and /llms.txt indexes them for AI tools.