Reciprocal Ruler - free trial reconciliation
ruler_trial_reconcileRun a free settlement reconciliation between AI agents: compare expected and actual KRW amounts to get a deterministic SETTLED_OK, COMPENSATED, or PENDING_RECONCILIATION judgment.
Instructions
Run a settlement reconciliation between two AI agents for free (up to 3 calls per client). Compares the expected amount with what actually settled and returns a deterministic judgment: SETTLED_OK, COMPENSATED (shortfall covered from the holdback), or PENDING_RECONCILIATION (half-open timeout, left pending). Use it to evaluate whether Reciprocal Ruler fits your agent-to-agent transaction flow before paying. Amounts are KRW integers.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"expected_amount_krw": "<expected_amount_krw>",
"actual_settled_krw": "<actual_settled_krw>"
},
"name": "ruler_trial_reconcile"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tx_id | No | Your transaction or order id. Defaults to the idempotency key. | |
| event_type | No | POST_TRADE_REFUND for a refund/shortfall after the trade; HALF_OPEN_TIMEOUT for an unfinished settlement when the timer expires. | POST_TRADE_REFUND |
| quote_hash | No | quote_hash from ruler_quote_lock for this trade, when one was issued. | |
| holdback_krw | No | Holdback reserved from the payment, the pool used to compensate a shortfall (KRW). | |
| idempotency_key | No | Optional on the free trial; generated when omitted. | |
| trial_client_id | No | Stable id for your agent (sent as X-Trial-Client) so the 3 free calls follow this id instead of the shared IP address. | |
| actual_settled_krw | Yes | Amount that actually settled (KRW). | |
| expected_amount_krw | Yes | Amount the buyer and supplier agreed the supplier should receive (KRW). |