Skip to main content
GET
/
orders
Get all active orders
curl --request GET \
  --url https://api-partner.houdiniswap.com/v2/orders \
  --header 'Authorization: <api-key>'
{
  "orders": [
    {
      "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"
    }
  ],
  "totalPages": 1,
  "total": 1
}

Authorizations

Authorization
string
header
required

Query Parameters

page
integer<int32>
default:1

Page number

Required range: 1 <= x <= 10000
pageSize
integer<int32>
default:100

Page size

Required range: 1 <= x <= 100
multiId
string

Get all orders from a multi swap

Maximum string length: 64
status
enum<number>[]

Order status

  • -2 Order is being initialized (label: INITIALIZING)
  • -1 Order initialized (label: NEW)
  • 0 Waiting for deposit confirmation (label: WAITING)
  • 1 Deposit is being confirmed (label: CONFIRMING)
  • 2 Exchange is in progress (label: EXCHANGING)
  • 3 Order is going through anonymization (label: ANONYMIZING)
  • 4 Order completed successfully (label: FINISHED)
  • 5 Order has expired (label: EXPIRED)
  • 6 Order failed (label: FAILED)
  • 7 Order was refunded (label: REFUNDED)
  • 8 Order was deleted (label: DELETED)
Available options:
-2,
-1,
0,
1,
2,
3,
4,
5,
6,
7,
8
from
string<date-time>

Created from date ISO 8601 format

to
string<date-time>

Created until date ISO 8601 format

sortBy
enum<string>

Sort by field

Available options:
created,
updated,
amount
sortOrder
enum<string>

Sort order direction

Available options:
asc,
desc

Response

Success

orders
object[]
required
totalPages
number<double>
required
total
number<double>
required