API reference
List a session’s orders
GET
/v2/ordersList 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 · requiredorderId· string · requiredproduct·"swap"·"bridge"·"coinflip"· requiredstatus·"awaiting_deposit"·"awaiting_xmr1"·"awaiting_trx1"·"awaiting_zec1"·"processing"·"completed"·"failed"·"expired"·"refunded"·"needs_review"· requiredasset·"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 · requireddepositAddress· string or null · requiredcreatedAt· string or null · requiredupdatedAt· string or null · requiredfromChainId· integer or null — Non-negative integer chain identifier.depositChainId· integer or null — Non-negative integer chain identifier.fromToken· stringdepositToken· stringfromTokenSymbol· stringdepositTokenSymbol· stringfromTokenDecimals· integer (0–36)depositTokenDecimals· integer (0–36)fromAmount· stringdepositAmount· stringtoChainId· integer or null — Non-negative integer chain identifier.toToken· stringtoTokenSymbol· stringtoTokenDecimals· integer (0–36)expectedOutput· stringdepositTxHash· string or nullreceivingTxHash· string or nullsessionId· string or nullrefundAddress· string or nullrefundRequestedAt· string or nullexpiresAt· stringamountUsd· numberbonusStage·"none"·"coinflip"coinflipRequested· booleanfundingProvider·"privy"or nullintegratorFeeUsd· 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": []
}