Corgi BankDocumentation
OpenAPI

Create a bank securities program

POST/ledger/securities/programs

Fresh 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-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

authorityobjectRequired
2 child attributes
referencestringRequired
sha256stringRequired
bridge_subjectstringRequired
broker_namestringRequired
broker_referencestringRequired
custodian_namestringRequired
custodian_referencestringRequired
custody_agreementobjectRequired
2 child attributes
referencestringRequired
sha256stringRequired
dealersarray of objectsRequired
4 child attributes
customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

external_referencestringRequired
identityobjectRequired
2 child attributes
referencestringRequired
sha256stringRequired
legal_namestringRequired
enabledbooleanRequired
evidence_keysobjectRequired
legal_entitystringRequired
master_cash_external_account_referencestringRequired
master_cash_identityobjectRequired
2 child attributes
referencestringRequired
sha256stringRequired
master_cash_ledger_account_idstringRequired

Example lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm

max_order_amountintegerRequired
policyobjectRequired
10 child attributes
accounting_evidenceobjectRequired
2 child attributes
referencestringRequired
sha256stringRequired
accrual_conventionstringRequired
acquisition_feesstringRequired

Capitalize_direct_acquisition_fees

cash_roundingstringRequired

Half_up_cent

classificationstringRequired

AFS

credit_evidenceobjectRequired
2 child attributes
referencestringRequired
sha256stringRequired
credit_methodstringRequired

Reviewed_afs_credit_assessment

recognitionstringRequired

Trade_date

tax_evidenceobjectRequired
2 child attributes
referencestringRequired
sha256stringRequired
tax_methodstringRequired

Reviewed_external_tax_amounts

providerstringRequired
trading_agreementobjectRequired
2 child attributes
referencestringRequired
sha256stringRequired
valid_fromstring · dateRequired

A business date, YYYY-MM-DD

valid_throughstring · dateRequired

A business date, YYYY-MM-DD

Returns

200 OK

The Bank Securities Program object.

Errors

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

400401403404409412413422424429500503

to move to open esc to close