Create a receive ruleset

​

Create an immutable receive ruleset and provision dedicated deposit addresses. The recipient must be an ACTIVE wallet registered to the owning account. Pass subaccountId to create one for a direct child. Addresses start PENDING and provision asynchronously. INSTANT is a preference: an unavailable corridor, destination, or pool falls back to NETTED; a deposit over the applicable account threshold is held.

Body
required
application/json
  • deliveredAsset
    Type: string
    min length:  
    1
    required
  • deliveredChain
    Type: string
    min length:  
    1
    required
  • toAddress
    Type: string
    min length:  
    1
    required
  • idempotencyKey
    Type: string
    min length:  
    1
    max length:  
    255
  • metadata
    Type: object
    Empty object
  • mode
    Type: string enum
    values
    • NETTED
    • INSTANT
  • name
    Type: string
    min length:  
    1
    max length:  
    120
  • subaccountId
    Type: string Format: uuid

    Create this under one of your subaccounts instead of the authenticated account. Must be a direct child of the authenticated account.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/api/v1/rulesets
curl https://api.bettermoney.com/api/v1/rulesets \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "",
  "deliveredAsset": "",
  "deliveredChain": "",
  "toAddress": "",
  "mode": "NETTED",
  "metadata": {},
  "idempotencyKey": "",
  "subaccountId": ""
}'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "accountId": "123e4567-e89b-12d3-a456-426614174000",
  "name": null,
  "status": "ACTIVE",
  "deliveredAsset": "string",
  "deliveredChain": "string",
  "toAddress": "string",
  "mode": "NETTED",
  "metadata": {},
  "addresses": [
    {
      "chain": "string",
      "failureReason": "string",
      "status": "PENDING",
      "address": null
    }
  ],
  "createdAt": "2026-09-04T20:22:27.427Z"
}

Default Response