{"info":{"_postman_id":"ed0f0964-dd41-4efd-8f59-fc2cf13e544a","name":"Nanswap Exchange API","description":"

Zero network fees and ultra fast cryptos exchange. Support +350 crypto. Earn up to 1% of exchanged volume.

Contact Support:
Email: contact@nanswap.com
Discord: https://discord.gg/xwhaMcVcwc

Rewards

Depending of the trading pairs, you can earn up to 1% of exchanged volume.
Rewards are instantly converted into the cryptocurrency of your payment address.
Go to nanswap.com/account?tab=affiliate to set your payment address, to see your rewards details and to see your transactions history.

You can withdraw your rewards at anytime, without any minimum.

Authentication

The /create-order request require an API Key. You can get a free one at nanswap.com/API
It then must be included in the request with a header called \"nanswap-api-key\" that contains your API Key.

Limits

API Calls are limited to 180 requests per minute. If you need higher limit, feel free to contact us.

Your current quota is returned in each response with the following headers:

RateLimit-Limit (req/min limit)
\n
RateLimit-Remaining (remaining quota)
\n
RateLimit-Reset (seconds before reset of your quota)
\n

API Documentation

Nanswap allows to exchange 2 main types of cryptos:

Feeless cryptos, they have 0 network fees. When feeless crypto is used on both side, swap is fully handled by Nanswap, minimum swap amount is very low (<$0.01) and all the exchange process usually takes less than 1 second. Feeless crypto is indicated by a feeless field in /all-currencies
\n
Other cryptos, swap is handled by Nanswap and our trusted Partners, due to the nature of these cryptos, minimum transaction amount (/get-limits) and exchange duration is generally higher than feeless swap.
\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"API Documentation","slug":"api-documentation"}],"owner":"10524662","collectionId":"ed0f0964-dd41-4efd-8f59-fc2cf13e544a","publishedId":"2s7YYu63Wr","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2022-09-14T03:09:55.000Z"},"item":[{"name":"Exchange API","item":[{"name":"List of supported currencies","id":"927d9675-48eb-468c-9e81-ac35a5c69c6b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.nanswap.com/v1/all-currencies","description":"

Returns a Key => Value map of available currencies.

The Key is the ticker, that can be used in the from and to params of the /get-estimate, /get-limit, /create-order.

The Value is the currency info:

name
\n
logo
\n
network Network of the crypto.
\n
hasExternalId Boolean. If the crypto require a memo/id.
\n
feeless Boolean. If crypto has 0 network fees.
\n

\n","urlObject":{"path":["all-currencies"],"host":["https://api.nanswap.com/v1"],"query":[],"variable":[]}},"response":[{"id":"04235c91-d09e-4afd-a230-d1e7b5e03da2","name":"Returns a key=> value map of currencies with ticker as key and currency info as value","originalRequest":{"method":"GET","header":[],"url":"https://api.nanswap.com/v1/all-currencies"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"XNO\": {\n \"ticker\": \"XNO\",\n \"name\": \"Nano\",\n \"image\": \"https://nanswap.com/logo/XNO.svg\",\n \"feeless\": true\n },\n \"BAN\": {\n \"ticker\": \"BAN\",\n \"name\": \"Banano\",\n \"image\": \"https://nanswap.com/logo/BAN.svg\",\n \"feeless\": true\n },\n \"BTC\": {\n \"ticker\": \"btc\",\n \"name\": \"Bitcoin\",\n \"image\": \"...\",\n \"network\": \"btc\",\n \"feeless\": false\n },\n \"ETH\": {\n \"ticker\": \"eth\",\n \"name\": \"Ethereum\",\n \"image\": \"...\",\n \"network\": \"eth\",\n \"feeless\": false\n },\n \"ETH-BSC\": {\n \"ticker\": \"eth\",\n \"name\": \"Ethereum (Binance Smart Chain)\",\n \"image\": \"...\",\n \"network\": \"bsc\",\n \"feeless\": false\n },\n \"ETH-ARBITRUM\": {\n \"ticker\": \"eth\",\n \"name\": \"Ethereum (Arbitrum)\",\n \"image\": \"...\",\n \"network\": \"arbitrum\",\n \"feeless\": false\n }\n}"}],"_postman_id":"927d9675-48eb-468c-9e81-ac35a5c69c6b"},{"name":"Get estimate","id":"065b6996-3826-4975-9db1-21651d7451ec","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.nanswap.com/v1/get-estimate?from=XNO&to=BAN&amount=10","description":"

Get estimated exchange amount.

\n","urlObject":{"path":["get-estimate"],"host":["https://api.nanswap.com/v1"],"query":[{"description":{"content":"

Ticker from

\n","type":"text/plain"},"key":"from","value":"XNO"},{"description":{"content":"

Ticker to

\n","type":"text/plain"},"key":"to","value":"BAN"},{"description":{"content":"

Amount from

\n","type":"text/plain"},"key":"amount","value":"10"}],"variable":[]}},"response":[{"id":"2bf9305e-8255-4dda-a622-340821fdee4d","name":"Estimate","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.nanswap.com/v1/get-estimate?from=XNO&to=BAN&amount=10","host":["https://api.nanswap.com/v1"],"path":["get-estimate"],"query":[{"key":"from","value":"XNO"},{"key":"to","value":"BAN"},{"key":"amount","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"from\": \"XNO\",\n \"to\": \"BAN\",\n \"amountFrom\": 10,\n \"amountTo\": 1650\n}"},{"id":"0cd804c0-4c58-4f3f-a29c-78ea66c68349","name":"Bad request","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.nanswap.com/v1/get-estimate?from=XNO&to=BAN&amount=10","host":["https://api.nanswap.com/v1"],"path":["get-estimate"],"query":[{"key":"from","value":"XNO"},{"key":"to","value":"BAN"},{"key":"amount","value":"10"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Amount is too large (see /get-limits)\"\n}"}],"_postman_id":"065b6996-3826-4975-9db1-21651d7451ec"},{"name":"Get estimate reverse","id":"8e5ac5c6-b7dc-494c-8da0-d0dbca4c85e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.nanswap.com/v1/get-estimate-reverse?from=XNO&to=BAN&amount=1650","description":"

(Only available for feeless crypto)

Get estimate but reversed, it takes toAmount and returns the fromAmount estimation. Allows to let user input directly their toAmount wanted.

\n","urlObject":{"path":["get-estimate-reverse"],"host":["https://api.nanswap.com/v1"],"query":[{"description":{"content":"

Ticker from

\n","type":"text/plain"},"key":"from","value":"XNO"},{"description":{"content":"

Ticker to

\n","type":"text/plain"},"key":"to","value":"BAN"},{"description":{"content":"

Amount to

\n","type":"text/plain"},"key":"amount","value":"1650"}],"variable":[]}},"response":[{"id":"4eac95fa-dd4c-410f-8961-43df6da8c2e4","name":"Estimate","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.nanswap.com/v1/get-estimate-reverse?from=XNO&to=BAN&amount=1650","host":["https://api.nanswap.com/v1"],"path":["get-estimate-reverse"],"query":[{"key":"from","value":"XNO"},{"key":"to","value":"BAN"},{"key":"amount","value":"1650"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"from\": \"XNO\",\n \"to\": \"BAN\",\n \"amountFrom\": 10,\n \"amountTo\": 1650\n}"},{"id":"588c9481-20aa-4140-8485-cd430727b86a","name":"Bad request","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.nanswap.com/v1/get-estimate-reverse?from=XNO&to=BAN&amount=1650","host":["https://api.nanswap.com/v1"],"path":["get-estimate-reverse"],"query":[{"key":"from","value":"XNO"},{"key":"to","value":"BAN"},{"key":"amount","value":"1650"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Amount is too large (see /get-limits)\"\n}"}],"_postman_id":"8e5ac5c6-b7dc-494c-8da0-d0dbca4c85e4"},{"name":"Get order limit amount","id":"96399c06-c83b-4193-bb5f-637a636b807e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.nanswap.com/v1/get-limits?from=XNO&to=BAN","description":"

Returns minimum and maximum from amount for a given pair. Maximum amount depends of current liquidity.

\n","urlObject":{"path":["get-limits"],"host":["https://api.nanswap.com/v1"],"query":[{"description":{"content":"

Ticker from

\n","type":"text/plain"},"key":"from","value":"XNO"},{"description":{"content":"

Ticker to

\n","type":"text/plain"},"key":"to","value":"BAN"}],"variable":[]}},"response":[{"id":"a9f40170-cf23-464c-89f7-cb6d28cc6287","name":"Minimum and maximum from amount to create an order","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.nanswap.com/v1/get-limits?from=XNO&to=BAN","host":["https://api.nanswap.com/v1"],"path":["get-limits"],"query":[{"key":"from","value":"XNO"},{"key":"to","value":"BAN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"from\": \"XNO\",\n \"to\": \"BAN\",\n \"min\": 0.001,\n \"max\": 4732\n}"}],"_postman_id":"96399c06-c83b-4193-bb5f-637a636b807e"},{"name":"Create a new order","id":"fafaac47-a81d-433b-bdcc-b9efd81f3f50","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"nanswap-api-key"},{"key":"value","value":""}]},"isInherited":false},"method":"POST","header":[{"description":"

(Required)

\n","key":"nanswap-api-key","value":"API_KEY"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"from\": \"XNO\",\n \"to\": \"BAN\",\n \"amount\": 10,\n \"toAddress\": \"ban_1f99kwxmkq4zquqwfs3qjznwjsq6s7t6pw6qhmnqmmiq5uofirzbtajhg63g\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nanswap.com/v1/create-order","description":"

Create a new order and returns order data. You need to send the request body as JSON.
A valid API key is required in nanswap-api-key header for this request. You can get one at https://nanswap.com/API

Request:

* from ticker of currency you want to exchange
* to ticker of currency you want to receive
* amount The amount you want to send
* toAddress The address that will recieve the exchanged funds
* extraId (optional) Memo/Id of the toAddress
* userDeviceId (optional) An id representating a unique user

The following parameters are optional and only work when both crypto are feeless:

* permanentPayinAddress (optional) Boolean. Default to false. If true, the response payinAddress can be saved and re-used to convert again any from crypto received to the payoutAddress without having to create new order.
* itemName (optional) An item name that will be displayed on transaction page. Can be used by merchant to provide a better UX to users. Max 128 char.
* maxDurationSeconds (optional) Maximum seconds after what transaction expires. Min: 30s Max: 259200s. Default to 72h or 5min if itemName is set

Reponse:

* id Order id.
* from ticker of currency you want to exchange
* to ticker of currency you want to receive
* expectedAmountFrom The amount you want to send
* expectedAmountTo Estimated value that you will get based on the field expectedAmountFrom
* payinAddress Nanswap's address you need to send the funds to
* payinExtraId If present, the extra/memo id required for the payinAddress
* payoutAddress The address that will recieve the exchanged funds
* fullLink URL of the transaction

\n","urlObject":{"path":["create-order"],"host":["https://api.nanswap.com/v1"],"query":[],"variable":[]}},"response":[{"id":"ca29d09c-069d-4333-83e1-3ff4884779df","name":"Success","originalRequest":{"method":"POST","header":[{"description":"(Required) ","key":"nanswap-api-key","value":"API_KEY"}],"body":{"mode":"raw","raw":"{\n \"from\": \"XNO\",\n \"to\": \"BAN\",\n \"amount\": 10,\n \"toAddress\": \"ban_1f99kwxmkq4zquqwfs3qjznwjsq6s7t6pw6qhmnqmmiq5uofirzbtajhg63g\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nanswap.com/v1/create-order"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"iIt8VosbQGV\",\n \"from\": \"XNO\",\n \"to\": \"BAN\",\n \"expectedAmountFrom\": 10,\n \"expectedAmountTo\": 1850,\n \"payinAddress\": \"nano_3a8i1xwrg4fprne5yjqp7gnjydn3h9br1yghph4ddsojppb7ocrewfsjpusq\",\n \"payoutAddress\": \"ban_1f99kwxmkq4zquqwfs3qjznwjsq6s7t6pw6qhmnqmmiq5uofirzbtajhg63g\"\n}"},{"id":"1c48e76c-c844-4a43-ba6d-289ee0639b59","name":"Bad request","originalRequest":{"method":"POST","header":[{"description":"(Required) ","key":"nanswap-api-key","value":"API_KEY"}],"body":{"mode":"raw","raw":"{\n \"from\": \"XNO\",\n \"to\": \"BAN\",\n \"amount\": 10,\n \"toAddress\": \"ban_1f99kwxmkq4zquqwfs3qjznwjsq6s7t6pw6qhmnqmmiq5uofirzbtajhg63g\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nanswap.com/v1/create-order"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Destination address is not valid\"\n}"}],"_postman_id":"fafaac47-a81d-433b-bdcc-b9efd81f3f50"},{"name":"Get order id data","id":"9b302608-6297-4790-9638-4a70c5afd836","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.nanswap.com/v1/get-order?id=zYkxDxfmYRM","description":"

Returns data of an order id.

Response:

id Order id.
\n
status Order status, can be one of the following : [waiting, exchanging, sending, completed, error]
\n
from ticker of currency you want to exchange
\n
fromNetwork network of the currency you want to exchange.
\n
to ticker of currency you want to receive
\n
toNetwork network of the currency you want to receive.
\n
expectedAmountFrom The amount you want to send
\n
expectedAmountTo Estimated value that you will get based on the field expectedAmountFrom
\n
amountFrom From Amount Exchanged
\n
amountTo To Amount Exchanged
\n
payinAddress Nanswap's address you need to send the funds to
\n
payinExtraId If present, the extra/memo id required for the payinAddress
\n
payoutAddress The address that will recieve the exchanged funds
\n
payinHash Hash of the transaction you sent us
\n
senderAddress Address which sent us the funds
\n
payoutHash Hash of the transaction we sent to you
\n

\n","urlObject":{"path":["get-order"],"host":["https://api.nanswap.com/v1"],"query":[{"description":{"content":"

The order id

\n","type":"text/plain"},"key":"id","value":"zYkxDxfmYRM"}],"variable":[]}},"response":[{"id":"66224573-5de4-416b-b53d-e2be0f25ddb1","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.nanswap.com/v1/get-order?id=iIt8VosbQGV","host":["https://api.nanswap.com/v1"],"path":["get-order"],"query":[{"key":"id","value":"iIt8VosbQGV"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"fromAmount\": 10,\n \"id\": \"Gtsm2OBp0WZ\",\n \"toAmount\": 1850,\n \"status\": \"completed\",\n \"from\": \"XNO\",\n \"to\": \"BAN\",\n \"expectedAmountFrom\": 10,\n \"expectedAmountTo\": 1850,\n \"payinAddress\": \"nano_3a8i1xwrg4fprne5yjqp7gnjydn3h9br1yghph4ddsojppb7ocrewfsjpusq\",\n \"payoutAddress\": \"ban_1f99kwxmkq4zquqwfs3qjznwjsq6s7t6pw6qhmnqmmiq5uofirzbtajhg63g\",\n \"payinHash\": \"CF7D28D215765C2301F20C48E5F732C2BDE5AF846CF4905E6850572F4EA7592C\",\n \"payoutHash\": \"8145E45BB0F70AF3AC23E4B347DF4A0949410B3F3EEDB4779C515ACD058AD3ED\"\n}"},{"id":"d9ea457f-adfe-419f-8fe6-bd0e5fe2bb54","name":"Transaction not found","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.nanswap.com/v1/get-order?id=iIt8VosbQGV","host":["https://api.nanswap.com/v1"],"path":["get-order"],"query":[{"key":"id","value":"iIt8VosbQGV"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Transaction doesn't exist\"\n}"}],"_postman_id":"9b302608-6297-4790-9638-4a70c5afd836"}],"id":"49e702a3-5961-471a-bf99-824d626f1613","_postman_id":"49e702a3-5961-471a-bf99-824d626f1613","description":""}],"event":[{"listen":"prerequest","script":{"id":"4794755e-f4b0-4471-99ea-8d7f841b878b","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"f476b110-2dbe-4afd-94f6-3629466f45d0","type":"text/javascript","exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://api.nanswap.com/v1","type":"string"},{"key":"API_KEY","value":"API_KEY"}]}