get_quote
Get XMR/USDC swap quote
Step 1. Quote Monero (XMR) <-> native USDC on Arbitrum One; no account or API key. Creates no order. Quotes are estimates. Buy XMR ("get me 1 XMR"): {direction:"u2x", receiveAmount:"1"}. Sell XMR: {direction:"x2u", amount:"0.5"}. direction plus exactly one of amount (what the user sends) or receiveAmount (what they want). Pass to if known. Next: create_swap with next.arguments.
ParameterstobasischainamountdetailagentKeydirectionrequoteOfreceiveAmount
create_swap
Create XMR/USDC swap order
Step 2. Creates the order from get_quote's next.arguments (quoteId, plus to if the quote had none): one order per quote; moves no funds. An order cannot be cancelled; unfunded, it expires. Retry with the same arguments: the default idempotencyKey returns the same order. Fund once, only while payable is true: before signing deposit.payment, get_swap_status {orderId, payment} must return paymentCheck.safeToSend. Next: get_swap_status.
ParameterstodetailquoteIdrequiredidempotencyKeyquoteIntentDigest
get_swap_status
Get swap status
Step 3. waiting_for_funding -> deposit_detected -> swap_processing -> completed, or refunding / terminal_failure (outcome refunded, failed, expired). Long-poll with waitSec 25 and sinceState = the last state; repeat next until terminal. Call it before funding or showing a deposit again. payment: what your wallet will sign; sign only if paymentCheck.safeToSend.
ParametersdetailverifyorderIdrequiredpaymentwaitSecsinceState
get_funding_options
How to fund a swap
Offline. How to get what the user sends: native USDC (not USDC.e) plus a little ETH for gas on Arbitrum One (u2x, default), or XMR in their own wallet (x2u). Pass from {chain, asset} (and amount) for one ordered checklist: quote, fund, re-quote (requoteOf).
Parametersfromamountdetaildirection
Find orders when the orderId is lost (new chat, crash, unknown create outcome): pass the idempotencyKey create_swap used (default q_<quoteId>), or a sessionId. Read-only; addresses redacted; states can lag. Next: get_swap_status (live state, payable).
ParametersdetailsessionIdidempotencyKey
plan_swap
Validate swap inputs
Optional, offline. Checks a partial request (direction, amount or receiveAmount, to) and returns the next question for the user. Skip it when you have what get_quote needs.
ParameterstoamountdetaildirectionreceiveAmount
get_capabilities
Swapper capabilities
Optional. Chains, limits (provider minimum, USD), quote window, idempotency, validation rules, polling and the flow.
Parametersdetail
create_support_ticket
Open support ticket
Stuck or failed swap, or a question: Support answers (get_support_ticket). Follow up with ticketId + replyToken. Never seed phrases or keys.
ParametersdetailmessagerequiredorderIdcategoryticketIdsessionIdreplyTokenwalletAddress
get_support_ticket
Read support replies
Support's answer on your ticket: status, awaiting, thread. Answers take minutes to hours.
ParametersdetailticketIdrequiredreplyTokenrequired
submit_feedback
Rate a swap
Optional, after a swap: a rating 1-5 and a comment. The published average counts one rating per completed Swapper order; a comment marked publishable is shown after operator review.
ParametersdetailratingrequiredcommentorderIdagentNamepublishable
request_agent_key
Register agent key
Optional. Issues a key that identifies this agent; quotes made with it (get_quote agentKey) and their orders use the agent fee (swapper://trust). The operator sees the name and contact given.
ParametersdetailcontactpurposeagentName