{"openapi":"3.1.1","info":{"title":"Wagyu Consumer API","version":"v2","description":"Public HTTP contract for building a Wagyu swap and native-bridge client. Order IDs are not credentials; retain the returned session ID privately. WebSocket updates are documented separately because REST remains the durable source of truth."},"components":{"securitySchemes":{"orderSession":{"type":"apiKey","in":"header","name":"x-session-id","description":"Owner credential returned when an order is created. Keep it private and send it only in this header, never in a URL."},"destinationProof":{"type":"apiKey","in":"query","name":"verify","description":"Read-only proof for one order: its exact destination address. Missing or invalid proof intentionally returns the same 404 as a missing order."},"integratorKey":{"type":"apiKey","in":"header","name":"x-integrator-key","description":"Optional integration credential. It does not unlock the API — quoting, creating and tracking all work without it. It attributes the order to your integration, collects your integrator fee, and is what permits a caller-supplied sessionId at creation. A confidential (server-side) key may also end the deposit wait of the orders created by its own integration. `x-api-key` is accepted as an alias; a key in the query string is refused even when valid, so a credential can never reach a proxy log. Sending no key is anonymous, never an error. A key that is present but invalid, revoked, or belongs to a suspended integration is refused with 401 on every route rather than silently downgraded to anonymous, and that 401 carries the generic unauthorized body — the reason stays in our logs."}},"schemas":{}},"paths":{"/v2/bridges/terms":{"get":{"operationId":"getBridgeTerms","summary":"Read bridge fees and minimums","tags":["Bridge"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"fees":{"type":"object","properties":{"depositFeeRate":{"type":"number"},"withdrawalFeeRate":{"type":"number"},"withdrawalFlat":{"type":"object","propertyNames":{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},"additionalProperties":{"type":"number"},"description":"Flat fee on a direct withdrawal, per asset key, in that asset's coin units."},"withdrawalFlatXmr":{"type":"number","description":"Deprecated: read withdrawalFlat.xmr."},"withdrawalFlatTrx":{"type":"number","description":"Deprecated: read withdrawalFlat.trx."}},"required":["depositFeeRate","withdrawalFeeRate","withdrawalFlat","withdrawalFlatXmr","withdrawalFlatTrx"],"additionalProperties":false},"minimums":{"type":"object","propertyNames":{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},"additionalProperties":{"type":"number"},"description":"Per-asset floor on the GROSS sent amount, in coin units; fees are deducted from it."},"assets":{"description":"Every bridge asset this API knows, with its live availability. Read it before offering a rail: creating against an unavailable one answers 503 unavailable, not 400.","type":"array","items":{"type":"object","properties":{"key":{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},"deposit":{"type":"boolean","description":"Whether POST /v2/bridges accepts a deposit for this asset right now."},"withdraw":{"type":"boolean","description":"Whether POST /v2/bridges accepts a withdrawal for this asset right now."}},"required":["key","deposit","withdraw"],"additionalProperties":false}}},"required":["fees"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/swaps/terms":{"get":{"operationId":"getSwapTerms","summary":"Read the swap rules before creating an order: deposit window, minimum and confirmations per chain, partial deposits, default limits","tags":["Swaps"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"depositWindowMinutes":{"type":"number","exclusiveMinimum":0,"description":"How long a new order waits for its deposit, top-ups included. Each order states its own deadline as `expiresAt`; count down to that, not to this."},"chains":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"depositEnabled":{"type":"boolean","description":"Whether POST /v2/swaps accepts an order sending from this chain right now."},"minDepositUsd":{"type":"number","description":"Smallest order sending from this chain, in US dollars. A quote's `minDepositUsd` is the same value."},"confirmations":{"type":"object","properties":{"min":{"type":"integer","minimum":0,"maximum":9007199254740991},"max":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["min","max"],"additionalProperties":false,"description":"Confirmations a deposit from this chain needs before the order acts on it. Where min and max differ (Monero, Zcash), bigger deposits and busier periods need more. An order's own `requiredConfirmations` is the value that applies to it."}},"required":["chainId","depositEnabled","minDepositUsd","confirmations"],"additionalProperties":false},"description":"Every chain an order can send from, with its live availability."},"partialDeposit":{"type":"object","properties":{"executesFromPercent":{"type":"number","description":"A token deposit of at least this share of `depositAmount` counts as paid and executes on what arrived."},"noticeFromPercent":{"type":"number","description":"An arrival below this share of `depositAmount` is treated as stray dust: no short-deposit notice."},"continueFromUsd":{"type":"number","description":"When the top-up wait ends, a short deposit worth at least this many US dollars executes on what arrived. A smaller one expires and support returns it."}},"required":["executesFromPercent","noticeFromPercent","continueFromUsd"],"additionalProperties":false},"recoveryCheckMinutes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Longest wait before an order waiting on recovery (for example after a refund or payout address is submitted) is checked again. `null` when the check does not run on a fixed interval."},"integratorFee":{"type":"object","properties":{"maxPercent":{"type":"number","description":"Highest `integratorFeePercent` a quote or order accepts."}},"required":["maxPercent"],"additionalProperties":false},"defaultLimits":{"type":"object","properties":{"requestLimitPerMin":{"type":"integer","minimum":0,"maximum":9007199254740991},"quoteLimitPerMin":{"type":"integer","minimum":0,"maximum":9007199254740991},"createLimitPerMin":{"type":"integer","minimum":0,"maximum":9007199254740991},"maxOpenOrders":{"type":"integer","minimum":0,"maximum":9007199254740991},"openOrderWindowMinutes":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["requestLimitPerMin","quoteLimitPerMin","createLimitPerMin","maxOpenOrders","openOrderWindowMinutes"],"additionalProperties":false,"description":"Per-client limits that apply without an integrator key. An integration can have higher ones: GET /v2/integrator/me returns yours."}},"required":["depositWindowMinutes","chains","partialDeposit","recoveryCheckMinutes","integratorFee","defaultLimits"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/nodes":{"get":{"operationId":"listNodes","summary":"List recommended monerod endpoints for a self-custody wallet","tags":["Config"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"nodes":{"type":"array","items":{"type":"string"},"description":"monerod endpoints in priority order, as `host:port` or a full URL. No liveness is implied: try them in order and fail over client-side."}},"required":["nodes"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/bridges/quote":{"get":{"operationId":"quoteBridge","summary":"Quote the net settlement for a bridge amount","tags":["Bridge"],"parameters":[{"schema":{"type":"string","enum":["xmr","trx","zec"]},"in":"query","name":"asset","required":true,"description":"Registered native-bridge asset key, never a display symbol."},{"schema":{"type":"string","enum":["deposit","withdraw"]},"in":"query","name":"direction","required":true,"description":"deposit mints the wrapped asset from a native-coin deposit; withdraw returns the native coin against the wrapped asset."},{"schema":{"type":"string","pattern":"^0*[1-9][0-9]*$"},"in":"query","name":"amount","required":true,"description":"Positive base-10 integer in the asset’s atomic unit."},{"schema":{"type":"string"},"in":"query","name":"senderAddress","required":false,"description":"Withdrawals only. The Hyperliquid address returning the wrapped asset, used to resolve that sender's fee override. The settled amount is re-derived from the verified sender."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"asset":{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},"direction":{"type":"string","enum":["deposit","withdraw"],"description":"deposit mints the wrapped asset from a native-coin deposit; withdraw returns the native coin against the wrapped asset."},"grossAtomic":{"type":"string"},"netAtomic":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Amount actually settled, in atomic units. Null exactly when `belowMinimum` is true."},"feeAtomic":{"anyOf":[{"type":"string"},{"type":"null"}]},"flatFeeAtomic":{"anyOf":[{"type":"string"},{"type":"null"}]},"percentFeeAtomic":{"anyOf":[{"type":"string"},{"type":"null"}]},"feePercent":{"anyOf":[{"type":"number"},{"type":"null"}]},"minimumAtomic":{"type":"string"},"belowMinimum":{"type":"boolean"},"available":{"description":"Whether POST /v2/bridges accepts this asset and direction right now.","type":"boolean"}},"required":["asset","direction","grossAtomic","netAtomic","feeAtomic","flatFeeAtomic","percentFeeAtomic","feePercent","minimumAtomic","belowMinimum"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/swaps/assets":{"get":{"operationId":"getSwapAssets","summary":"List available swap chains and featured assets","tags":["Swaps"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"chains":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"key":{"type":"string"},"name":{"type":"string"},"logoURI":{"type":"string"}},"required":["id","key","name"],"additionalProperties":false}},"sourceChainIds":{"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."}},"destinationChainIds":{"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."}},"featuredTokens":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36},"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"name":{"type":"string"},"logoURI":{"type":"string"},"priceUSD":{"type":"string"}},"required":["address","symbol","decimals","chainId","name"],"additionalProperties":false}},"catalogStale":{"type":"boolean"}},"required":["chains","sourceChainIds","destinationChainIds","featuredTokens"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/swaps/assets/tokens":{"get":{"operationId":"getSwapAssetTokens","summary":"Search or page available swap assets","tags":["Swaps"],"parameters":[{"schema":{"type":"string","enum":["from","to"]},"in":"query","name":"direction","required":true,"description":"\"from\" filters to tokens usable as a source, \"to\" to tokens usable as a destination."},{"schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"in":"query","name":"chainId","required":false,"description":"Restrict the search to one chain; omit to search every available chain."},{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"query","name":"q","required":false,"description":"Free-text filter on symbol, name, or address."},{"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"in":"query","name":"offset","required":false,"description":"Number of tokens to skip, for paging the filtered catalog."},{"schema":{"default":100,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false,"description":"Page size."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36},"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"name":{"type":"string"},"logoURI":{"type":"string"},"priceUSD":{"type":"string"}},"required":["address","symbol","decimals","chainId","name"],"additionalProperties":false}},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextOffset":{"type":"integer","minimum":0,"maximum":9007199254740991},"catalogStale":{"type":"boolean"}},"required":["tokens","total"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/swaps/quote":{"post":{"operationId":"quoteSwap","summary":"Quote an exact-input or exact-output swap","tags":["Swaps"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"fromChainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"toChainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"fromToken":{"description":"Token contract address on the corresponding chain. For a chain's native coin, send \"native\" or its native symbol.","type":"string"},"toToken":{"description":"Token contract address on the corresponding chain. For a chain's native coin, send \"native\" or its native symbol.","type":"string"},"fromTokenSymbol":{"description":"Optional symbol hint for the same token. Resolution is driven by the token address, not by this value.","type":"string"},"toTokenSymbol":{"description":"Optional symbol hint for the same token. Resolution is driven by the token address, not by this value.","type":"string"},"fromAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"toAddress":{"description":"Intended destination address. Optional for a quote: it only lets the router account for destination-specific costs.","type":"string"},"integratorFeePercent":{"description":"Optional integrator fee percentage. Requires a valid integrator API key.","type":"number","minimum":0,"maximum":5}},"required":["fromChainId","toChainId","fromAmount"],"additionalProperties":false},{"type":"object","properties":{"fromChainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"toChainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"fromToken":{"description":"Token contract address on the corresponding chain. For a chain's native coin, send \"native\" or its native symbol.","type":"string"},"toToken":{"description":"Token contract address on the corresponding chain. For a chain's native coin, send \"native\" or its native symbol.","type":"string"},"fromTokenSymbol":{"description":"Optional symbol hint for the same token. Resolution is driven by the token address, not by this value.","type":"string"},"toTokenSymbol":{"description":"Optional symbol hint for the same token. Resolution is driven by the token address, not by this value.","type":"string"},"toAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"toAddress":{"description":"Intended destination address. Optional for a quote: it only lets the router account for destination-specific costs.","type":"string"},"integratorFeePercent":{"description":"Optional integrator fee percentage. Requires a valid integrator API key.","type":"number","minimum":0,"maximum":5}},"required":["fromChainId","toChainId","toAmount"],"additionalProperties":false}]}}}},"security":[{},{"integratorKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"toAmount":{"type":"string"},"fromAmount":{"anyOf":[{"type":"string"},{"type":"null"}]},"fromAmountUsd":{"anyOf":[{"type":"string"},{"type":"null"}]},"fromSymbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"toAmountUsd":{"anyOf":[{"type":"string"},{"type":"null"}]},"toSymbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"toolUsed":{"anyOf":[{"type":"string"},{"type":"null"}]},"feeFraction":{"anyOf":[{"type":"number"},{"type":"null"}]},"feeBreakdown":{"anyOf":[{"type":"object","properties":{"platformFeeRate":{"anyOf":[{"type":"number"},{"type":"null"}]},"platformFeeXmr":{"anyOf":[{"type":"string"},{"type":"null"}]},"platformFeeUsd":{"anyOf":[{"type":"string"},{"type":"null"}]},"bridgeFlatFeeXmr":{"anyOf":[{"type":"string"},{"type":"null"}]},"bridgeFlatFeeUsd":{"anyOf":[{"type":"string"},{"type":"null"}]},"hlSizeRoundingXmr":{"anyOf":[{"type":"string"},{"type":"null"}]},"hlSizeRoundingUsd":{"anyOf":[{"type":"string"},{"type":"null"}]},"hlTakerFeeXmr":{"anyOf":[{"type":"string"},{"type":"null"}]},"hlTakerFeeUsd":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalFeeUsd":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalCostUsd":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"integratorFee":{"anyOf":[{"type":"object","properties":{"feePercent":{"type":"number"},"feeAmountUsd":{"type":"number"},"feeAddress":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["feePercent","feeAmountUsd"],"additionalProperties":false},{"type":"null"}]},"minDepositUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"isXmrInput":{"type":"boolean"},"isXmrOutput":{"type":"boolean"}},"required":["toAmount"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/swaps":{"post":{"operationId":"createSwapOrder","summary":"Create a durable swap order (supply your own sessionId only with a valid integrator key)","tags":["Swaps"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fromChainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"toChainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"fromToken":{"type":"string","minLength":1,"description":"Token contract address on the corresponding chain. For a chain's native coin, send \"native\" or its native symbol."},"toToken":{"type":"string","minLength":1,"description":"Token contract address on the corresponding chain. For a chain's native coin, send \"native\" or its native symbol."},"fromAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"toAddress":{"type":"string","minLength":1,"description":"Destination address. Its chain-specific validity is checked by the engine."},"fromTokenSymbol":{"description":"Optional symbol hint for the same token. Resolution is driven by the token address, not by this value.","type":"string"},"toTokenSymbol":{"description":"Optional symbol hint for the same token. Resolution is driven by the token address, not by this value.","type":"string"},"sessionId":{"description":"Optional session credential for an integrator to group its own orders. Requires a valid integrator API key.","type":"string","pattern":"^[0-9a-f-]{16,64}$"},"refundAddress":{"type":"string","minLength":1,"maxLength":256,"description":"Refund destination. Its chain-specific validity is checked by the engine."},"coinflip":{"description":"Opt into the bonus flip when this order is eligible. The decision itself is sent later to PUT /v2/swaps/{id}/coinflip.","type":"boolean"},"fundingProvider":{"description":"Fiat onramp that will fund this order, when the deposit comes from a card purchase instead of a wallet.","anyOf":[{"type":"string","enum":["privy"]},{"type":"null"}]},"integratorFeePercent":{"description":"Optional integrator fee percentage. Requires a valid integrator API key.","type":"number","minimum":0,"maximum":5},"clickId":{"description":"Google Ads click identifier, when this order came from an ad. Stored apart from the order, used once to report the conversion, then deleted; it is never published back on any order read.","type":"object","properties":{"kind":{"type":"string","enum":["gclid","wbraid","gbraid"]},"value":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,200}$"}},"required":["kind","value"],"additionalProperties":false},"source":{"description":"Where the visit that created this order came from. Marketing only: stored apart from the order, counted in reports, never published back on any order read.","type":"object","properties":{"utmSource":{"description":"The landing link's utm_source.","type":"string","pattern":"^[a-z0-9._-]{1,64}$"},"utmMedium":{"description":"The landing link's utm_medium.","type":"string","pattern":"^[a-z0-9._-]{1,64}$"},"utmCampaign":{"description":"The landing link's utm_campaign.","type":"string","pattern":"^[a-z0-9._-]{1,64}$"},"referrer":{"description":"Hostname of the site the visitor came from. Never a full URL.","type":"string","pattern":"^(?=.{1,253}$)[a-z0-9-]{1,63}(?:\\.[a-z0-9-]{1,63})+$"},"landing":{"description":"Path of the visit's first page.","type":"string","pattern":"^\\/[A-Za-z0-9/._-]{0,199}$"}},"additionalProperties":false}},"required":["fromChainId","toChainId","fromToken","toToken","fromAmount","toAddress"],"additionalProperties":false}}}},"security":[{},{"integratorKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"orderId":{"type":"string"},"product":{"type":"string","enum":["swap"]},"sessionId":{"type":"string","pattern":"^[0-9a-f-]{16,64}$","description":"16–64 character hexadecimal/hyphen owner-session credential."},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","awaiting_zec1","processing","completed","failed","expired","refunded","needs_review"]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","minimumDepositAmount"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["processing"]},"stage":{"type":"string","enum":["processing","confirming","routing","trading","sending","refunding"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["checking"]}},"required":["kind"],"additionalProperties":false}},"required":["kind","stage"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["action_required"]},"action":{"type":"string","enum":["coinflip","refund_address","payout_address"]}},"required":["kind","action"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["paused"]},"reason":{"type":"string","enum":["preparing_refund","below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["completed"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["refunded"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["expired"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["failed"]}},"required":["kind"],"additionalProperties":false}],"description":"Authoritative customer display/action state. Clients must not infer lifecycle from status or resource presence."},"depositAddress":{"type":"string"},"depositAddressForms":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["shielded","transparent"]},"address":{"type":"string"}},"required":["kind","address"],"additionalProperties":false}},"depositChainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"depositToken":{"type":"string"},"depositTokenSymbol":{"type":"string"},"depositTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"depositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"toChainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"toToken":{"type":"string"},"toTokenSymbol":{"type":"string"},"toTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"toAddress":{"type":"string"},"expectedOutput":{"anyOf":[{"type":"string"},{"type":"null"}]},"amountUsd":{"type":"number"},"expiresAt":{"type":"string"},"bonusStage":{"type":"string","enum":["none","coinflip"]},"coinflipRequested":{"type":"boolean"},"fundingProvider":{"anyOf":[{"type":"string","enum":["privy"]},{"type":"null"}]}},"required":["orderId","product","sessionId","status","customerState","depositAddress","depositChainId","depositToken","depositTokenSymbol","depositTokenDecimals","depositAmount","toChainId","toToken","toTokenSymbol","toTokenDecimals","toAddress","expectedOutput","amountUsd","expiresAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/bridges":{"post":{"operationId":"createBridgeOrder","summary":"Create a native bridge order for one asset and direction (supply your own sessionId only with a valid integrator key)","tags":["Bridge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"toAddress":{"type":"string","minLength":1,"description":"Destination address. Its chain-specific validity is checked by the engine."},"sessionId":{"description":"Optional session credential for an integrator to group its own orders. Requires a valid integrator API key.","type":"string","pattern":"^[0-9a-f-]{16,64}$"},"refundAddress":{"type":"string","minLength":1,"maxLength":256,"description":"Refund destination. Its chain-specific validity is checked by the engine."},"source":{"description":"Where the visit that created this order came from. Marketing only: stored apart from the order, counted in reports, never published back on any order read.","type":"object","properties":{"utmSource":{"description":"The landing link's utm_source.","type":"string","pattern":"^[a-z0-9._-]{1,64}$"},"utmMedium":{"description":"The landing link's utm_medium.","type":"string","pattern":"^[a-z0-9._-]{1,64}$"},"utmCampaign":{"description":"The landing link's utm_campaign.","type":"string","pattern":"^[a-z0-9._-]{1,64}$"},"referrer":{"description":"Hostname of the site the visitor came from. Never a full URL.","type":"string","pattern":"^(?=.{1,253}$)[a-z0-9-]{1,63}(?:\\.[a-z0-9-]{1,63})+$"},"landing":{"description":"Path of the visit's first page.","type":"string","pattern":"^\\/[A-Za-z0-9/._-]{0,199}$"}},"additionalProperties":false},"asset":{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},"direction":{"type":"string","description":"Mint the wrapped asset from a native-coin deposit.","enum":["deposit"]}},"required":["toAddress","asset","direction"],"additionalProperties":false},{"type":"object","properties":{"toAddress":{"type":"string","minLength":1,"description":"Destination address. Its chain-specific validity is checked by the engine."},"sessionId":{"description":"Optional session credential for an integrator to group its own orders. Requires a valid integrator API key.","type":"string","pattern":"^[0-9a-f-]{16,64}$"},"refundAddress":{"type":"string","minLength":1,"maxLength":256,"description":"Refund destination. Its chain-specific validity is checked by the engine."},"source":{"description":"Where the visit that created this order came from. Marketing only: stored apart from the order, counted in reports, never published back on any order read.","type":"object","properties":{"utmSource":{"description":"The landing link's utm_source.","type":"string","pattern":"^[a-z0-9._-]{1,64}$"},"utmMedium":{"description":"The landing link's utm_medium.","type":"string","pattern":"^[a-z0-9._-]{1,64}$"},"utmCampaign":{"description":"The landing link's utm_campaign.","type":"string","pattern":"^[a-z0-9._-]{1,64}$"},"referrer":{"description":"Hostname of the site the visitor came from. Never a full URL.","type":"string","pattern":"^(?=.{1,253}$)[a-z0-9-]{1,63}(?:\\.[a-z0-9-]{1,63})+$"},"landing":{"description":"Path of the visit's first page.","type":"string","pattern":"^\\/[A-Za-z0-9/._-]{0,199}$"}},"additionalProperties":false},"asset":{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},"direction":{"type":"string","description":"Return the native coin against the wrapped asset.","enum":["withdraw"]},"senderAddress":{"description":"Intake hint only: the Hyperliquid address you intend to return the wrapped asset from. Fees and any pause bypass are bound to the sender the workflow actually verifies on-chain.","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["toAddress","asset","direction"],"additionalProperties":false}]}}}},"security":[{},{"integratorKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"orderId":{"type":"string"},"product":{"type":"string","enum":["bridge"]},"sessionId":{"type":"string","pattern":"^[0-9a-f-]{16,64}$","description":"16–64 character hexadecimal/hyphen owner-session credential."},"asset":{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","awaiting_zec1","processing","completed","failed","expired","refunded","needs_review"]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","minimumDepositAmount"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["processing"]},"stage":{"type":"string","enum":["processing","confirming","routing","trading","sending","refunding"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["checking"]}},"required":["kind"],"additionalProperties":false}},"required":["kind","stage"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["action_required"]},"action":{"type":"string","enum":["coinflip","refund_address","payout_address"]}},"required":["kind","action"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["paused"]},"reason":{"type":"string","enum":["preparing_refund","below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["completed"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["refunded"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["expired"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["failed"]}},"required":["kind"],"additionalProperties":false}],"description":"Authoritative customer display/action state. Clients must not infer lifecycle from status or resource presence."},"destination":{"type":"string"},"expiresAt":{"type":"string"},"direction":{"type":"string","enum":["deposit"]},"depositAddress":{"type":"string"},"depositAddressForms":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["shielded","transparent"]},"address":{"type":"string"}},"required":["kind","address"],"additionalProperties":false}}},"required":["orderId","product","sessionId","asset","status","customerState","destination","expiresAt","direction","depositAddress"],"additionalProperties":false},{"type":"object","properties":{"orderId":{"type":"string"},"product":{"type":"string","enum":["bridge"]},"sessionId":{"type":"string","pattern":"^[0-9a-f-]{16,64}$","description":"16–64 character hexadecimal/hyphen owner-session credential."},"asset":{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","awaiting_zec1","processing","completed","failed","expired","refunded","needs_review"]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","minimumDepositAmount"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["processing"]},"stage":{"type":"string","enum":["processing","confirming","routing","trading","sending","refunding"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["checking"]}},"required":["kind"],"additionalProperties":false}},"required":["kind","stage"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["action_required"]},"action":{"type":"string","enum":["coinflip","refund_address","payout_address"]}},"required":["kind","action"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["paused"]},"reason":{"type":"string","enum":["preparing_refund","below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["completed"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["refunded"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["expired"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["failed"]}},"required":["kind"],"additionalProperties":false}],"description":"Authoritative customer display/action state. Clients must not infer lifecycle from status or resource presence."},"destination":{"type":"string"},"expiresAt":{"type":"string"},"direction":{"type":"string","enum":["withdraw"]},"xmr1DepositAddress":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["orderId","product","sessionId","asset","status","customerState","destination","expiresAt","direction","xmr1DepositAddress"],"additionalProperties":false}]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/coinflips/{id}/bets":{"post":{"operationId":"placeCoinflipBet","summary":"Place one bet at an open coinflip table; answers with the table as it stands after the flip","tags":["Coinflip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"round":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"The open round this bet answers. A stale round is rejected with 409, never applied later."},"side":{"type":"string","enum":["cow","milk"],"description":"Which band wins. Selects the winning range only; never feeds the HMAC."},"stakeAtomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"The bet, in the asset's smallest unit. Proposed, not binding — a refused bet advances the round and names why."},"clientSeed":{"description":"Your half of the provably-fair seed; SHA256(serverSeed) was committed before you chose it.","anyOf":[{"type":"string","maxLength":64,"pattern":"^[\\x20-\\x7E]*$"},{"type":"null"}]}},"required":["round","side","stakeAtomic"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":"string","enum":["settled","refused","closing","closed","reopened"]},"order":{"type":"object","properties":{"orderId":{"type":"string"},"product":{"type":"string","enum":["coinflip"]},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","awaiting_zec1","processing","completed","failed","expired","refunded","needs_review"]},"asset":{"type":"string","enum":["xmr","btc","sol","eth","zec"],"description":"Coinflip-table pool asset key, never a display symbol."},"direction":{"type":"string","enum":["deposit","withdraw"],"description":"deposit mints the wrapped asset from a native-coin deposit; withdraw returns the native coin against the wrapped asset."},"chainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"depositAddress":{"type":"string"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fromChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"depositChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"fromToken":{"type":"string"},"depositToken":{"type":"string"},"fromTokenSymbol":{"type":"string"},"depositTokenSymbol":{"type":"string"},"fromTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"depositTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"fromAmount":{"type":"string"},"depositAmount":{"type":"string"},"toChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toToken":{"type":"string"},"toTokenSymbol":{"type":"string"},"toTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"expectedOutput":{"type":"string"},"depositTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivingTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"sessionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundRequestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"type":"string"},"amountUsd":{"type":"number"},"bonusStage":{"type":"string","enum":["none","coinflip"]},"coinflipRequested":{"type":"boolean"},"fundingProvider":{"anyOf":[{"type":"string","enum":["privy"]},{"type":"null"}]},"integratorFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","minimumDepositAmount"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["processing"]},"stage":{"type":"string","enum":["processing","confirming","routing","trading","sending","refunding"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["checking"]}},"required":["kind"],"additionalProperties":false}},"required":["kind","stage"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["action_required"]},"action":{"type":"string","enum":["coinflip","refund_address","payout_address"]}},"required":["kind","action"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["paused"]},"reason":{"type":"string","enum":["preparing_refund","below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["completed"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["refunded"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["expired"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["failed"]}},"required":["kind"],"additionalProperties":false}],"description":"Authoritative customer display/action state. Clients must not infer lifecycle from status or resource presence."},"confirmations":{"type":"number"},"requiredConfirmations":{"type":"number"},"depositObserved":{"type":"boolean"},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"actualOutput":{"description":"What the customer received, in atomic units of `deliveredToken` when present, otherwise of `toToken`. Only on completed orders.","type":"string"},"deliveredToken":{"type":"object","properties":{"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"token":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36}},"required":["chainId","token","symbol","decimals"],"additionalProperties":false,"description":"Present only when the order completed in a different asset than `toToken`; `actualOutput` is then denominated in this token."},"coinflipLost":{"type":"boolean"},"hasReview":{"type":"boolean"},"refundRecovery":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["wrong_chain","source","table_deposit"]},"phase":{"type":"string","enum":["address_required","requested","in_progress"]},"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"asset":{"type":"object","properties":{"type":{"type":"string","enum":["native","erc20","spl"]},"token":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"type":"string"},"decimals":{"anyOf":[{"type":"integer","minimum":0,"maximum":36},{"type":"null"}]}},"required":["type","token","symbol","decimals"],"additionalProperties":false},"amountAtomic":{"type":"string"},"requestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"suggestedAddress":{"description":"An address the order already has on file for this chain (for table_deposit, the table's payout address), offered as the prefill while phase is address_required. An offer only: nothing is sent to it until it is submitted.","type":"string"},"destination":{"description":"Where the refund goes once that is decided (phase requested or in_progress). source is customer when someone submitted the address, sender when the refund returns to the wallet the deposit came from without anyone having to submit one.","type":"object","properties":{"address":{"type":"string"},"source":{"type":"string","enum":["customer","sender"]}},"required":["address","source"],"additionalProperties":false}},"required":["kind","phase","chainId","asset","amountAtomic","requestedAt"],"additionalProperties":false},{"type":"null"}]},"rewards":{"type":"object","properties":{"status":{"type":"string","enum":["pending","earned","not_eligible"]},"wagyuEarned":{"type":"number"},"wagyuBonusEarned":{"type":"number"},"wagyuCompensation":{"type":"number","minimum":0},"wagyuTotalEarned":{"type":"number"},"policyKey":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","wagyuEarned","wagyuBonusEarned","wagyuTotalEarned","policyKey"],"additionalProperties":false},"maxPayoutUsd":{"type":"number","minimum":0},"destination":{"type":"string"},"depositAddressForms":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["shielded","transparent"]},"address":{"type":"string"}},"required":["kind","address"],"additionalProperties":false}},"coinflip":{"anyOf":[{"type":"object","properties":{"eligible":{"type":"boolean"},"accepted":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"seedHash":{"type":"string"},"clientSeed":{"type":"string"},"assetSymbol":{"type":"string"},"assetKey":{"anyOf":[{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},{"type":"string","enum":["xmr","btc","sol","eth","zec"],"description":"Coinflip-table pool asset key, never a display symbol."}],"description":"Asset a coinflip was staked in: a table pool asset or a bridge asset."},"result":{"type":"number"},"won":{"type":"boolean"},"serverSeed":{"type":"string"},"resolvedAt":{"type":"string"},"side":{"anyOf":[{"type":"string","enum":["cow","milk"]},{"type":"null"}]},"currentRound":{"type":"number"},"currentMultiplier":{"type":"number"},"finalMultiplier":{"anyOf":[{"type":"number"},{"type":"null"}]},"finalWon":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"rounds":{"type":"array","items":{"type":"object","properties":{"round":{"type":"number"},"serverSeed":{"type":"string"},"serverSeedHash":{"type":"string"},"clientSeed":{"type":"string"},"side":{"type":"string","enum":["cow","milk"]},"result":{"type":"number"},"won":{"type":"boolean"},"resolvedAt":{"type":"string"},"stakeAtomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"balanceAfterAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."}},"required":["round"],"additionalProperties":false}},"policy":{"type":"object","properties":{"edgePercent":{"type":"number"},"milkWinBelow":{"type":"number"},"cowWinAbove":{"type":"number"},"winChancePercent":{"type":"number"},"maxWalletFractionPercent":{"type":"number"},"maxPayoutAtomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["edgePercent","milkWinBelow","cowWinAbove","winChancePercent"],"additionalProperties":false},"decisionDeadline":{"type":"string"},"mode":{"type":"string","enum":["session"]},"balanceAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"creditedInAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"wageredAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"minBetAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"maxBetAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"wagyuPoints":{"type":"number"},"refusal":{"type":"string","enum":["not_a_positive_amount","above_balance","below_minimum","below_payout_minimum","above_exposure_cap","limits_unavailable"]},"pendingTopUp":{"type":"object","properties":{"atomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"confirmations":{"type":"number"},"requiredConfirmations":{"type":"number"}},"required":["atomic","confirmations","requiredConfirmations"],"additionalProperties":false}},"required":["eligible","accepted","seedHash","clientSeed"],"additionalProperties":false},{"type":"null"}]}},"required":["orderId","product","status","asset","chainId","toAddress","depositAddress","createdAt","updatedAt","customerState","errorMessage","coinflipLost","hasReview"],"additionalProperties":false}},"required":["verdict","order"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/coinflips/{id}/cashout":{"post":{"operationId":"cashOutCoinflip","summary":"Close an open coinflip table and pay its balance to the destination","tags":["Coinflip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"round":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"The open round, so a cash-out cannot race a bet you just placed."},"toAddress":{"description":"Where the balance is paid. Required when the table was opened without a payout address.","type":"string","minLength":1}},"required":["round"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":"string","enum":["settled","refused","closing","closed","reopened"]},"order":{"type":"object","properties":{"orderId":{"type":"string"},"product":{"type":"string","enum":["coinflip"]},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","awaiting_zec1","processing","completed","failed","expired","refunded","needs_review"]},"asset":{"type":"string","enum":["xmr","btc","sol","eth","zec"],"description":"Coinflip-table pool asset key, never a display symbol."},"direction":{"type":"string","enum":["deposit","withdraw"],"description":"deposit mints the wrapped asset from a native-coin deposit; withdraw returns the native coin against the wrapped asset."},"chainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"depositAddress":{"type":"string"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fromChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"depositChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"fromToken":{"type":"string"},"depositToken":{"type":"string"},"fromTokenSymbol":{"type":"string"},"depositTokenSymbol":{"type":"string"},"fromTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"depositTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"fromAmount":{"type":"string"},"depositAmount":{"type":"string"},"toChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toToken":{"type":"string"},"toTokenSymbol":{"type":"string"},"toTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"expectedOutput":{"type":"string"},"depositTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivingTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"sessionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundRequestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"type":"string"},"amountUsd":{"type":"number"},"bonusStage":{"type":"string","enum":["none","coinflip"]},"coinflipRequested":{"type":"boolean"},"fundingProvider":{"anyOf":[{"type":"string","enum":["privy"]},{"type":"null"}]},"integratorFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","minimumDepositAmount"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["processing"]},"stage":{"type":"string","enum":["processing","confirming","routing","trading","sending","refunding"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["checking"]}},"required":["kind"],"additionalProperties":false}},"required":["kind","stage"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["action_required"]},"action":{"type":"string","enum":["coinflip","refund_address","payout_address"]}},"required":["kind","action"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["paused"]},"reason":{"type":"string","enum":["preparing_refund","below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["completed"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["refunded"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["expired"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["failed"]}},"required":["kind"],"additionalProperties":false}],"description":"Authoritative customer display/action state. Clients must not infer lifecycle from status or resource presence."},"confirmations":{"type":"number"},"requiredConfirmations":{"type":"number"},"depositObserved":{"type":"boolean"},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"actualOutput":{"description":"What the customer received, in atomic units of `deliveredToken` when present, otherwise of `toToken`. Only on completed orders.","type":"string"},"deliveredToken":{"type":"object","properties":{"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"token":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36}},"required":["chainId","token","symbol","decimals"],"additionalProperties":false,"description":"Present only when the order completed in a different asset than `toToken`; `actualOutput` is then denominated in this token."},"coinflipLost":{"type":"boolean"},"hasReview":{"type":"boolean"},"refundRecovery":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["wrong_chain","source","table_deposit"]},"phase":{"type":"string","enum":["address_required","requested","in_progress"]},"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"asset":{"type":"object","properties":{"type":{"type":"string","enum":["native","erc20","spl"]},"token":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"type":"string"},"decimals":{"anyOf":[{"type":"integer","minimum":0,"maximum":36},{"type":"null"}]}},"required":["type","token","symbol","decimals"],"additionalProperties":false},"amountAtomic":{"type":"string"},"requestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"suggestedAddress":{"description":"An address the order already has on file for this chain (for table_deposit, the table's payout address), offered as the prefill while phase is address_required. An offer only: nothing is sent to it until it is submitted.","type":"string"},"destination":{"description":"Where the refund goes once that is decided (phase requested or in_progress). source is customer when someone submitted the address, sender when the refund returns to the wallet the deposit came from without anyone having to submit one.","type":"object","properties":{"address":{"type":"string"},"source":{"type":"string","enum":["customer","sender"]}},"required":["address","source"],"additionalProperties":false}},"required":["kind","phase","chainId","asset","amountAtomic","requestedAt"],"additionalProperties":false},{"type":"null"}]},"rewards":{"type":"object","properties":{"status":{"type":"string","enum":["pending","earned","not_eligible"]},"wagyuEarned":{"type":"number"},"wagyuBonusEarned":{"type":"number"},"wagyuCompensation":{"type":"number","minimum":0},"wagyuTotalEarned":{"type":"number"},"policyKey":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","wagyuEarned","wagyuBonusEarned","wagyuTotalEarned","policyKey"],"additionalProperties":false},"maxPayoutUsd":{"type":"number","minimum":0},"destination":{"type":"string"},"depositAddressForms":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["shielded","transparent"]},"address":{"type":"string"}},"required":["kind","address"],"additionalProperties":false}},"coinflip":{"anyOf":[{"type":"object","properties":{"eligible":{"type":"boolean"},"accepted":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"seedHash":{"type":"string"},"clientSeed":{"type":"string"},"assetSymbol":{"type":"string"},"assetKey":{"anyOf":[{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},{"type":"string","enum":["xmr","btc","sol","eth","zec"],"description":"Coinflip-table pool asset key, never a display symbol."}],"description":"Asset a coinflip was staked in: a table pool asset or a bridge asset."},"result":{"type":"number"},"won":{"type":"boolean"},"serverSeed":{"type":"string"},"resolvedAt":{"type":"string"},"side":{"anyOf":[{"type":"string","enum":["cow","milk"]},{"type":"null"}]},"currentRound":{"type":"number"},"currentMultiplier":{"type":"number"},"finalMultiplier":{"anyOf":[{"type":"number"},{"type":"null"}]},"finalWon":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"rounds":{"type":"array","items":{"type":"object","properties":{"round":{"type":"number"},"serverSeed":{"type":"string"},"serverSeedHash":{"type":"string"},"clientSeed":{"type":"string"},"side":{"type":"string","enum":["cow","milk"]},"result":{"type":"number"},"won":{"type":"boolean"},"resolvedAt":{"type":"string"},"stakeAtomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"balanceAfterAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."}},"required":["round"],"additionalProperties":false}},"policy":{"type":"object","properties":{"edgePercent":{"type":"number"},"milkWinBelow":{"type":"number"},"cowWinAbove":{"type":"number"},"winChancePercent":{"type":"number"},"maxWalletFractionPercent":{"type":"number"},"maxPayoutAtomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["edgePercent","milkWinBelow","cowWinAbove","winChancePercent"],"additionalProperties":false},"decisionDeadline":{"type":"string"},"mode":{"type":"string","enum":["session"]},"balanceAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"creditedInAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"wageredAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"minBetAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"maxBetAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"wagyuPoints":{"type":"number"},"refusal":{"type":"string","enum":["not_a_positive_amount","above_balance","below_minimum","below_payout_minimum","above_exposure_cap","limits_unavailable"]},"pendingTopUp":{"type":"object","properties":{"atomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"confirmations":{"type":"number"},"requiredConfirmations":{"type":"number"}},"required":["atomic","confirmations","requiredConfirmations"],"additionalProperties":false}},"required":["eligible","accepted","seedHash","clientSeed"],"additionalProperties":false},{"type":"null"}]}},"required":["orderId","product","status","asset","chainId","toAddress","depositAddress","createdAt","updatedAt","customerState","errorMessage","coinflipLost","hasReview"],"additionalProperties":false}},"required":["verdict","order"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/coinflips/{id}/presence":{"post":{"operationId":"coinflipPresence","summary":"Tell an open table its player is present, so the idle window does not close it","tags":["Coinflip"],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"touched":{"type":"boolean"}},"required":["touched"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/coinflips/{id}/reopen":{"post":{"operationId":"reopenCoinflip","summary":"Reopen a table the idle window closed while it still held a balance and before any cash-out","tags":["Coinflip"],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":"string","enum":["settled","refused","closing","closed","reopened"]},"order":{"type":"object","properties":{"orderId":{"type":"string"},"product":{"type":"string","enum":["coinflip"]},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","awaiting_zec1","processing","completed","failed","expired","refunded","needs_review"]},"asset":{"type":"string","enum":["xmr","btc","sol","eth","zec"],"description":"Coinflip-table pool asset key, never a display symbol."},"direction":{"type":"string","enum":["deposit","withdraw"],"description":"deposit mints the wrapped asset from a native-coin deposit; withdraw returns the native coin against the wrapped asset."},"chainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"depositAddress":{"type":"string"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fromChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"depositChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"fromToken":{"type":"string"},"depositToken":{"type":"string"},"fromTokenSymbol":{"type":"string"},"depositTokenSymbol":{"type":"string"},"fromTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"depositTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"fromAmount":{"type":"string"},"depositAmount":{"type":"string"},"toChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toToken":{"type":"string"},"toTokenSymbol":{"type":"string"},"toTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"expectedOutput":{"type":"string"},"depositTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivingTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"sessionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundRequestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"type":"string"},"amountUsd":{"type":"number"},"bonusStage":{"type":"string","enum":["none","coinflip"]},"coinflipRequested":{"type":"boolean"},"fundingProvider":{"anyOf":[{"type":"string","enum":["privy"]},{"type":"null"}]},"integratorFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","minimumDepositAmount"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["processing"]},"stage":{"type":"string","enum":["processing","confirming","routing","trading","sending","refunding"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["checking"]}},"required":["kind"],"additionalProperties":false}},"required":["kind","stage"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["action_required"]},"action":{"type":"string","enum":["coinflip","refund_address","payout_address"]}},"required":["kind","action"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["paused"]},"reason":{"type":"string","enum":["preparing_refund","below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["completed"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["refunded"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["expired"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["failed"]}},"required":["kind"],"additionalProperties":false}],"description":"Authoritative customer display/action state. Clients must not infer lifecycle from status or resource presence."},"confirmations":{"type":"number"},"requiredConfirmations":{"type":"number"},"depositObserved":{"type":"boolean"},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"actualOutput":{"description":"What the customer received, in atomic units of `deliveredToken` when present, otherwise of `toToken`. Only on completed orders.","type":"string"},"deliveredToken":{"type":"object","properties":{"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"token":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36}},"required":["chainId","token","symbol","decimals"],"additionalProperties":false,"description":"Present only when the order completed in a different asset than `toToken`; `actualOutput` is then denominated in this token."},"coinflipLost":{"type":"boolean"},"hasReview":{"type":"boolean"},"refundRecovery":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["wrong_chain","source","table_deposit"]},"phase":{"type":"string","enum":["address_required","requested","in_progress"]},"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"asset":{"type":"object","properties":{"type":{"type":"string","enum":["native","erc20","spl"]},"token":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"type":"string"},"decimals":{"anyOf":[{"type":"integer","minimum":0,"maximum":36},{"type":"null"}]}},"required":["type","token","symbol","decimals"],"additionalProperties":false},"amountAtomic":{"type":"string"},"requestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"suggestedAddress":{"description":"An address the order already has on file for this chain (for table_deposit, the table's payout address), offered as the prefill while phase is address_required. An offer only: nothing is sent to it until it is submitted.","type":"string"},"destination":{"description":"Where the refund goes once that is decided (phase requested or in_progress). source is customer when someone submitted the address, sender when the refund returns to the wallet the deposit came from without anyone having to submit one.","type":"object","properties":{"address":{"type":"string"},"source":{"type":"string","enum":["customer","sender"]}},"required":["address","source"],"additionalProperties":false}},"required":["kind","phase","chainId","asset","amountAtomic","requestedAt"],"additionalProperties":false},{"type":"null"}]},"rewards":{"type":"object","properties":{"status":{"type":"string","enum":["pending","earned","not_eligible"]},"wagyuEarned":{"type":"number"},"wagyuBonusEarned":{"type":"number"},"wagyuCompensation":{"type":"number","minimum":0},"wagyuTotalEarned":{"type":"number"},"policyKey":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","wagyuEarned","wagyuBonusEarned","wagyuTotalEarned","policyKey"],"additionalProperties":false},"maxPayoutUsd":{"type":"number","minimum":0},"destination":{"type":"string"},"depositAddressForms":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["shielded","transparent"]},"address":{"type":"string"}},"required":["kind","address"],"additionalProperties":false}},"coinflip":{"anyOf":[{"type":"object","properties":{"eligible":{"type":"boolean"},"accepted":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"seedHash":{"type":"string"},"clientSeed":{"type":"string"},"assetSymbol":{"type":"string"},"assetKey":{"anyOf":[{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},{"type":"string","enum":["xmr","btc","sol","eth","zec"],"description":"Coinflip-table pool asset key, never a display symbol."}],"description":"Asset a coinflip was staked in: a table pool asset or a bridge asset."},"result":{"type":"number"},"won":{"type":"boolean"},"serverSeed":{"type":"string"},"resolvedAt":{"type":"string"},"side":{"anyOf":[{"type":"string","enum":["cow","milk"]},{"type":"null"}]},"currentRound":{"type":"number"},"currentMultiplier":{"type":"number"},"finalMultiplier":{"anyOf":[{"type":"number"},{"type":"null"}]},"finalWon":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"rounds":{"type":"array","items":{"type":"object","properties":{"round":{"type":"number"},"serverSeed":{"type":"string"},"serverSeedHash":{"type":"string"},"clientSeed":{"type":"string"},"side":{"type":"string","enum":["cow","milk"]},"result":{"type":"number"},"won":{"type":"boolean"},"resolvedAt":{"type":"string"},"stakeAtomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"balanceAfterAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."}},"required":["round"],"additionalProperties":false}},"policy":{"type":"object","properties":{"edgePercent":{"type":"number"},"milkWinBelow":{"type":"number"},"cowWinAbove":{"type":"number"},"winChancePercent":{"type":"number"},"maxWalletFractionPercent":{"type":"number"},"maxPayoutAtomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["edgePercent","milkWinBelow","cowWinAbove","winChancePercent"],"additionalProperties":false},"decisionDeadline":{"type":"string"},"mode":{"type":"string","enum":["session"]},"balanceAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"creditedInAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"wageredAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"minBetAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"maxBetAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"wagyuPoints":{"type":"number"},"refusal":{"type":"string","enum":["not_a_positive_amount","above_balance","below_minimum","below_payout_minimum","above_exposure_cap","limits_unavailable"]},"pendingTopUp":{"type":"object","properties":{"atomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"confirmations":{"type":"number"},"requiredConfirmations":{"type":"number"}},"required":["atomic","confirmations","requiredConfirmations"],"additionalProperties":false}},"required":["eligible","accepted","seedHash","clientSeed"],"additionalProperties":false},{"type":"null"}]}},"required":["orderId","product","status","asset","chainId","toAddress","depositAddress","createdAt","updatedAt","customerState","errorMessage","coinflipLost","hasReview"],"additionalProperties":false}},"required":["verdict","order"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/coinflips/recent":{"get":{"operationId":"getRecentCoinflipRounds","summary":"List recent played table rounds without owner or fairness data","tags":["Coinflip"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"round":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"assetSymbol":{"type":"string","minLength":1},"atomicDecimals":{"type":"integer","minimum":0,"maximum":36},"stakeAtomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"side":{"type":"string","enum":["cow","milk"]},"won":{"type":"boolean"},"playedAt":{"type":"string"}},"required":["id","round","assetSymbol","atomicDecimals","stakeAtomic","side","won","playedAt"],"additionalProperties":false}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/coinflips/terms":{"get":{"operationId":"getCoinflipTerms","summary":"Read which coinflip pool assets are stakeable right now, with their minimum, fee and odds","tags":["Coinflip"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"assets":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","enum":["xmr","btc","sol","eth","zec"],"description":"Coinflip-table pool asset key, never a display symbol."},"symbol":{"type":"string","minLength":1},"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"decimals":{"type":"integer","minimum":0,"maximum":36},"available":{"type":"boolean"},"minAtomic":{"anyOf":[{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},{"type":"null"}]},"feePercent":{"anyOf":[{"type":"number"},{"type":"null"}]},"edgePercent":{"anyOf":[{"type":"number"},{"type":"null"}]},"winChancePercent":{"anyOf":[{"type":"number"},{"type":"null"}]},"maxPayoutUsd":{"type":"number","minimum":0}},"required":["asset","symbol","chainId","decimals","available","minAtomic","feePercent","edgePercent","winChancePercent"],"additionalProperties":false}}},"required":["assets"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/coinflips":{"post":{"operationId":"createCoinflipOrder","summary":"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)","tags":["Coinflip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asset":{"type":"string","enum":["xmr","btc","sol","eth","zec"],"description":"Coinflip-table pool asset key, never a display symbol."},"toAddress":{"description":"Same-chain native address the balance is paid to. Optional at open: name it at cash-out instead.","type":"string","minLength":1},"sessionId":{"description":"Optional session credential for an integrator to group its own orders. Requires a valid integrator API key.","type":"string","pattern":"^[0-9a-f-]{16,64}$"},"refundAddress":{"type":"string","minLength":1,"maxLength":256,"description":"Refund destination. Its chain-specific validity is checked by the engine."}},"required":["asset"],"additionalProperties":false}}}},"security":[{},{"integratorKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"orderId":{"type":"string"},"sessionId":{"type":"string"},"product":{"type":"string","enum":["coinflip"]},"asset":{"type":"string","enum":["xmr","btc","sol","eth","zec"],"description":"Coinflip-table pool asset key, never a display symbol."},"maxPayoutUsd":{"type":"number","minimum":0},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","awaiting_zec1","processing","completed","failed","expired","refunded","needs_review"]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","minimumDepositAmount"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["processing"]},"stage":{"type":"string","enum":["processing","confirming","routing","trading","sending","refunding"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["checking"]}},"required":["kind"],"additionalProperties":false}},"required":["kind","stage"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["action_required"]},"action":{"type":"string","enum":["coinflip","refund_address","payout_address"]}},"required":["kind","action"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["paused"]},"reason":{"type":"string","enum":["preparing_refund","below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["completed"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["refunded"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["expired"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["failed"]}},"required":["kind"],"additionalProperties":false}],"description":"Authoritative customer display/action state. Clients must not infer lifecycle from status or resource presence."},"destination":{"type":"string"},"depositAddress":{"type":"string"},"depositAddressForms":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["shielded","transparent"]},"address":{"type":"string"}},"required":["kind","address"],"additionalProperties":false}},"expiresAt":{"type":"string"},"minAtomic":{"type":"string","description":"Smallest accepted stake, in atomic units of the asset."},"feePercent":{"type":"number","description":"Intake fee percent skimmed from the stake before the flip."},"edgePercent":{"type":"number","description":"House band percent; the win chance per side is (100 − edge) / 2."}},"required":["orderId","sessionId","product","asset","status","customerState","depositAddress","expiresAt","minAtomic","feePercent","edgePercent"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/points/{address}":{"get":{"operationId":"getPoints","summary":"Read an address points balance","tags":["Points"],"parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"address","required":true,"description":"Address whose points balance to read."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"volumeUsd":{"type":"number"},"eligibleOrderVolumeUsd":{"type":"number"},"bonusVolumeUsd":{"type":"number"},"wagyu":{"type":"number"},"rank":{"anyOf":[{"type":"number"},{"type":"null"}]},"tradeCount":{"type":"number"},"lastOrderAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"formula":{"type":"object","properties":{"pointsPerUsd":{"type":"number"},"label":{"type":"string"}},"required":["pointsPerUsd","label"],"additionalProperties":false}},"required":["address","volumeUsd","eligibleOrderVolumeUsd","bonusVolumeUsd","wagyu","rank","tradeCount","lastOrderAt","formula"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/points/leaderboard":{"get":{"operationId":"getPointsLeaderboard","summary":"List the points leaderboard","tags":["Points"],"parameters":[{"schema":{"default":25,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false,"description":"Number of ranked rows to return."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"volumeUsd":{"type":"number"},"eligibleOrderVolumeUsd":{"type":"number"},"bonusVolumeUsd":{"type":"number"},"wagyu":{"type":"number"},"tradeCount":{"type":"number"},"lastOrderAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"rank":{"type":"number"},"totalVolume":{"type":"number"}},"required":["address","volumeUsd","eligibleOrderVolumeUsd","bonusVolumeUsd","wagyu","tradeCount","lastOrderAt","rank","totalVolume"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/stats/daily":{"get":{"operationId":"getProtocolStats","summary":"Read protocol volume statistics","tags":["Stats"],"parameters":[{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"includeMetadata","required":false,"description":"Opt in to freshness and coverage metadata; omitted by default for older strict clients."},{"schema":{"default":14,"type":"integer","minimum":1,"maximum":365},"in":"query","name":"days","required":false,"description":"How many trailing days of protocol statistics to include, ending today."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"metadata":{"type":"object","properties":{"asOf":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"dayBasis":{"type":"string","enum":["created_at_utc"]},"currentProducts":{"type":"array","items":{"type":"string","enum":["swap","bridge","coinflip"]}},"volumeIncludesLegacy":{"type":"boolean"},"orderCountsIncludeLegacy":{"type":"boolean","enum":[false]},"legacyAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"unvaluedLegacyCompletedOrders":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["asOf","dayBasis","currentProducts","volumeIncludesLegacy","orderCountsIncludeLegacy","legacyAsOf","unvaluedLegacyCompletedOrders"],"additionalProperties":false},"stats24h":{"type":"object","properties":{"orders":{"type":"number"},"completed":{"type":"number"},"failed":{"type":"number"},"swaps":{"type":"number"},"bridge":{"type":"number"},"volumeUsd":{"type":"number"}},"required":["orders","completed","failed","swaps","bridge","volumeUsd"],"additionalProperties":false},"totals":{"type":"object","properties":{"orders":{"type":"number"},"completed":{"type":"number"},"failed":{"type":"number"},"swaps":{"type":"number"},"bridge":{"type":"number"},"volumeUsd":{"type":"number"}},"required":["orders","completed","failed","swaps","bridge","volumeUsd"],"additionalProperties":false},"daily":{"type":"array","items":{"type":"object","properties":{"orders":{"type":"number"},"completed":{"type":"number"},"failed":{"type":"number"},"swaps":{"type":"number"},"bridge":{"type":"number"},"volumeUsd":{"type":"number"},"date":{"type":"string"}},"required":["orders","completed","failed","swaps","bridge","volumeUsd","date"],"additionalProperties":false}}},"required":["stats24h","totals","daily"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/swaps/route-stats":{"get":{"operationId":"getSwapRouteStats","summary":"Read 30-day measured execution medians by token and network","tags":["Stats"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"asOf":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"windowStart":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"windowDays":{"type":"number","enum":[30]},"cohort":{"type":"string","enum":["completed_at"]},"basis":{"type":"string","description":"Same systemSeconds as dashboard performance: detected deposit to last recorded workflow step (workflow update when no step end exists). Excludes customer wait before detection; not wallet spendability.","enum":["projection_system_seconds"]},"minimumSamples":{"type":"number","enum":[5]},"routes":{"type":"array","items":{"type":"object","properties":{"fromChainId":{"type":"integer","minimum":0,"maximum":9007199254740991},"fromToken":{"type":"string"},"toChainId":{"type":"integer","minimum":0,"maximum":9007199254740991},"toToken":{"type":"string"},"sampleCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"medianSeconds":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["fromChainId","fromToken","toChainId","toToken","sampleCount","medianSeconds"],"additionalProperties":false}}},"required":["asOf","windowStart","windowDays","cohort","basis","minimumSamples","routes"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/recent-swaps":{"get":{"operationId":"getRecentSwaps","summary":"List recent completed swaps","tags":["Activity"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","description":"Opaque key for this row, stable across polls. Not the order's id: it opens no order."},"status":{"type":"string","enum":["completed"]},"from":{"type":"string"},"fromChainId":{"type":"integer","minimum":0,"maximum":9007199254740991},"fromAmount":{"type":"string"},"fromTokenDecimals":{"type":"integer","minimum":0,"maximum":9007199254740991},"to":{"type":"string"},"toChainId":{"type":"integer","minimum":0,"maximum":9007199254740991},"toAmount":{"type":"string"},"toTokenDecimals":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["orderId","status","from","to","createdAt","completedAt"],"additionalProperties":false}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/bridges/recent":{"get":{"operationId":"getRecentBridgeOrders","summary":"List recent completed bridge orders","tags":["Activity"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","description":"Opaque key for this row, stable across polls. Not the order's id: it opens no order."},"status":{"type":"string","enum":["completed"]},"from":{"type":"string"},"fromChainId":{"type":"integer","minimum":0,"maximum":9007199254740991},"fromAmount":{"type":"string"},"fromTokenDecimals":{"type":"integer","minimum":0,"maximum":9007199254740991},"to":{"type":"string"},"toChainId":{"type":"integer","minimum":0,"maximum":9007199254740991},"toAmount":{"type":"string"},"toTokenDecimals":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["orderId","status","from","to","createdAt","completedAt"],"additionalProperties":false}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/swaps/{id}":{"get":{"operationId":"getSwapOrder","summary":"Read a swap order with an owner session or destination proof","tags":["Swaps"],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]},{"destinationProof":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"orderId":{"type":"string"},"product":{"type":"string","enum":["swap"]},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","awaiting_zec1","processing","completed","failed","expired","refunded","needs_review"]},"asset":{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},"direction":{"type":"string","enum":["deposit","withdraw"],"description":"deposit mints the wrapped asset from a native-coin deposit; withdraw returns the native coin against the wrapped asset."},"chainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toAddress":{"type":"string"},"depositAddress":{"type":"string"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fromChainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"depositChainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"fromToken":{"type":"string"},"depositToken":{"type":"string"},"fromTokenSymbol":{"type":"string"},"depositTokenSymbol":{"type":"string"},"fromTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"depositTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"fromAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"depositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"toChainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"toToken":{"type":"string"},"toTokenSymbol":{"type":"string"},"toTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"expectedOutput":{"type":"string"},"depositTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivingTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"sessionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundRequestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"type":"string"},"amountUsd":{"type":"number"},"bonusStage":{"type":"string","enum":["none","coinflip"]},"coinflipRequested":{"type":"boolean"},"fundingProvider":{"anyOf":[{"type":"string","enum":["privy"]},{"type":"null"}]},"integratorFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","minimumDepositAmount"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["processing"]},"stage":{"type":"string","enum":["processing","confirming","routing","trading","sending","refunding"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["checking"]}},"required":["kind"],"additionalProperties":false}},"required":["kind","stage"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["action_required"]},"action":{"type":"string","enum":["coinflip","refund_address","payout_address"]}},"required":["kind","action"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["paused"]},"reason":{"type":"string","enum":["preparing_refund","below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["completed"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["refunded"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["expired"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["failed"]}},"required":["kind"],"additionalProperties":false}],"description":"Authoritative customer display/action state. Clients must not infer lifecycle from status or resource presence."},"confirmations":{"type":"number"},"requiredConfirmations":{"type":"number"},"depositObserved":{"type":"boolean"},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"actualOutput":{"description":"What the customer received, in atomic units of `deliveredToken` when present, otherwise of `toToken`. Only on completed orders.","type":"string"},"deliveredToken":{"type":"object","properties":{"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"token":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36}},"required":["chainId","token","symbol","decimals"],"additionalProperties":false,"description":"Present only when the order completed in a different asset than `toToken`; `actualOutput` is then denominated in this token."},"coinflipLost":{"type":"boolean"},"hasReview":{"type":"boolean"},"refundRecovery":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["wrong_chain","source","table_deposit"]},"phase":{"type":"string","enum":["address_required","requested","in_progress"]},"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"asset":{"type":"object","properties":{"type":{"type":"string","enum":["native","erc20","spl"]},"token":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"type":"string"},"decimals":{"anyOf":[{"type":"integer","minimum":0,"maximum":36},{"type":"null"}]}},"required":["type","token","symbol","decimals"],"additionalProperties":false},"amountAtomic":{"type":"string"},"requestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"suggestedAddress":{"description":"An address the order already has on file for this chain (for table_deposit, the table's payout address), offered as the prefill while phase is address_required. An offer only: nothing is sent to it until it is submitted.","type":"string"},"destination":{"description":"Where the refund goes once that is decided (phase requested or in_progress). source is customer when someone submitted the address, sender when the refund returns to the wallet the deposit came from without anyone having to submit one.","type":"object","properties":{"address":{"type":"string"},"source":{"type":"string","enum":["customer","sender"]}},"required":["address","source"],"additionalProperties":false}},"required":["kind","phase","chainId","asset","amountAtomic","requestedAt"],"additionalProperties":false},{"type":"null"}]},"rewards":{"type":"object","properties":{"status":{"type":"string","enum":["pending","earned","not_eligible"]},"wagyuEarned":{"type":"number"},"wagyuBonusEarned":{"type":"number"},"wagyuCompensation":{"type":"number","minimum":0},"wagyuTotalEarned":{"type":"number"},"policyKey":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","wagyuEarned","wagyuBonusEarned","wagyuTotalEarned","policyKey"],"additionalProperties":false},"depositAddressForms":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["shielded","transparent"]},"address":{"type":"string"}},"required":["kind","address"],"additionalProperties":false}},"sourceDepositAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"observedDepositTxHash":{"type":"string"},"observedDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"fundedExpectedOutput":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"refund":{"type":"object","properties":{"txHash":{"type":"string"},"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"toAddress":{"type":"string"}},"required":["txHash","chainId","toAddress"],"additionalProperties":false},"coinflip":{"anyOf":[{"type":"object","properties":{"eligible":{"type":"boolean"},"accepted":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"seedHash":{"type":"string"},"clientSeed":{"type":"string"},"assetSymbol":{"type":"string"},"assetKey":{"anyOf":[{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},{"type":"string","enum":["xmr","btc","sol","eth","zec"],"description":"Coinflip-table pool asset key, never a display symbol."}],"description":"Asset a coinflip was staked in: a table pool asset or a bridge asset."},"result":{"type":"number"},"won":{"type":"boolean"},"serverSeed":{"type":"string"},"resolvedAt":{"type":"string"},"side":{"anyOf":[{"type":"string","enum":["cow","milk"]},{"type":"null"}]},"currentRound":{"type":"number"},"currentMultiplier":{"type":"number"},"finalMultiplier":{"anyOf":[{"type":"number"},{"type":"null"}]},"finalWon":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"rounds":{"type":"array","items":{"type":"object","properties":{"round":{"type":"number"},"serverSeed":{"type":"string"},"serverSeedHash":{"type":"string"},"clientSeed":{"type":"string"},"side":{"type":"string","enum":["cow","milk"]},"result":{"type":"number"},"won":{"type":"boolean"},"resolvedAt":{"type":"string"},"stakeAtomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"balanceAfterAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."}},"required":["round"],"additionalProperties":false}},"policy":{"type":"object","properties":{"edgePercent":{"type":"number"},"milkWinBelow":{"type":"number"},"cowWinAbove":{"type":"number"},"winChancePercent":{"type":"number"},"maxWalletFractionPercent":{"type":"number"},"maxPayoutAtomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["edgePercent","milkWinBelow","cowWinAbove","winChancePercent"],"additionalProperties":false},"decisionDeadline":{"type":"string"},"mode":{"type":"string","enum":["session"]},"balanceAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"creditedInAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"wageredAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"minBetAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"maxBetAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"wagyuPoints":{"type":"number"},"refusal":{"type":"string","enum":["not_a_positive_amount","above_balance","below_minimum","below_payout_minimum","above_exposure_cap","limits_unavailable"]},"pendingTopUp":{"type":"object","properties":{"atomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"confirmations":{"type":"number"},"requiredConfirmations":{"type":"number"}},"required":["atomic","confirmations","requiredConfirmations"],"additionalProperties":false}},"required":["eligible","accepted","seedHash","clientSeed"],"additionalProperties":false},{"type":"null"}]},"twap":{"anyOf":[{"type":"object","properties":{"enabled":{"type":"boolean","enum":[true]},"status":{"type":"string","enum":["running","completed","failed"]},"side":{"type":"string","enum":["buy","sell"]},"filledPercent":{"type":"number"},"chunksCompleted":{"type":"number"},"chunksTotal":{"type":"number"},"estimatedTimeRemainingMs":{"type":"number"},"estimatedTimeRemaining":{"type":"string"},"startedAt":{"type":"string"},"expectedCompleteAt":{"type":"string"},"completedAt":{"type":"string"}},"required":["enabled","status","filledPercent","chunksCompleted","chunksTotal","startedAt"],"additionalProperties":false},{"type":"null"}]},"route":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string"},"tool":{"type":"string"},"txHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"toChainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"status":{"type":"string","enum":["pending","done","refunded","failed","partial","unavailable"]},"statusMessage":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","tool","txHash","toChainId","status","statusMessage"],"additionalProperties":false},{"type":"null"}]},"routing":{"type":"object","properties":{"topology":{"type":"string","enum":["single","parallel"]},"branchCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"phase":{"type":"string","enum":["preparing","executing","recovering","settled","attention","unavailable"]},"status":{"type":"string","enum":["pending","done","partial","failed","unavailable"]},"branches":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"completed":{"type":"integer","minimum":0,"maximum":9007199254740991},"pending":{"type":"integer","minimum":0,"maximum":9007199254740991},"attention":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["total","completed","pending","attention"],"additionalProperties":false},"routes":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","minLength":1},"tool":{"type":"string","minLength":1},"txHash":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"fromChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"attempt":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"status":{"type":"string","enum":["pending","done","refunded","failed","partial","unavailable"]},"statusMessage":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","tool","txHash","fromChainId","toChainId","attempt","status","statusMessage"],"additionalProperties":false}}},"required":["topology","branchCount","phase","status","branches","routes"],"additionalProperties":false},"hlFills":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"tradeId":{"type":"string","pattern":"^\\d+$"},"coin":{"type":"string","pattern":"^@\\d+$"},"txHash":{"type":"string","minLength":66,"maxLength":66,"pattern":"^0x(?!0{64}$)[0-9a-fA-F]{64}$"},"time":{"type":"integer","minimum":0,"maximum":9007199254740991},"side":{"type":"string","enum":["Buy","Sell"]},"price":{"type":"number","exclusiveMinimum":0},"size":{"type":"number","exclusiveMinimum":0},"value":{"type":"number","minimum":0},"fee":{"type":"number"},"feeToken":{"type":"string","minLength":1},"twapId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["time","side","price","size","value","fee","feeToken"],"additionalProperties":false}},{"type":"null"}]},"hlFillsStatus":{"type":"string","enum":["pending","complete","incomplete"]},"hlFillsNextCursor":{"anyOf":[{"type":"string","pattern":"^[1-9]\\d{0,18}$"},{"type":"null"}]}},"required":["orderId","product","status","chainId","toAddress","depositAddress","createdAt","updatedAt","fromChainId","depositChainId","fromToken","depositToken","fromTokenSymbol","depositTokenSymbol","fromTokenDecimals","depositTokenDecimals","fromAmount","depositAmount","toChainId","toToken","toTokenSymbol","toTokenDecimals","customerState","errorMessage","coinflipLost","hasReview"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/swaps/{id}/fills":{"get":{"operationId":"getSwapFills","summary":"Page saved execution receipts with an owner session or destination proof","tags":["Swaps"],"parameters":[{"schema":{"type":"string","pattern":"^[1-9]\\d{0,18}$"},"in":"query","name":"before","required":false,"description":"Cursor returned as nextCursor by the previous page."},{"schema":{"default":200,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false,"description":"Maximum fills per page, from 1 to 200."},{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]},{"destinationProof":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"fills":{"type":"array","items":{"type":"object","properties":{"tradeId":{"type":"string","pattern":"^\\d+$"},"coin":{"type":"string","pattern":"^@\\d+$"},"txHash":{"type":"string","minLength":66,"maxLength":66,"pattern":"^0x(?!0{64}$)[0-9a-fA-F]{64}$"},"time":{"type":"integer","minimum":0,"maximum":9007199254740991},"side":{"type":"string","enum":["Buy","Sell"]},"price":{"type":"number","exclusiveMinimum":0},"size":{"type":"number","exclusiveMinimum":0},"value":{"type":"number","minimum":0},"fee":{"type":"number"},"feeToken":{"type":"string","minLength":1},"twapId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["time","side","price","size","value","fee","feeToken"],"additionalProperties":false}},"status":{"type":"string","enum":["pending","complete","incomplete"]},"nextCursor":{"anyOf":[{"type":"string","pattern":"^[1-9]\\d{0,18}$"},{"type":"null"}]}},"required":["fills","status","nextCursor"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/coinflips/{id}":{"get":{"operationId":"getCoinflipOrder","summary":"Read a coinflip-table order with an owner session or destination proof","tags":["Coinflip"],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]},{"destinationProof":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"orderId":{"type":"string"},"product":{"type":"string","enum":["coinflip"]},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","awaiting_zec1","processing","completed","failed","expired","refunded","needs_review"]},"asset":{"type":"string","enum":["xmr","btc","sol","eth","zec"],"description":"Coinflip-table pool asset key, never a display symbol."},"direction":{"type":"string","enum":["deposit","withdraw"],"description":"deposit mints the wrapped asset from a native-coin deposit; withdraw returns the native coin against the wrapped asset."},"chainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"depositAddress":{"type":"string"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fromChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"depositChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"fromToken":{"type":"string"},"depositToken":{"type":"string"},"fromTokenSymbol":{"type":"string"},"depositTokenSymbol":{"type":"string"},"fromTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"depositTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"fromAmount":{"type":"string"},"depositAmount":{"type":"string"},"toChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toToken":{"type":"string"},"toTokenSymbol":{"type":"string"},"toTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"expectedOutput":{"type":"string"},"depositTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivingTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"sessionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundRequestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"type":"string"},"amountUsd":{"type":"number"},"bonusStage":{"type":"string","enum":["none","coinflip"]},"coinflipRequested":{"type":"boolean"},"fundingProvider":{"anyOf":[{"type":"string","enum":["privy"]},{"type":"null"}]},"integratorFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","minimumDepositAmount"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["processing"]},"stage":{"type":"string","enum":["processing","confirming","routing","trading","sending","refunding"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["checking"]}},"required":["kind"],"additionalProperties":false}},"required":["kind","stage"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["action_required"]},"action":{"type":"string","enum":["coinflip","refund_address","payout_address"]}},"required":["kind","action"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["paused"]},"reason":{"type":"string","enum":["preparing_refund","below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["completed"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["refunded"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["expired"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["failed"]}},"required":["kind"],"additionalProperties":false}],"description":"Authoritative customer display/action state. Clients must not infer lifecycle from status or resource presence."},"confirmations":{"type":"number"},"requiredConfirmations":{"type":"number"},"depositObserved":{"type":"boolean"},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"actualOutput":{"description":"What the customer received, in atomic units of `deliveredToken` when present, otherwise of `toToken`. Only on completed orders.","type":"string"},"deliveredToken":{"type":"object","properties":{"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"token":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36}},"required":["chainId","token","symbol","decimals"],"additionalProperties":false,"description":"Present only when the order completed in a different asset than `toToken`; `actualOutput` is then denominated in this token."},"coinflipLost":{"type":"boolean"},"hasReview":{"type":"boolean"},"refundRecovery":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["wrong_chain","source","table_deposit"]},"phase":{"type":"string","enum":["address_required","requested","in_progress"]},"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"asset":{"type":"object","properties":{"type":{"type":"string","enum":["native","erc20","spl"]},"token":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"type":"string"},"decimals":{"anyOf":[{"type":"integer","minimum":0,"maximum":36},{"type":"null"}]}},"required":["type","token","symbol","decimals"],"additionalProperties":false},"amountAtomic":{"type":"string"},"requestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"suggestedAddress":{"description":"An address the order already has on file for this chain (for table_deposit, the table's payout address), offered as the prefill while phase is address_required. An offer only: nothing is sent to it until it is submitted.","type":"string"},"destination":{"description":"Where the refund goes once that is decided (phase requested or in_progress). source is customer when someone submitted the address, sender when the refund returns to the wallet the deposit came from without anyone having to submit one.","type":"object","properties":{"address":{"type":"string"},"source":{"type":"string","enum":["customer","sender"]}},"required":["address","source"],"additionalProperties":false}},"required":["kind","phase","chainId","asset","amountAtomic","requestedAt"],"additionalProperties":false},{"type":"null"}]},"rewards":{"type":"object","properties":{"status":{"type":"string","enum":["pending","earned","not_eligible"]},"wagyuEarned":{"type":"number"},"wagyuBonusEarned":{"type":"number"},"wagyuCompensation":{"type":"number","minimum":0},"wagyuTotalEarned":{"type":"number"},"policyKey":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","wagyuEarned","wagyuBonusEarned","wagyuTotalEarned","policyKey"],"additionalProperties":false},"maxPayoutUsd":{"type":"number","minimum":0},"destination":{"type":"string"},"depositAddressForms":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["shielded","transparent"]},"address":{"type":"string"}},"required":["kind","address"],"additionalProperties":false}},"coinflip":{"anyOf":[{"type":"object","properties":{"eligible":{"type":"boolean"},"accepted":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"seedHash":{"type":"string"},"clientSeed":{"type":"string"},"assetSymbol":{"type":"string"},"assetKey":{"anyOf":[{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},{"type":"string","enum":["xmr","btc","sol","eth","zec"],"description":"Coinflip-table pool asset key, never a display symbol."}],"description":"Asset a coinflip was staked in: a table pool asset or a bridge asset."},"result":{"type":"number"},"won":{"type":"boolean"},"serverSeed":{"type":"string"},"resolvedAt":{"type":"string"},"side":{"anyOf":[{"type":"string","enum":["cow","milk"]},{"type":"null"}]},"currentRound":{"type":"number"},"currentMultiplier":{"type":"number"},"finalMultiplier":{"anyOf":[{"type":"number"},{"type":"null"}]},"finalWon":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"rounds":{"type":"array","items":{"type":"object","properties":{"round":{"type":"number"},"serverSeed":{"type":"string"},"serverSeedHash":{"type":"string"},"clientSeed":{"type":"string"},"side":{"type":"string","enum":["cow","milk"]},"result":{"type":"number"},"won":{"type":"boolean"},"resolvedAt":{"type":"string"},"stakeAtomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"balanceAfterAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."}},"required":["round"],"additionalProperties":false}},"policy":{"type":"object","properties":{"edgePercent":{"type":"number"},"milkWinBelow":{"type":"number"},"cowWinAbove":{"type":"number"},"winChancePercent":{"type":"number"},"maxWalletFractionPercent":{"type":"number"},"maxPayoutAtomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["edgePercent","milkWinBelow","cowWinAbove","winChancePercent"],"additionalProperties":false},"decisionDeadline":{"type":"string"},"mode":{"type":"string","enum":["session"]},"balanceAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"creditedInAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"wageredAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"minBetAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"maxBetAtomic":{"type":"string","pattern":"^0*[0-9]+$","description":"Non-negative base-10 integer in the asset’s atomic unit."},"wagyuPoints":{"type":"number"},"refusal":{"type":"string","enum":["not_a_positive_amount","above_balance","below_minimum","below_payout_minimum","above_exposure_cap","limits_unavailable"]},"pendingTopUp":{"type":"object","properties":{"atomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},"confirmations":{"type":"number"},"requiredConfirmations":{"type":"number"}},"required":["atomic","confirmations","requiredConfirmations"],"additionalProperties":false}},"required":["eligible","accepted","seedHash","clientSeed"],"additionalProperties":false},{"type":"null"}]}},"required":["orderId","product","status","asset","chainId","toAddress","depositAddress","createdAt","updatedAt","customerState","errorMessage","coinflipLost","hasReview"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/orders/{id}":{"delete":{"operationId":"deleteOrder","summary":"Permanently remove a completed or refunded order","tags":["Orders"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/swaps/{id}/coinflip":{"put":{"operationId":"resolveCoinflip","summary":"Submit a coinflip decision for an eligible order","tags":["Swaps"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"round":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"The pending round this decision answers. A stale decision is rejected, never applied to a later round."},"accept":{"type":"boolean","description":"Whether to take the offered flip. false cashes the bonus out instead. Omission is never treated as a decline — the field is required."},"clientSeed":{"description":"Your half of the provably-fair seed. The outcome is HMAC(serverSeed, clientSeed), and SHA256(serverSeed) is committed before you choose it. Omit to let the engine use a fallback seed.","anyOf":[{"type":"string","maxLength":64,"pattern":"^[\\x20-\\x7E]*$"},{"type":"null"}]},"side":{"description":"Which band wins. It selects the winning range only and never feeds the HMAC, so it cannot change the drawn number.","anyOf":[{"type":"string","enum":["cow","milk"]},{"type":"null"}]},"stakeAtomic":{"description":"Coinflip TABLE only: the bet for this round, in the asset's smallest unit. Proposed, not binding — the engine refuses a bet above your balance, below the minimum, or beyond the pool's exposure cap, and leaves the round open so you can correct it. Ignored by the in-swap bonus, which always stakes the whole delivery.","anyOf":[{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."},{"type":"null"}]}},"required":["round","accept"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"round":{"type":"number"},"result":{"type":"number"},"won":{"type":"boolean"},"side":{"type":"string","enum":["cow","milk"]},"multiplier":{"type":"number"},"finalMultiplier":{"anyOf":[{"type":"number"},{"type":"null"}]},"serverSeed":{"type":"string"},"seedHash":{"type":"string"},"cashedOut":{"type":"boolean"},"revealedUnusedSeed":{"type":"string"},"unusedSeedHash":{"type":"string"},"nextRound":{"anyOf":[{"type":"object","properties":{"round":{"type":"number"},"seedHash":{"type":"string"},"multiplierIfWin":{"type":"number"},"currentMultiplier":{"type":"number"},"decisionDeadline":{"type":"string"}},"required":["round","seedHash","multiplierIfWin","currentMultiplier"],"additionalProperties":false},{"type":"null"}]},"policy":{"type":"object","properties":{"edgePercent":{"type":"number"},"milkWinBelow":{"type":"number"},"cowWinAbove":{"type":"number"},"winChancePercent":{"type":"number"},"maxWalletFractionPercent":{"type":"number"},"maxPayoutAtomic":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["edgePercent","milkWinBelow","cowWinAbove","winChancePercent"],"additionalProperties":false}},"required":["finalMultiplier"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/bridges/{id}":{"get":{"operationId":"getBridgeOrder","summary":"Read a bridge order with an owner session or destination proof","tags":["Bridge"],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]},{"destinationProof":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"orderId":{"type":"string"},"product":{"type":"string","enum":["bridge"]},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","awaiting_zec1","processing","completed","failed","expired","refunded","needs_review"]},"asset":{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},"direction":{"type":"string","enum":["deposit"]},"chainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fromChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"depositChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"fromToken":{"type":"string"},"depositToken":{"type":"string"},"fromTokenSymbol":{"type":"string"},"depositTokenSymbol":{"type":"string"},"fromTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"depositTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"fromAmount":{"type":"string"},"depositAmount":{"type":"string"},"toChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toToken":{"type":"string"},"toTokenSymbol":{"type":"string"},"toTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"expectedOutput":{"type":"string"},"depositTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivingTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"sessionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundRequestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"type":"string"},"amountUsd":{"type":"number"},"bonusStage":{"type":"string","enum":["none","coinflip"]},"coinflipRequested":{"type":"boolean"},"fundingProvider":{"anyOf":[{"type":"string","enum":["privy"]},{"type":"null"}]},"integratorFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","minimumDepositAmount"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["processing"]},"stage":{"type":"string","enum":["processing","confirming","routing","trading","sending","refunding"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["checking"]}},"required":["kind"],"additionalProperties":false}},"required":["kind","stage"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["action_required"]},"action":{"type":"string","enum":["coinflip","refund_address","payout_address"]}},"required":["kind","action"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["paused"]},"reason":{"type":"string","enum":["preparing_refund","below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["completed"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["refunded"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["expired"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["failed"]}},"required":["kind"],"additionalProperties":false}],"description":"Authoritative customer display/action state. Clients must not infer lifecycle from status or resource presence."},"confirmations":{"type":"number"},"requiredConfirmations":{"type":"number"},"depositObserved":{"type":"boolean"},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"actualOutput":{"description":"What the customer received, in atomic units of `deliveredToken` when present, otherwise of `toToken`. Only on completed orders.","type":"string"},"deliveredToken":{"type":"object","properties":{"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"token":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36}},"required":["chainId","token","symbol","decimals"],"additionalProperties":false,"description":"Present only when the order completed in a different asset than `toToken`; `actualOutput` is then denominated in this token."},"coinflipLost":{"type":"boolean"},"hasReview":{"type":"boolean"},"refundRecovery":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["wrong_chain","source","table_deposit"]},"phase":{"type":"string","enum":["address_required","requested","in_progress"]},"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"asset":{"type":"object","properties":{"type":{"type":"string","enum":["native","erc20","spl"]},"token":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"type":"string"},"decimals":{"anyOf":[{"type":"integer","minimum":0,"maximum":36},{"type":"null"}]}},"required":["type","token","symbol","decimals"],"additionalProperties":false},"amountAtomic":{"type":"string"},"requestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"suggestedAddress":{"description":"An address the order already has on file for this chain (for table_deposit, the table's payout address), offered as the prefill while phase is address_required. An offer only: nothing is sent to it until it is submitted.","type":"string"},"destination":{"description":"Where the refund goes once that is decided (phase requested or in_progress). source is customer when someone submitted the address, sender when the refund returns to the wallet the deposit came from without anyone having to submit one.","type":"object","properties":{"address":{"type":"string"},"source":{"type":"string","enum":["customer","sender"]}},"required":["address","source"],"additionalProperties":false}},"required":["kind","phase","chainId","asset","amountAtomic","requestedAt"],"additionalProperties":false},{"type":"null"}]},"rewards":{"type":"object","properties":{"status":{"type":"string","enum":["pending","earned","not_eligible"]},"wagyuEarned":{"type":"number"},"wagyuBonusEarned":{"type":"number"},"wagyuCompensation":{"type":"number","minimum":0},"wagyuTotalEarned":{"type":"number"},"policyKey":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","wagyuEarned","wagyuBonusEarned","wagyuTotalEarned","policyKey"],"additionalProperties":false},"destination":{"type":"string"},"amount":{"anyOf":[{"type":"string"},{"type":"number"}]},"txIn":{"anyOf":[{"type":"string"},{"type":"null"}]},"txOut":{"anyOf":[{"type":"string"},{"type":"null"}]},"txid":{"anyOf":[{"type":"string"},{"type":"null"}]},"bridgeSettlement":{"anyOf":[{"type":"object","properties":{"direction":{"type":"string","enum":["deposit","withdraw"],"description":"deposit mints the wrapped asset from a native-coin deposit; withdraw returns the native coin against the wrapped asset."},"input":{"anyOf":[{"type":"object","properties":{"asset":{"type":"string"},"amountAtomic":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36}},"required":["asset","amountAtomic","decimals"],"additionalProperties":false},{"type":"null"}]},"output":{"anyOf":[{"type":"object","properties":{"asset":{"type":"string"},"amountAtomic":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36}},"required":["asset","amountAtomic","decimals"],"additionalProperties":false},{"type":"null"}]},"fee":{"anyOf":[{"type":"object","properties":{"asset":{"type":"string"},"amountAtomic":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36},"percent":{"type":"number"},"amountUsd":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["asset","amountAtomic","decimals","percent","amountUsd"],"additionalProperties":false},{"type":"null"}]}},"required":["direction","input","output","fee"],"additionalProperties":false},{"type":"null"}]},"receivedXmr":{"anyOf":[{"type":"number"},{"type":"null"}]},"delivered":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"depositAddress":{"type":"string"},"depositAddressForms":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["shielded","transparent"]},"address":{"type":"string"}},"required":["kind","address"],"additionalProperties":false}}},"required":["orderId","product","status","asset","direction","chainId","toAddress","createdAt","updatedAt","customerState","errorMessage","coinflipLost","hasReview","destination","depositAddress"],"additionalProperties":false},{"type":"object","properties":{"orderId":{"type":"string"},"product":{"type":"string","enum":["bridge"]},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","awaiting_zec1","processing","completed","failed","expired","refunded","needs_review"]},"asset":{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},"direction":{"type":"string","enum":["withdraw"]},"chainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fromChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"depositChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"fromToken":{"type":"string"},"depositToken":{"type":"string"},"fromTokenSymbol":{"type":"string"},"depositTokenSymbol":{"type":"string"},"fromTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"depositTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"fromAmount":{"type":"string"},"depositAmount":{"type":"string"},"toChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toToken":{"type":"string"},"toTokenSymbol":{"type":"string"},"toTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"expectedOutput":{"type":"string"},"depositTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivingTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"sessionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundRequestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"type":"string"},"amountUsd":{"type":"number"},"bonusStage":{"type":"string","enum":["none","coinflip"]},"coinflipRequested":{"type":"boolean"},"fundingProvider":{"anyOf":[{"type":"string","enum":["privy"]},{"type":"null"}]},"integratorFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","minimumDepositAmount"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["processing"]},"stage":{"type":"string","enum":["processing","confirming","routing","trading","sending","refunding"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["checking"]}},"required":["kind"],"additionalProperties":false}},"required":["kind","stage"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["action_required"]},"action":{"type":"string","enum":["coinflip","refund_address","payout_address"]}},"required":["kind","action"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["paused"]},"reason":{"type":"string","enum":["preparing_refund","below_minimum"]},"minimumDepositAmount":{"type":"string","pattern":"^0*[1-9][0-9]*$","description":"Positive base-10 integer in the asset’s atomic unit."}},"required":["kind","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["completed"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["refunded"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["expired"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["failed"]}},"required":["kind"],"additionalProperties":false}],"description":"Authoritative customer display/action state. Clients must not infer lifecycle from status or resource presence."},"confirmations":{"type":"number"},"requiredConfirmations":{"type":"number"},"depositObserved":{"type":"boolean"},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"actualOutput":{"description":"What the customer received, in atomic units of `deliveredToken` when present, otherwise of `toToken`. Only on completed orders.","type":"string"},"deliveredToken":{"type":"object","properties":{"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"token":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36}},"required":["chainId","token","symbol","decimals"],"additionalProperties":false,"description":"Present only when the order completed in a different asset than `toToken`; `actualOutput` is then denominated in this token."},"coinflipLost":{"type":"boolean"},"hasReview":{"type":"boolean"},"refundRecovery":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["wrong_chain","source","table_deposit"]},"phase":{"type":"string","enum":["address_required","requested","in_progress"]},"chainId":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},"asset":{"type":"object","properties":{"type":{"type":"string","enum":["native","erc20","spl"]},"token":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"type":"string"},"decimals":{"anyOf":[{"type":"integer","minimum":0,"maximum":36},{"type":"null"}]}},"required":["type","token","symbol","decimals"],"additionalProperties":false},"amountAtomic":{"type":"string"},"requestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"suggestedAddress":{"description":"An address the order already has on file for this chain (for table_deposit, the table's payout address), offered as the prefill while phase is address_required. An offer only: nothing is sent to it until it is submitted.","type":"string"},"destination":{"description":"Where the refund goes once that is decided (phase requested or in_progress). source is customer when someone submitted the address, sender when the refund returns to the wallet the deposit came from without anyone having to submit one.","type":"object","properties":{"address":{"type":"string"},"source":{"type":"string","enum":["customer","sender"]}},"required":["address","source"],"additionalProperties":false}},"required":["kind","phase","chainId","asset","amountAtomic","requestedAt"],"additionalProperties":false},{"type":"null"}]},"rewards":{"type":"object","properties":{"status":{"type":"string","enum":["pending","earned","not_eligible"]},"wagyuEarned":{"type":"number"},"wagyuBonusEarned":{"type":"number"},"wagyuCompensation":{"type":"number","minimum":0},"wagyuTotalEarned":{"type":"number"},"policyKey":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","wagyuEarned","wagyuBonusEarned","wagyuTotalEarned","policyKey"],"additionalProperties":false},"destination":{"type":"string"},"amount":{"anyOf":[{"type":"string"},{"type":"number"}]},"txIn":{"anyOf":[{"type":"string"},{"type":"null"}]},"txOut":{"anyOf":[{"type":"string"},{"type":"null"}]},"txid":{"anyOf":[{"type":"string"},{"type":"null"}]},"bridgeSettlement":{"anyOf":[{"type":"object","properties":{"direction":{"type":"string","enum":["deposit","withdraw"],"description":"deposit mints the wrapped asset from a native-coin deposit; withdraw returns the native coin against the wrapped asset."},"input":{"anyOf":[{"type":"object","properties":{"asset":{"type":"string"},"amountAtomic":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36}},"required":["asset","amountAtomic","decimals"],"additionalProperties":false},{"type":"null"}]},"output":{"anyOf":[{"type":"object","properties":{"asset":{"type":"string"},"amountAtomic":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36}},"required":["asset","amountAtomic","decimals"],"additionalProperties":false},{"type":"null"}]},"fee":{"anyOf":[{"type":"object","properties":{"asset":{"type":"string"},"amountAtomic":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36},"percent":{"type":"number"},"amountUsd":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["asset","amountAtomic","decimals","percent","amountUsd"],"additionalProperties":false},{"type":"null"}]}},"required":["direction","input","output","fee"],"additionalProperties":false},{"type":"null"}]},"receivedXmr":{"anyOf":[{"type":"number"},{"type":"null"}]},"delivered":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"xmr1DepositAddress":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["orderId","product","status","asset","direction","chainId","toAddress","createdAt","updatedAt","customerState","errorMessage","coinflipLost","hasReview","destination","xmr1DepositAddress"],"additionalProperties":false}]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/orders":{"get":{"operationId":"listSessionOrders","summary":"List orders owned by a session","tags":["Orders"],"parameters":[{"schema":{"default":200,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false,"description":"Page size for this session's order history."},{"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"in":"query","name":"offset","required":false,"description":"Number of orders to skip. History is ordered most-recent first, so this pages backwards through it."}],"security":[{"orderSession":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"orders":{"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string"},"product":{"type":"string","enum":["swap","bridge","coinflip"]},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","awaiting_zec1","processing","completed","failed","expired","refunded","needs_review"]},"asset":{"type":"string","enum":["xmr","trx","zec"],"description":"Registered native-bridge asset key, never a display symbol."},"direction":{"type":"string","enum":["deposit","withdraw"],"description":"deposit mints the wrapped asset from a native-coin deposit; withdraw returns the native coin against the wrapped asset."},"chainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"depositAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fromChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"depositChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"fromToken":{"type":"string"},"depositToken":{"type":"string"},"fromTokenSymbol":{"type":"string"},"depositTokenSymbol":{"type":"string"},"fromTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"depositTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"fromAmount":{"type":"string"},"depositAmount":{"type":"string"},"toChainId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Non-negative integer chain identifier."},{"type":"null"}]},"toToken":{"type":"string"},"toTokenSymbol":{"type":"string"},"toTokenDecimals":{"type":"integer","minimum":0,"maximum":36},"expectedOutput":{"type":"string"},"depositTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivingTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"sessionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"refundRequestedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"type":"string"},"amountUsd":{"type":"number"},"bonusStage":{"type":"string","enum":["none","coinflip"]},"coinflipRequested":{"type":"boolean"},"fundingProvider":{"anyOf":[{"type":"string","enum":["privy"]},{"type":"null"}]},"integratorFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["orderId","product","status","chainId","toAddress","depositAddress","createdAt","updatedAt"],"additionalProperties":false}}},"required":["orders"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/orders/{id}/review":{"get":{"operationId":"getOrderReview","summary":"Read an order review with an owner session or destination proof","tags":["Orders"],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]},{"destinationProof":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"review":{"anyOf":[{"type":"object","properties":{"orderId":{"type":"string"},"ratingSpeed":{"type":"number"},"ratingRate":{"type":"number"},"ratingExperience":{"type":"number"},"comment":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"}},"required":["orderId","ratingSpeed","ratingRate","ratingExperience","comment","createdAt"],"additionalProperties":false},{"type":"null"}]}},"required":["review"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}},"put":{"operationId":"submitOrderReview","summary":"Submit a completed-order review","tags":["Orders"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ratingSpeed":{"type":"integer","minimum":1,"maximum":5,"description":"How fast the order settled. 1 is worst, 5 is best."},"ratingRate":{"type":"integer","minimum":1,"maximum":5,"description":"How good the rate felt. 1 is worst, 5 is best."},"ratingExperience":{"type":"integer","minimum":1,"maximum":5,"description":"Overall experience. 1 is worst, 5 is best."},"comment":{"description":"Optional free-text feedback.","anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}},"required":["ratingSpeed","ratingRate","ratingExperience"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/orders/{id}/refund-address":{"put":{"operationId":"submitRefundAddress","summary":"Submit a refund address for an eligible order","tags":["Orders"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"refundAddress":{"type":"string","minLength":1,"maxLength":256,"description":"Refund destination. Its chain-specific validity is checked by the engine."}},"required":["refundAddress"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"refundAddress":{"type":"string"}},"required":["ok","refundAddress"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/orders/{id}/deposit-wait/close":{"post":{"operationId":"continueOnArrivedDeposit","summary":"Stop waiting for the rest of a short deposit and continue on what arrived","tags":["Orders"],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]},{"integratorKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}},"/v2/orders/{id}/payout-address":{"put":{"operationId":"submitPayoutAddress","summary":"Submit a replacement payout address when the order asks for one","tags":["Orders"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"payoutAddress":{"type":"string","minLength":1,"maxLength":256,"description":"Refund destination. Its chain-specific validity is checked by the engine."}},"required":["payoutAddress"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,128}$"},"in":"path","name":"id","required":true,"description":"Public order identifier. Not a credential: every read still requires the owner session or the destination proof."}],"security":[{"orderSession":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"payoutAddress":{"type":"string"}},"required":["ok","payoutAddress"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","amount_below_minimum","no_route","rate_limited","unavailable","request_failed"]},"error":{"type":"string"},"minAmountUsd":{"type":"number","exclusiveMinimum":0},"retryAfter":{"type":"number","minimum":0}},"required":["code","error"],"additionalProperties":false}}}}}}}},"servers":[{"url":"/","description":"Current Core API origin."}],"tags":[{"name":"Swaps","description":"Discover assets, obtain quotes, create swaps, and track their durable state."},{"name":"Bridge","description":"Create and track native XMR/XMR1 and TRX/TRX1 bridge orders."},{"name":"Orders","description":"Manage session-owned order actions and history."},{"name":"Activity","description":"Read redacted recent completed activity."},{"name":"Points","description":"Read public Wagyu points balances and rankings."},{"name":"Stats","description":"Read protocol activity statistics."},{"name":"Config","description":"Read client configuration a wallet build should not hardcode."}]}