Submit Shadow Fund Transaction

POST

https://live.tradovateapi.com/v1/fundTransaction/submitshadowfundtransaction

POST

/v1/fundTransaction/submitshadowfundtransaction

curl -X POST https://live.tradovateapi.com/v1/fundTransaction/submitshadowfundtransaction \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "shadowAccountId": 1,
  "outgoing": true,
  "fundAmount": 1.1,
  "fundCurrencyId": 1
}'

200Successful

{
  "errorText": "string",
  "errorHeader": "string",
  "fundTransaction": {
    "accountId": 1,
    "timestamp": "2024-01-15T09:30:00Z",
    "submitterId": 1,
    "outgoing": true,
    "fundPaymentType": "ACHR",
    "fundAmount": 1.1,
    "fundCurrencyId": 1,
    "id": 1,
    "fundDescription": "string",
    "feePaymentType": "ACHR",
    "feeAmount": 1.1,
    "feeCurrencyId": 1,
    "feeDescription": "string",
    "bankAccountId": 1,
    "approved": true,
    "status": "Approved",
    "autoApprovalDate": {
      "year": 1,
      "month": 1,
      "day": 1
    },
    "suspendReason": "CurrencyConversionRequired",
    "suspendReasonNotes": "string",
    "fullBalance": true,
    "approvalDate": "2024-01-15T09:30:00Z",
    "submissionSignalId": 1,
    "achId": 1,
    "achrSecondCheckResult": "DataUnavailable",
    "achrSecondCheckTimestamp": "2024-01-15T09:30:00Z",
    "achrSecondCheckComments": "string",
    "returnCode": "string",
    "statementDate": {
      "year": 1,
      "month": 1,
      "day": 1
    },
    "managedFundingMethodId": 1,
    "paymentInitiationApplicationId": 1,
    "transactionIdentifier": "string",
    "fasterPaymentReference": "string"
  },
  "errorCode": "AccountLockFailed"
}

Submit a deposit or withdrawal against a shadow account.

Available to: Organization administrators with shadow fund transactions enabled

Environments: Live

Rate Limit: No endpoint-specific limit

Move funds in or out of a shadow account — a customer trading account whose cash is backed by your organization’s entity account. Set outgoing to false for a deposit or true for a withdrawal.

Unlike standard funding requests, shadow fund transactions are approved and applied immediately: the transaction is created with status Approved and the account’s cash balance updates right away.

Your organization admin user needs the shadowFundTransactionsEnabled property to call this endpoint. If your calls return an access denied error, contact your NinjaTrader representative to have it enabled.

Field Details

The shadowAccountId identifies the shadow account, which must be linked to an open, unrestricted trading account.

The fundCurrencyId must correspond to one of the supported currencies: USD, EUR, AUD, GBP, or CAD. Currency IDs are environment-specific — use the /currency/list endpoint to retrieve valid IDs.

The transactionIdentifier is optional but recommended as an idempotency key. It’s stored as the transaction description, and submitting a shadow transaction whose identifier already exists on the account is rejected as a duplicate.

Set fullBalance to true on a withdrawal to request the account’s entire balance.

Balance Protection

Deposits are checked against your entity account: if the combined cash balance of all shadow accounts plus the deposit would exceed the entity account’s balance (including any configured buffer), the request is rejected. Withdrawals are checked against the shadow account’s available funds.

Common Failure Scenarios

Caller is not an organization administrator, or doesn’t have shadowFundTransactionsEnabled
Linked trading account is closed, restricted, or missing
Deposit would push total shadow balances above the entity account balance
Withdrawal amount exceeds the shadow account’s available funds
transactionIdentifier was already used on the account

Error Messages

`errorText`	Trigger
`"Fund transaction with provided identifier already exists."`	Duplicate `transactionIdentifier` (`errorCode: DuplicateShadowTransaction`)
`"Account not open for funding"`	Linked trading account is closed, restricted, or missing
`"The selected currency is not supported. Please select either USD, EUR, AUD, or GBP."`	`fundCurrencyId` is not a supported currency
`"Total shadow accounts cash balance exceeds entity account cash balance."`	Deposit would exceed the entity account’s backing balance
`"You do not have sufficient margin excess to place this request. Please decrease the amount."`	Withdrawal exceeds available funds (`errorCode: InsufficientFunds`)

Related Endpoints

Use submitManagedFundTransaction to submit a shadow account transaction through a stored managed funding method with pending approval.
Use submitFundTransaction for standard (non-shadow) account funding.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

shadowAccountIdlongRequired

outgoingbooleanRequired

fundAmountdoubleRequired

fundCurrencyIdlongRequired

fullBalancebooleanOptional

transactionIdentifierstringOptional<=8192 characters

Response

FundTransactionResponse

errorTextstringOptional<=8192 characters

Non-empty if the request failed

errorHeaderstringOptional<=8192 characters

Non-empty if the request failed

fundTransactionobjectOptional

errorCodeenumOptional

AccountLockFailed, AchDepositAboveMaximum, AchDepositBelowMinimum, AchDepositExpected, AchDepositFrequencyExceeded, AchDepositHoldPeriod, AchDisclosureNotAccepted, AchNoApprovedApplications, AchPendingDepositExists, AchWithdrawalFrequencyExceeded, ApprovalStatusLocked, BankAccountNSF, ConcurrentRequestRejected, DuplicateAchReturn, DuplicateShadowTransaction, FullBalanceRequestPending, FullBalanceWithAchHolds, FullBalanceWithOpenPositions, FullBalanceWithPendingAch, InsufficientFunds, TransactionAlreadyApproved, TransactionAlreadyDeclined, TransactionNotApplicable, TransactionNotFound, Unknown, WireDepositHoldPeriod