Corgi BankDocumentation
OpenAPI

Retain monotonic signed actual custody quantity and explicitly known or unknown valuation

POST/ledger/securities/lots/{id}/observations

Verified non-API-key exact configured service with ledger:securities:bridge required. Only the original exact custodian bridge supplies signed actual physical units, liens and optional actual values/income. Unknown is not zero or par. Authentic mismatches remain exceptions. Same-date refresh requires a strictly later observation timestamp; completed-day basis cannot downgrade. Final close-out requires explicitly zero units, liens and remaining income. 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.

Path parameters

idstringRequired

Headers

Idempotency-KeystringOptional

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

accrued_income_amountinteger or nullOptional
as_ofstring · dateRequired

A business date, YYYY-MM-DD

close_out_completebooleanRequired
currency_codestringRequired
cusipstringRequired
custodian_referencestringRequired
encumbered_unitsintegerRequired
evidenceobjectRequired
3 child attributes
datastring · byteRequired
formatstringRequired
sha256stringRequired
external_account_referencestringRequired
fair_value_amountinteger or nullOptional

Actual custody units at supplied price

key_idstringRequired
legal_entitystringRequired
lot_idstringRequired
master_cash_ledger_account_idstringRequired

Example lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm

observed_atstring · date-timeRequired
original_execution_sha256stringRequired
original_settlement_sha256stringOptional
priceinteger or nullOptional
price_basisstringOptional

Optional actual bid/ask/mid/last source; repo requires bid

signaturestringRequired
unitsintegerRequired

Actual custodian quantity, distinct from trade-date book quantity

valuation_basisstringOptional

Intraday uses start of AsOf; day_close uses start of AsOf+1

versionstringRequired

Returns

200 OK

The Bank Securities Lot object.

Errors

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

400401403404409412413422424429500503

to move to open esc to close