Policy reference

View as Markdown

• View as Markdown

  Open this page as Markdown
• Copy for LLM

  Copy page as Markdown for LLMs
• Open in Claude

  Get insights from Claude
• Open in ChatGPT

  Get insights from ChatGPT

This page provides a complete reference for policy configuration options, limit types, matchers, statuses, and error codes. For API operations (create, delete, list), see Manage policies.

Quick reference

Limit types

Matcher types

Duration values

Limit types

PER_TX

Limits the maximum amount for any single transaction.

Example: Limit single ETH transactions to 10 ETH maximum.

{
  "limitType": "PER_TX",
  "symbol": "ETH",
  "limitQty": "10"
}

ROLLING_DURATION

Limits the cumulative amount over a sliding time window.

Common duration values:

Example: Limit ETH withdrawals to 100 ETH per 24 hours.

{
  "limitType": "ROLLING_DURATION",
  "symbol": "ETH",
  "limitQty": "100",
  "duration": "86400s"
}

CONSTANT

Sets a lifetime cap on total withdrawals. Once reached, no further withdrawals are permitted.

Example: Limit total ETH withdrawals to 1,000 ETH ever.

{
  "limitType": "CONSTANT",
  "symbol": "ETH",
  "limitQty": "1000"
}

Matchers

Matchers filter which transactions a policy applies to. Add matchers to create policies that target specific scenarios.

Matcher types

TRANSACTION_TYPE

Applies the policy only to transactions of a specific type.

Values by blockchain:

{
  "limitType": "PER_TX",
  "symbol": "XRP",
  "limitQty": "1000",
  "matchers": [
    {
      "type": "TRANSACTION_TYPE",
      "value": "Payment"
    }
  ]
}

USER

Applies the policy only when a specific user initiates the transaction.

{
  "matchers": [
    {
      "type": "USER",
      "value": "8617b5b5-dfcf-4ffc-9f46-f7cec35a88bd"
    }
  ]
}

API_CREDENTIAL

Applies the policy only when a specific API credential submits the transaction.

{
  "matchers": [
    {
      "type": "API_CREDENTIAL",
      "value": "cred-uuid-here"
    }
  ]
}

ADDRESS_ID

Applies the policy only when sending to a specific address from your address book.

{
  "matchers": [
    {
      "type": "ADDRESS_ID",
      "value": "019d1b00-c1f5-77a0-bda7-0a3d09c668b9"
    }
  ]
}

COUNTERPARTY_ID

Applies the policy only when sending to a specific counterparty.

{
  "matchers": [
    {
      "type": "COUNTERPARTY_ID",
      "value": "019d1b00-c1f5-77a0-bda7-0a3d09c668b9"
    }
  ]
}

SIGN_FOR

Applies the policy only when signing for a specific address. Use this matcher for multi-signature scenarios where your wallet signs on behalf of another address.

{
  "matchers": [
    {
      "type": "SIGN_FOR",
      "value": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh"
    }
  ]
}

Combining matchers

You can add multiple matchers to a single policy. The transaction must match all matchers for the policy to apply.

Example: Limit a specific user to 50 ETH per transaction when sending to a specific counterparty.

{
  "limitType": "PER_TX",
  "symbol": "ETH",
  "limitQty": "50",
  "matchers": [
    {
      "type": "USER",
      "value": "user-uuid-here"
    },
    {
      "type": "COUNTERPARTY_ID",
      "value": "counterparty-uuid-here"
    }
  ]
}

ERC-20 tokens

For ERC-20 tokens, include the contract field with the token's contract address.

{
  "limitType": "PER_TX",
  "symbol": "USDC",
  "limitQty": "10000",
  "contract": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
}

Policy statuses

Error codes

Related documentation

• Policy concepts – Understand scope, lifecycle, and evaluation
• Manage policies – Step-by-step guide and API operations
• Policy best practices – Recommended patterns and troubleshooting