Propose a zero-boarded foreign currency book with actual correspondent and authority evidence
POST
/ledger/fx/booksFresh treasury staff with ledger:treasury:write required. The independently reviewed book pins a real noninterest-bearing bank-owned correspondent account, legal entity, USD master cash account, native currency scale, positive limits, short-dated authority and named public bridge keys. No account is funded or external authority inferred. General customer deposits remain USD.
Headers
Idempotency-KeystringRequiredSend on every write that creates or changes money or state; a replay with the same key returns the original result with 200.
Body parameters
accounting_purposestringRequiredbicstringRequiredbridge_subjectstringRequiredcorrespondent_namestringRequiredcountrystringRequiredcurrency_codestringRequiredevidencestringRequiredexternal_account_refstringRequiredlegal_entitystringRequiredmaster_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
max_native_unitsintegerRequiredmax_order_usd_minorintegerRequiredpolicy_referencestringRequiredproviderstringRequiredpublic_keysobjectRequiredvalid_fromstring · dateRequiredA business date, YYYY-MM-DD
valid_throughstring · dateRequiredA business date, YYYY-MM-DD
Returns
200 OK
Errors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503