My key returns 401 "Valid access token required." What is wrong?
My key returns 401 "Valid access token required." What is wrong?
Send your tenant key in the
x-tenant-api-key header on every request. That 401 appears whenever the header is missing or the key is invalid, even though the message mentions an access token. Your JWT code, if any, is fine. See Authentication.My order shows TIMED_OUT. What now?
My order shows TIMED_OUT. What now?
Create a new order and send to its fresh deposit address. Orders expire about 30 minutes after creation if no deposit arrives, and nothing is lost at that point. Never send funds to an expired order’s address. If you sent right at the deadline, contact Support with the order UUID and your transaction hash.
I sent an amount outside the order's range.
I sent an amount outside the order's range.
Contact Support with the order UUID and the deposit transaction hash. Every order carries
minimalAmount and maximalAmount, and those two fields bind the deposit you actually send, whatever amount you quoted. Check them before broadcasting. Anything inside the range settles normally.Where do my settled funds arrive?
Where do my settled funds arrive?
At the
receivingAddress you set when creating the order. The winning solver pays out there from its own capital (solver auctions). Once the status is COMPLETED, fetch the order with GET /v1/orders/{uuid} to see the delivery transaction.How long does a fill take?
How long does a fill take?
Average swap time is under 30 seconds once your deposit confirms. The variable part is the confirmation count, which differs by chain; the catalog’s
neededConfirmations field gives the number for each one. See Supported chains.Are quotes binding?
Are quotes binding?
Treat a quote as a live snapshot and create the order right away. Quotes stay indicative until your deposit confirms on-chain; the rate locks at confirmation, so refresh anything stale. There’s currently no protocol fee on top (Fees).
Do I need an account?
Do I need an account?
No. The tenant key covers quoting, order creation, and tracking. Signing in with a wallet signature is optional and adds order history under
GET /v1/orders. See No accounts.How do I earn points?
How do I earn points?
Sign in with your wallet at vane.xyz and swap. Every 100 dollars of volume earns one point, bridges earn 10% of that, and referrals add more. Your rank and league are on your rewards page. See Points and referrals.
Can I use the key shown in the docs?
Can I use the key shown in the docs?
Yes. It is Vane’s shared tenant key and it covers a normal integration. If you’re integrating Vane into a wallet or another product and need custom parameters or separate order tracking, contact Support for a dedicated API key. Keep any key on your server. See Authentication.
Is there a refund if the swap fails?
Is there a refund if the swap fails?
Yes. Your deposit stays in escrow at the per-order address, so a swap that can’t complete returns the deposit to you. An order stuck in
ERROR always means contact Support.Is the order UUID a secret?
Is the order UUID a secret?
Treat it like one. Anyone holding a UUID can read the full order, deposit and receiving addresses included, with no authentication. Keep UUIDs out of logs and public URLs, and share one only with support.
Why did my request return a 500 with a readable message?
Why did my request return a 500 with a readable message?
Invalid input (an unknown token ID, a malformed address, a zero amount) returns
500 with a descriptive message. Match on the message text and fix the input. Errors lists the patterns.
