HoudiniSwap API Collection - Import this into Postman for organized endpoint access
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"6733066","collectionId":"64dd7995-032b-4c15-81f4-f7ba4f452eba","publishedId":"2sB3Wwpwrn","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-11-17T09:24:13.000Z"},"item":[{"name":"CEX","item":[{"name":"Performs a quote and returns the best price for the swap pair","id":"2eff78d6-e197-4ffe-a8b4-acce4614cc5b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"YOUR_API_KEY:YOUR_API_SECRET"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-partner.houdiniswap.com/quote?amount=1&from=ETH&to=BNB&anonymous=true&useXmr=false","urlObject":{"path":["quote"],"host":["https://api-partner.houdiniswap.com"],"query":[{"key":"amount","value":"1"},{"key":"from","value":"ETH"},{"key":"to","value":"BNB"},{"key":"anonymous","value":"true"},{"key":"useXmr","value":"false"}],"variable":[]}},"response":[],"_postman_id":"2eff78d6-e197-4ffe-a8b4-acce4614cc5b"},{"name":"Create an exchange order","id":"4638ef2d-4369-4b58-a957-700649d91a04","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"YOUR_API_KEY:YOUR_API_SECRET"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"amount\": 1,\n \"from\": \"ETH\",\n \"to\": \"BNB\",\n \"receiverTag\": \"\",\n \"addressTo\": \"0x000000000000000000000000000000000000dead\",\n \"anonymous\": true,\n \"ip\": \"0.0.0.0\",\n \"userAgent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64)\",\n \"timezone\": \"UTC\",\n \"useXmr\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://api-partner.houdiniswap.com/exchange","urlObject":{"path":["exchange"],"host":["https://api-partner.houdiniswap.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"4638ef2d-4369-4b58-a957-700649d91a04"},{"name":"Get the order status","id":"734af834-9410-4aee-a503-08e40155f22c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"YOUR_API_KEY:YOUR_API_SECRET"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-partner.houdiniswap.com/status?id=","urlObject":{"path":["status"],"host":["https://api-partner.houdiniswap.com"],"query":[{"description":{"content":"Houdini Order ID
\n","type":"text/plain"},"key":"id","value":""}],"variable":[]}},"response":[],"_postman_id":"734af834-9410-4aee-a503-08e40155f22c"},{"name":"Get the list of available swap providers","id":"ce2f6969-9ab8-48c2-83f5-b66a2ab62960","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"YOUR_API_KEY:YOUR_API_SECRET"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-partner.houdiniswap.com/swaps","description":"Returns all enabled swap providers (CEX and DEX) that are supported by the platform. Use the shortName field to identify swap providers in other endpoints.
Use the shortName field as the chain parameter in other endpoints like /dexTokens and shortNameV1 field for CEX endpoints.
Centralized Exchange Endpoints
\n","_postman_id":"69fe733c-cbe5-4265-b676-24350d300476"},{"name":"DEX","item":[{"name":"Get the order status","id":"d8c71452-b008-4367-9b48-6df1e58ec11a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"YOUR_API_KEY:YOUR_API_SECRET"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-partner.houdiniswap.com/status?id=","urlObject":{"path":["status"],"host":["https://api-partner.houdiniswap.com"],"query":[{"description":{"content":"Houdini Order ID
\n","type":"text/plain"},"key":"id","value":""}],"variable":[]}},"response":[],"_postman_id":"d8c71452-b008-4367-9b48-6df1e58ec11a"},{"name":"Get the list of available swap providers","id":"53eedb23-4a53-4b1d-9902-d57274b8de82","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"YOUR_API_KEY:YOUR_API_SECRET"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-partner.houdiniswap.com/swaps","description":"Returns all enabled swap providers (CEX and DEX) that are supported by the platform. Use the shortName field to identify swap providers in other endpoints.
Use the shortName field as the chain parameter in other endpoints like /dexTokens and shortNameV1 field for CEX endpoints.
Page number
\n","type":"text/plain"},"key":"page","value":""},{"description":{"content":"Page size
\n","type":"text/plain"},"key":"pageSize","value":""},{"description":{"content":"Chain Short Name
\n","type":"text/plain"},"key":"chain","value":"ethereum"}],"variable":[]}},"response":[],"_postman_id":"34796d40-fc0e-4e71-ac60-d396fc5812c4"},{"name":"Returns an estimated swap value, min/max","id":"87a9eacf-a24f-4add-ba72-a433c77a3acf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"YOUR_API_KEY:YOUR_API_SECRET"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-partner.houdiniswap.com/dexQuote?amount=100&tokenIdFrom=6689b73ec90e45f3b3e51553&tokenIdTo=6689b73ec90e45f3b3e51558&slippage=0.5&fromAddress=0x1234567890123456789012345678901234567890&toAddress=0x1234567890123456789012345678901234567890","urlObject":{"path":["dexQuote"],"host":["https://api-partner.houdiniswap.com"],"query":[{"description":{"content":"Amount to be quoted
\n","type":"text/plain"},"key":"amount","value":"100"},{"description":{"content":"Id of the token from which the swap is initiated
\n","type":"text/plain"},"key":"tokenIdFrom","value":"6689b73ec90e45f3b3e51553"},{"description":{"content":"Id of the token to which the swap is directed
\n","type":"text/plain"},"key":"tokenIdTo","value":"6689b73ec90e45f3b3e51558"},{"description":{"content":"Slippage percentage
\n","type":"text/plain"},"key":"slippage","value":"0.5"},{"description":{"content":"From address
\n","type":"text/plain"},"key":"fromAddress","value":"0x1234567890123456789012345678901234567890"},{"description":{"content":"To address
\n","type":"text/plain"},"key":"toAddress","value":"0x1234567890123456789012345678901234567890"}],"variable":[]}},"response":[],"_postman_id":"87a9eacf-a24f-4add-ba72-a433c77a3acf"},{"name":"Executes an exchange using provided parameters and path. Returns the exchange object with the status. metadata field contains the transaction data.","id":"6fa98fb1-cfbd-4464-a402-4a39e1bced28","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"YOUR_API_KEY:YOUR_API_SECRET"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"tokenIdFrom\": \"6689b73ec90e45f3b3e51553\",\n \"tokenIdTo\": \"6689b73ec90e45f3b3e51566\",\n \"amount\": 26.2244,\n \"addressFrom\": \"0xb7dE6b6eEBF7401aFea5a49D6405C9048fEf2d40\",\n \"route\": {\n \"allowanceTarget\": \"0x000000000022d473030f116ddee9f6b43ac78ba3\",\n \"blockNumber\": \"23787896\",\n \"buyAmount\": \"7521034096019714\",\n \"buyToken\": \"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\",\n \"fees\": {\n \"integratorFee\": {\n \"amount\": \"26224\",\n \"token\": \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n \"type\": \"volume\"\n },\n \"zeroExFee\": {\n \"amount\": \"39337\",\n \"token\": \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n \"type\": \"volume\"\n },\n \"gasFee\": null\n },\n \"gas\": \"349586\",\n \"gasPrice\": \"246978729\",\n \"issues\": {\n \"allowance\": null,\n \"balance\": null,\n \"simulationIncomplete\": false,\n \"invalidSourcesPassed\": []\n },\n \"liquidityAvailable\": true,\n \"minBuyAmount\": \"7445823755049900\",\n \"route\": {\n \"fills\": [\n {\n \"from\": \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n \"to\": \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n \"source\": \"Swaap_V2\",\n \"proportionBps\": \"10000\"\n }\n ],\n \"tokens\": [\n {\n \"address\": \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n \"symbol\": \"USDT\"\n },\n {\n \"address\": \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n \"symbol\": \"WETH\"\n }\n ]\n },\n \"sellAmount\": \"26224400\",\n \"sellToken\": \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n \"tokenMetadata\": {\n \"buyToken\": {\n \"buyTaxBps\": \"0\",\n \"sellTaxBps\": \"0\"\n },\n \"sellToken\": {\n \"buyTaxBps\": \"0\",\n \"sellTaxBps\": \"0\"\n }\n },\n \"totalNetworkFee\": \"86340305956194\",\n \"zid\": \"0x3f405b49474b5d31499c2456\",\n \"isGasless\": false,\n \"sellTokenAddress\": \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n \"buyTokenAddress\": \"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\",\n \"slippageBps\": 100\n },\n \"addressTo\": \"0xb7dE6b6eEBF7401aFea5a49D6405C9048fEf2d40\",\n \"swap\": \"zx\",\n \"quoteId\": \"69155e0bdb5ab0cbe27e2709\",\n \"signatures\": [\n {\n \"signature\": \"0x413697118050a0623eb3147c94c78cf6658f096a44973c1f484c3c61f29b64b975aa2b4af229c5edcf760f85f3e2e1106235a6d261ce1f62e9875f53860fc87b1c\",\n \"key\": \"permit2\",\n \"swapRequiredMetadata\": {\n \"transaction\": {\n \"to\": \"0x207e1074858a7e78f17002075739ed2745dbaece\",\n \"data\": \"0x1fff991f000000000000000000000000b7de6b6eebf7401afea5a49d6405c9048fef2d40000000000000000000000000eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee000000000000000000000000000000000000000000000000001a7ee51204562400000000000000000000000000000000000000000000000000000000000000a021975786e32e8dece5a5800d0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000006a000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000220000000000000000000000000000000000000000000000000000000000000038000000000000000000000000000000000000000000000000000000000000004a000000000000000000000000000000000000000000000000000000000000005e0000000000000000000000000000000000000000000000000000000000000012438c9c147000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000044a9059cbb000000000000000000000000f9f4fb5cc1e4455f8c6fd0ca48090058443a5e7f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000012438c9c147000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7000000000000000000000000000000000000000000000000000000000000000f000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000044a9059cbb000000000000000000000000ad01c20d5886137e056775af56915de824c8fce50000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000e48d68a156000000000000000000000000207e1074858a7e78f17002075739ed2745dbaece000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002cdac17f958d2ee523a2206206994597c13d831ec700000064c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010438c9c147000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000000000000002710000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000242e1a7d4d00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008434ee90ca000000000000000000000000f5c4f3dc02c3fb9279495a8fef7b0741da956157000000000000000000000000eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee000000000000000000000000000000000000000000000000001ac57840a9cde2000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffc1fb425e000000000000000000000000207e1074858a7e78f17002075739ed2745dbaece000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000000000000000019027100000000000000000000000000000000000006e898131631616b1779bad70bd1d0000000000000000000000000000000000000000000000000000000069155ff300000000000000000000000000000000000000000000000000000000000000c0\",\n \"gas\": \"307795\",\n \"gasPrice\": \"219225935\",\n \"value\": \"0\"\n },\n \"buyAmount\": \"7533203746830402\",\n \"sellAmount\": \"26224400\",\n \"eip712\": {\n \"types\": {\n \"PermitTransferFrom\": [\n {\n \"name\": \"permitted\",\n \"type\": \"TokenPermissions\"\n },\n {\n \"name\": \"spender\",\n \"type\": \"address\"\n },\n {\n \"name\": \"nonce\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"deadline\",\n \"type\": \"uint256\"\n }\n ],\n \"TokenPermissions\": [\n {\n \"name\": \"token\",\n \"type\": \"address\"\n },\n {\n \"name\": \"amount\",\n \"type\": \"uint256\"\n }\n ],\n \"EIP712Domain\": [\n {\n \"name\": \"name\",\n \"type\": \"string\"\n },\n {\n \"name\": \"chainId\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"verifyingContract\",\n \"type\": \"address\"\n }\n ]\n },\n \"domain\": {\n \"name\": \"Permit2\",\n \"chainId\": 1,\n \"verifyingContract\": \"0x000000000022d473030f116ddee9f6b43ac78ba3\"\n },\n \"message\": {\n \"permitted\": {\n \"token\": \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n \"amount\": \"26224400\"\n },\n \"spender\": \"0x207e1074858a7e78f17002075739ed2745dbaece\",\n \"nonce\": \"2241959297937691820908574931991837\",\n \"deadline\": \"1763008499\"\n },\n \"primaryType\": \"PermitTransferFrom\"\n }\n }\n }\n ],\n \"destinationTag\": \"\",\n \"deviceInfo\": \"smacos\",\n \"isMobile\": false,\n \"walletInfo\": \"Rabby Wallet\",\n \"slippage\": null\n}","options":{"raw":{"language":"json"}}},"url":"https://api-partner.houdiniswap.com/dexExchange","urlObject":{"path":["dexExchange"],"host":["https://api-partner.houdiniswap.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"6fa98fb1-cfbd-4464-a402-4a39e1bced28"},{"name":"Confirms a DEX transaction with the provided transaction hash","id":"85001e43-8c96-4bc7-9242-2bb1a40b168e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"YOUR_API_KEY:YOUR_API_SECRET"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id\": \"6689b73ec90e45f3b3e51553\",\n \"txHash\": \"0x123456789abcdef...\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-partner.houdiniswap.com/dexConfirmTx","urlObject":{"path":["dexConfirmTx"],"host":["https://api-partner.houdiniswap.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"85001e43-8c96-4bc7-9242-2bb1a40b168e"},{"name":"Checks if the allowance is enough for the swap","id":"cc4237d2-adde-4f19-8bb8-0dc5db033988","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"YOUR_API_KEY:YOUR_API_SECRET"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"amount\": 26.2244,\n \"tokenIdFrom\": \"6689b73ec90e45f3b3e51553\",\n \"tokenIdTo\": \"6689b73ec90e45f3b3e51558\",\n \"addressFrom\": \"0xb7dE6b6eEBF7401aFea5a49D6405C9048fEf2d40\",\n \"route\": {\n \"quote\": {\n \"expectedAmountOut\": 0.1677196,\n \"minAmountOut\": 0.166881002\n },\n \"amountIn\": 26.2244\n },\n \"swap\": \"mn\",\n \"usePermit\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api-partner.houdiniswap.com/dexHasEnoughAllowance","urlObject":{"path":["dexHasEnoughAllowance"],"host":["https://api-partner.houdiniswap.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"cc4237d2-adde-4f19-8bb8-0dc5db033988"}],"id":"1407acaa-a9a9-4227-9800-7b80e3dabef5","description":"Decentralized Exchange Endpoints
\n","_postman_id":"1407acaa-a9a9-4227-9800-7b80e3dabef5"},{"name":"Others","item":[{"name":"Get the partner volume stats","id":"c104375b-3bf6-4ecf-9763-8f1631dd4fb3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"YOUR_API_KEY:YOUR_API_SECRET"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-partner.houdiniswap.com/volume","urlObject":{"path":["volume"],"host":["https://api-partner.houdiniswap.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c104375b-3bf6-4ecf-9763-8f1631dd4fb3"},{"name":"Get the partner weekly volume stats","id":"4b94c3ab-45fc-4803-a0b9-204df85f8791","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"YOUR_API_KEY:YOUR_API_SECRET"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-partner.houdiniswap.com/weeklyVolume","urlObject":{"path":["weeklyVolume"],"host":["https://api-partner.houdiniswap.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"4b94c3ab-45fc-4803-a0b9-204df85f8791"}],"id":"2a8b228c-0b82-4b5f-b032-e2fd81d84b11","description":"Other API Endpoints
\n","_postman_id":"2a8b228c-0b82-4b5f-b032-e2fd81d84b11"}],"event":[{"listen":"prerequest","script":{"id":"dc4cab41-9f01-4207-ac5b-e55cabe232ba","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"ce2dffcd-14a5-4d91-8d67-2c82811f3101","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"URL","value":"https://api-partner.houdiniswap.com"},{"key":"API_KEY","value":"YOUR_API_KEY"},{"key":"API_SECRET","value":"YOUR_API_SECRET"}]}