v1

latestOpenAPI 3.0.32026-07-26184851.6 MB

Auto Settlements

Child Address Update Rule

This endpoint allows you to update an existing auto-settlement rule for a specific address. By providing the necessary parameters in the request body, you can modify the conditions and actions for the auto-settlement process.

Request Body Parameters

Parameter	Type	Required	Description
type	string	No	The settlement rule type: withdraw, swap, gateway, or earn. Sending it on an update migrates a legacy rule onto the explicit type system and applies the type validations; omit it to keep the rule's current behavior.
name	string	No	The name of the auto-settlement rule. A descriptive title reflecting its purpose.
isActive	boolean	No	Indicates whether the rule is currently active. true = enabled, false = disabled.
order	string	No	The order in which this rule should be processed. Possible values: FASTEST, CHEAPEST, RECOMMENDED, NO_SLIPPAGE.
slippageTolerance	string	No	The acceptable slippage tolerance (as a percentage). Example: "5" = 5% tolerance.
source	object	No	Details about the source of the settlement.
├─ assets	array of strings	No	List of asset types involved (e.g., ["USDT"]).
├─ minAmount	string	No	The minimum amount required for settlement (e.g., "1").
├─ maxAmount	string	No	The maximum amount that can be settled (e.g., "1000").
├─ blockchain	string	No	The blockchain network used for the settlement.
destination	object	No	Details about the destination of the settlement.
├─ asset	string	No	The asset type to which the settlement is directed.
├─ address	string	No	The address where the settlement will be sent.
├─ blockchain	string	No	The blockchain network for the destination.

patch/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}

Request body

type'withdraw' | 'swap' | 'gateway' | 'earn'

Settlement rule type. Sending it on an update migrates a legacy rule onto the explicit type system; omit it to keep the rule's current behavior.

isActiveboolean

namestring

orderstring

slippageTolerancestring

Example request

{
  "type": "swap",
  "destination": {
    "address": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22",
    "asset": "USDC",
    "blockchain": "optimism"
  },
  "isActive": true,
  "name": "Swap from USDT to OP USDC",
  "order": "FASTEST",
  "slippageTolerance": "5",
  "source": {
    "assets": [
      "USDT"
    ],
    "blockchain": "base",
    "maxAmount": "1000",
    "minAmount": "1"
  }
}

Response

200

messagestring

statusCodenumber

Example response

{
  "data": {
    "createdAt": "2025-08-26T17:28:38.273Z",
    "destination": {
      "address": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22",
      "asset": "USDC",
      "blockchain": "optimism"
    },
    "id": "48c52f4a-c0bf-45c9-a322-1fef00f00431",
    "isActive": true,
    "name": "Swap from USDT to OP USDC",
    "order": "FASTEST",
    "slippageTolerance": "5",
    "source": {
      "assets": [
        "USDT"
      ],
      "blockchain": "base",
      "maxAmount": "1000",
      "minAmount": "1"
    },
    "updatedAt": "2025-08-26T17:32:08.108Z"
  },
  "message": "Auto settlement rule updated successfully",
  "statusCode": 200
}