Create an investment program
/investment-programsFresh verified staff with payments:investments:write proposes exact actor/input content. The reviewed program binds this bank, broker/custodian identity, public evidence keys, actual agency authority and custody, tax and confirmation agreements. Initial tax reporter and confirmation provider are broker_custodian; bank remuneration is none. This is an agency securities program, not a deposit or a bank-owned portfolio, and no provider certification or blanket regulatory approval is inferred.
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
agency_agreementobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredauthorityobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredbank_remunerationstringRequiredNone; bank fee collection is a separate unsupported workflow
bridge_subjectstringRequiredbroker_namestringRequiredbroker_referencestringRequiredcash_roundingstringRequiredHalf_up_cent only
confirmation_agreementobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredconfirmation_providerstringRequiredBroker_custodian only
custodian_namestringRequiredcustodian_referencestringRequiredcustody_agreementobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredenabledbooleanRequiredevidence_keysobjectRequiredlegal_entitystringRequiredmax_order_amountintegerRequiredproviderstringRequiredrisk_disclosureobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredtax_reporterstringRequiredBroker_custodian only
tax_reporting_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