Skip to main content
POST
/
exchanges
/
multi
Create multi exchange
curl --request POST \
  --url https://api-partner.houdiniswap.com/v2/exchanges/multi \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "orders": [
    {
      "from": "6689b73ec90e45f3b3e51564",
      "to": "6689b73ec90e45f3b3e51558",
      "amount": 123,
      "addressTo": "<string>",
      "anonymous": true,
      "destinationTag": "<string>",
      "useXmr": true,
      "walletInfo": "<string>",
      "filters": {
        "onlySwaps": [
          "<string>"
        ],
        "rotatePayoutWallets": true,
        "deviationThreshold": 50,
        "rotationLookback": 50,
        "inLeg": {
          "include": [
            "<string>"
          ],
          "exclude": [
            "<string>"
          ]
        },
        "outLeg": {
          "include": [
            "<string>"
          ],
          "exclude": [
            "<string>"
          ]
        }
      }
    }
  ],
  "filters": {
    "onlySwaps": [
      "<string>"
    ],
    "rotatePayoutWallets": true,
    "deviationThreshold": 50,
    "rotationLookback": 50,
    "inLeg": {
      "include": [
        "<string>"
      ],
      "exclude": [
        "<string>"
      ]
    },
    "outLeg": {
      "include": [
        "<string>"
      ],
      "exclude": [
        "<string>"
      ]
    }
  }
}
'
{
  "multiId": "example-multi-id",
  "orders": [
    {
      "order": {
        "houdiniId": "example-houdini-id",
        "created": "2026-01-01T12:00:00.000Z",
        "depositAddress": "bc1qexampledepositaddress000000000000000000",
        "receiverAddress": "0x9f1f9a5c0f1d9a5c0f1d9a5c0f1d9a5c0f1d9a5c",
        "anonymous": false,
        "expires": "2026-01-01T12:30:00.000Z",
        "status": 0,
        "inAmount": 0.25,
        "inSymbol": "BTC",
        "outAmount": 3.52,
        "outSymbol": "ETH",
        "displayStatus": "WAITING_FOR_DEPOSIT"
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

Body

application/json
orders
object[]
required
Required array length: 1 - 50 elements
filters
object

Provider filters applied to every order in the batch

Response

Multi exchange created

Response for POST /exchanges/multi — per-item envelope, some may be errors

multiId
string
required
orders
object[]
required