v1

latestOpenAPI 3.1.0Proprietary2026-07-2464170247.4 KB

Auto-Conversion Rules

List Auto-Conversion Rules

Retrieve all Auto-Conversion Rules for a customer with pagination support.

Note: List response does not include source_deposit_info. Use the retrieve endpoint to get full details including deposit info.

Sub-accounts Set include_subaccounts=true on the main account to list Auto-Conversion Rules across the main account and all sub-accounts under the same enterprise. Sub-account requests are always scoped to that sub-account. Each item carries its owning customer_id and account_id. Defaults to false (current customer only).

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/list

Path parameters

customer_idstring required

Customer ID (UUID format)

Query parameters

include_subaccountsboolean

For main accounts, include rules from the main account and all sub-accounts (default: false). Sub-accounts are always scoped to themselves.

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 Auto-Conversion Rule list

totalstring required

Total number of Auto-Conversion Rules matching the query

Example response

{
  "total": "5",
  "items": [
    {
      "customer_id": "14f20ebd-893b-11f0-b308-2eaa4f6974f2",
      "account_id": "BZ-A2C4-9XPN",
      "auto_conversion_rule_id": "e9ece207-8fd6-400e-872b-409701e57b74",
      "nickname": "My USD to USDC Rule",
      "source": {
        "asset": "USDC",
        "network": "ETHEREUM"
      },
      "destination": {
        "asset": "USDC",
        "network": "ETHEREUM",
        "wallet_address": "0x71a6c6be0be5f28ef4ea7541749d90d9c66fec7d",
        "external_account_id": "381b013e-8893-11f0-b308-2eaa4f6974f2"
      },
      "deposit_info_status": "ACTIVE",
      "source_deposit_info": {
        "network": "wire",
        "reference_code": "25BO475M7V",
        "recipient_name": "1Money Company, LLC",
        "bank_name": "Sample Bank Name",
        "routing_number": "121140399",
        "account_holder_name": "Atomic Brokerage LLC",
        "account_number": "123-456789-0",
        "country_code": "USA",
        "street": "1234 5th Avenue, New York, NY 10011",
        "city": "New York",
        "region": "NY",
        "postal_code": "10011",
        "bic_code": "ABCDEF00",
        "minimum_deposit_amount": "1"
      },
      "created_at": "2025-01-12T10:00:00Z",
      "modified_at": "2025-01-12T14:30:00Z"
    }
  ]
}