Skip to main content
GET
/
api
/
v1
/
swaps
/
orders
/
history
Get Order History
curl --request GET \
  --url https://api.staging.kaleidoswap.com/api/v1/swaps/orders/history \
  --header 'Authorization: Bearer <token>'
{
  "orders": [
    {
      "id": "<string>",
      "rfq_id": "<string>",
      "side": "BUY",
      "from_type": "LIGHTNING",
      "from_asset": "<string>",
      "from_amount": 100000,
      "to_type": "LIGHTNING",
      "to_asset": "<string>",
      "to_amount": 100000,
      "price": 123,
      "pay_in": "LIGHTNING",
      "pay_out": "LIGHTNING",
      "maker_pubkey": "<string>",
      "ln_invoice": "<string>",
      "onchain_address": "<string>",
      "min_onchain_conf": 123,
      "rgb_recipient_id": "<string>",
      "rgb_invoice": "<string>",
      "dest_bolt11": "<string>",
      "dest_onchain_address": "<string>",
      "dest_rgb_invoice": "<string>",
      "refund_address": "<string>",
      "payment_hash": "<string>",
      "payment_secret": "<string>",
      "swapstring": "<string>",
      "status": "OPEN",
      "created_at": 123,
      "expires_at": 123,
      "filled_at": 123,
      "refund_txid": "<string>",
      "requires_manual_refund": false,
      "payment_status": "NOT_PAID",
      "payment_difference": 123,
      "last_payment_check": 123,
      "email": "<string>",
      "failure_reason": "<string>"
    }
  ],
  "total_count": 123,
  "has_more": true
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

status
enum<string> | null
Available options:
OPEN,
PENDING_PAYMENT,
PAID,
EXECUTING,
FILLED,
CANCELLED,
EXPIRED,
FAILED,
PENDING_RATE_DECISION
limit
integer
default:50
skip
integer
default:0

Response

Successful Response

orders
SwapOrder · object[]
required

List of orders

total_count
integer
required

Total number of orders matching the filter

has_more
boolean
required

Whether there are more orders available