v1

latestOpenAPI 3.1.0Proprietary2026-07-2464170247.4 KB

Auto-Conversion Rules

List Auto-Conversion Orders

Retrieve the execution history (orders) for a specific Auto-Conversion Rule.

Response Structure

Each order includes:

Order metadata (ID, status, timestamps)
Source and destination asset info
Fee receipt breakdown
Sub-transactions array (ordered: deposit → conversion → withdrawal)

Sub-Transaction Types

DEPOSIT: Initial fiat/crypto deposit
CONVERSION: RFQ conversion (if applicable)
WITHDRAWAL: Final fiat/crypto withdrawal (if applicable)

Pagination Two query parameter formats are supported:

Flat format (recommended): ?page=1&size=10
Nested format: ?pagination=page=1&size=10

get/v1/customers/{customer_id}/auto-conversion-rules/{auto_conversion_rule_id}/orders

Path parameters

customer_idstring required

Customer ID (UUID format)

auto_conversion_rule_idstring required

Auto-Conversion Rule ID (UUID format)

Query parameters

statusstring

Filter by order status. Valid values: "INIT", "DEPOSIT_COMPLETED", "CONVERSION_COMPLETED", "COMPLETED", "DEPOSIT_FAILED", "CONVERSION_FAILED", "WITHDRAWAL_FAILED"

pageinteger

Page number (starts from 1, default: 1)

sizeinteger

Number of items per page (1-100, default: 10)

{
  "page": 1,
  "size": 10
}

Response

Successfully retrieved order list

totalstring required

Total number of orders matching the query

Example response

{
  "total": "10",
  "items": [
    {
      "auto_conversion_order_id": "f1e2d3c4-b5a6-47e8-9f0a-1b2c3d4e5f6a",
      "auto_conversion_rule_id": "e9ece207-8fd6-400e-872b-409701e57b74",
      "source": {
        "asset": "USDC",
        "network": "ETHEREUM"
      },
      "destination": {
        "asset": "USDC",
        "network": "ETHEREUM",
        "wallet_address": "0x71a6c6be0be5f28ef4ea7541749d90d9c66fec7d",
        "external_account_id": "381b013e-8893-11f0-b308-2eaa4f6974f2"
      },
      "receipt": {
        "initial": {
          "amount": "75.00",
          "asset": "USD"
        },
        "developer_fee": {
          "amount": "75.00",
          "asset": "USD"
        },
        "deposit_fee": {
          "amount": "75.00",
          "asset": "USD"
        },
        "conversion_fee": {
          "amount": "75.00",
          "asset": "USD"
        },
        "withdrawal_fee": {
          "amount": "75.00",
          "asset": "USD"
        }
      },
      "sub_transactions": [
        {
          "customer_id": "14f20ebd-893b-11f0-b308-2eaa4f6974f2",
          "account_id": "BZ-A2C4-9XPN",
          "recipient_id": "f77a8df1-a2b3-4c5d-9e8f-1234567890ab",
          "transaction_id": "aac5201f-7f1c-11f0-b018-de09fc637374",
          "amount": "500",
          "asset": "USDC",
          "network": "ETHEREUM",
          "transaction_fee": {
            "value": "10.55",
            "asset": "USDC"
          },
          "platform_fee": {
            "value": "10.55",
            "asset": "USDC"
          },
          "partner_fee": {
            "value": "10.55",
            "asset": "USDC"
          },
          "source": {
            "wallet_address": "0x71a6c6be0be5f28ef4ea7541749d90d9c66fec7d",
            "external_account_id": "2e92e758-893e-11f0-b308-2eaa4f6974f2",
            "amount": "500",
            "asset": "USDC",
            "network": "ETHEREUM",
            "bank_name": "HSBC Bank USA, N.A.",
            "bank_account_name": "TechStart Holdings LLC"
          },
          "destination": {
            "wallet_address": "0x71a6c6be0be5f28ef4ea7541749d90d9c66fec7d",
            "external_account_id": "2e92e758-893e-11f0-b308-2eaa4f6974f2",
            "amount": "489.45",
            "asset": "USDC",
            "network": "ETHEREUM",
            "bank_name": "JPMorgan Chase Bank, N.A.",
            "bank_account_name": "TechStart Holdings LLC",
            "reference": "6471f23f-6b54-42e4-a2f3-febef7caac18"
          },
          "memorandum": "first transaction",
          "created_at": "2025-08-21T07:56:57.981Z",
          "modified_at": "2025-08-21T07:56:57.981Z"
        }
      ],
      "created_at": "2025-01-12T10:00:00Z",
      "updated_at": "2025-01-12T14:30:00Z"
    }
  ]
}