Record the interest on reserve balances rate from a date, pending independent review (treasury staff)

POST/ledger/reserve-interest/rates

Record the interest on reserve balances (IORB) rate from a date, pending independent review. The ledger's guard admits ledger:treasury:write on this route and refuses ledger:post; the store admits only a verified staff person (never an API key) holding that scope who stepped up within five minutes, and records them as the maker. The rate applies only once a different treasury staff member approves it. An idempotency key is required, and the table rejects update, delete and truncate.

Headers

Idempotency-KeystringRequired

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

effective_datestring · dateRequired

A business date, YYYY-MM-DD

rate_bpsintegerRequired

The annual rate in basis points the Federal Reserve announced

source_refstringRequired

Where it was announced

Returns

200 OK

The Reserve Interest object.

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503