Skip to main content
POST
Evaluate a proposed transaction against the treasury policies

Authorizations

X-API-KEY
string
header
required

Authorization method required to allow user to access the api endpoints.

Body

application/json
network
string
required

Network the proposed transaction would settle on.

Example:

"eth"

from
string
required

Sending address — the position the projection debits.

Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28"

to
string
required

Destination address.

Example:

"0x8ba1f109551bD432803012645Ac136ddd64DBA72"

asset
string
required

Asset ticker, matched against the workspace balance tickers.

Maximum string length: 64
Example:

"USDC"

amount_usd
string
required

USD value of the proposed transaction. Required: every C149 rule is denominated in USD, and on a blocking path the caller’s own execution quote is the right price to judge against.

Maximum string length: 64
Example:

"15000.50"

amount
string

Quantity in asset units, as a positive decimal string. Optional: every rule on this surface is denominated in USD, so the evaluation reads amount_usd and carries this only as caller context.

Maximum string length: 64
Example:

"15000.50"

counterparty_id
string<uuid>

Expected counterparty for the destination. Must belong to the caller workspace and cover the destination address, otherwise the destination is treated as unknown.

Example:

"9d5c1a7e-4f3b-4c2a-8e6d-1b2c3d4e5f60"

Response

200 - application/json
verdict
enum<string>
required

A breach is blocking: there is no warn tier on this surface. Both outcomes are HTTP 200 — a block is a successful evaluation.

Available options:
blocked,
allowed
breaches
object[]
required
evaluated_policies
number
required

How many treasury policies were evaluated.

Example:

4

Last modified on September 3, 2026