{"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. `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"},"withdrawalFlatXmr":{"type":"number"},"withdrawalFlatTrx":{"type":"number"}},"required":["depositFeeRate","withdrawalFeeRate","withdrawalFlatXmr","withdrawalFlatTrx"],"additionalProperties":false},"minimums":{"type":"object","properties":{"xmr":{"type":"number"},"trx":{"type":"number"}},"additionalProperties":false},"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"],"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/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"]},"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"],"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"}]},"estimatedTime":{"anyOf":[{"type":"number"},{"type":"null"}]},"feeFraction":{"anyOf":[{"type":"number"},{"type":"null"}]},"priceImpact":{"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"},"twapEstimate":{"anyOf":[{"type":"object","properties":{"durationMinutes":{"type":"number"}},"required":["durationMinutes"],"additionalProperties":false},{"type":"null"}]}},"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}},"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","processing","completed","failed","expired","refunded","needs_review"]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"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"]}},"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"},"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."},"asset":{"type":"string","enum":["xmr","trx"],"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."},"asset":{"type":"string","enum":["xmr","trx"],"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"],"description":"Registered native-bridge asset key, never a display symbol."},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","processing","completed","failed","expired","refunded","needs_review"]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"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"]}},"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"}},"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"],"description":"Registered native-bridge asset key, never a display symbol."},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","processing","completed","failed","expired","refunded","needs_review"]},"customerState":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["awaiting_deposit"]},"notice":{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"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"]}},"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/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":{"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":{"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/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"},"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"},"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","processing","completed","failed","expired","refunded","needs_review"]},"asset":{"type":"string","enum":["xmr","trx"],"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":{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"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"]}},"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":{"type":"string"},"coinflipLost":{"type":"boolean"},"hasReview":{"type":"boolean"},"refundRecovery":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["wrong_chain"]},"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"]},"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"}]}},"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},"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."},"coinflip":{"anyOf":[{"type":"object","properties":{"eligible":{"type":"boolean"},"accepted":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"seedHash":{"type":"string"},"clientSeed":{"type":"string"},"assetSymbol":{"type":"string"},"assetKey":{"type":"string","enum":["xmr","trx"],"description":"Registered native-bridge asset key, never a display symbol."},"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"}},"required":["round"],"additionalProperties":false}},"policy":{"type":"object","properties":{"edgePercent":{"type":"number"},"milkWinBelow":{"type":"number"},"cowWinAbove":{"type":"number"},"winChancePercent":{"type":"number"},"maxWalletFractionPercent":{"type":"number"}},"required":["edgePercent","milkWinBelow","cowWinAbove","winChancePercent"],"additionalProperties":false},"decisionDeadline":{"type":"string"}},"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":{"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"}]}},"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/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"},{"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"}]}},"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"}},"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","processing","completed","failed","expired","refunded","needs_review"]},"asset":{"type":"string","enum":["xmr","trx"],"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":{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"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"]}},"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":{"type":"string"},"coinflipLost":{"type":"boolean"},"hasReview":{"type":"boolean"},"refundRecovery":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["wrong_chain"]},"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"]},"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"}]}},"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"}},"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","processing","completed","failed","expired","refunded","needs_review"]},"asset":{"type":"string","enum":["xmr","trx"],"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":{"type":"object","properties":{"kind":{"type":"string","enum":["below_expected"]}},"required":["kind"],"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"]}},"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":{"type":"string"},"coinflipLost":{"type":"boolean"},"hasReview":{"type":"boolean"},"refundRecovery":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["wrong_chain"]},"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"]},"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"}]}},"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"]},"status":{"type":"string","enum":["awaiting_deposit","awaiting_xmr1","awaiting_trx1","processing","completed","failed","expired","refunded","needs_review"]},"asset":{"type":"string","enum":["xmr","trx"],"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":[]}],"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."}]}