Create a bank securities program
/ledger/securities/programsFresh verified non-API-key staff with ledger:securities:write required. Only bank-owned USD zero-coupon Treasury bills classified AFS, trade-date recognition and the explicit exact daily effective-yield convention are supported. The program binds bank legal entity, actual GL1010 and external master account identity, actual authority, broker/custodian agreements and signing keys. The reviewed dealer allowlist binds actual customer identity, external dealer reference, legal name and source evidence; it never substitutes for current independently reviewed nonaffiliate classification. No customer securities, deposits, HTM, funds, repos or certification are implied. All mutations require verified authority even in local mode; customers and API keys are refused. Evidence JSON is strict and bounded at 5 MiB; complete responses are bounded at 16 MiB and never silently truncated.
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
authorityobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredbridge_subjectstringRequiredbroker_namestringRequiredbroker_referencestringRequiredcustodian_namestringRequiredcustodian_referencestringRequiredcustody_agreementobjectRequired2 child attributes
referencestringRequiredsha256stringRequireddealersarray of objectsRequired4 child attributes
customer_idstringRequiredExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
external_referencestringRequiredidentityobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredlegal_namestringRequiredenabledbooleanRequiredevidence_keysobjectRequiredlegal_entitystringRequiredmaster_cash_external_account_referencestringRequiredmaster_cash_identityobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredmaster_cash_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
max_order_amountintegerRequiredpolicyobjectRequired10 child attributes
accounting_evidenceobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredaccrual_conventionstringRequiredacquisition_feesstringRequiredCapitalize_direct_acquisition_fees
cash_roundingstringRequiredHalf_up_cent
classificationstringRequiredAFS
credit_evidenceobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredcredit_methodstringRequiredReviewed_afs_credit_assessment
recognitionstringRequiredTrade_date
tax_evidenceobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredtax_methodstringRequiredReviewed_external_tax_amounts
providerstringRequiredtrading_agreementobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredvalid_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