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": 12345,
>   "outgoing": true,
>   "fundAmount": 2500.75,
>   "fundCurrencyId": 1
> }'

200Successful

1 {
2   "errorText": "",
3   "errorHeader": "",
4   "fundTransaction": {
5     "accountId": 12345,
6     "timestamp": "2024-06-10T14:45:00Z",
7     "submitterId": 67890,
8     "outgoing": true,
9     "fundPaymentType": "ACHR",
10     "fundAmount": 2500.75,
11     "fundCurrencyId": 1,
12     "id": 987654321,
13     "fundDescription": "Withdrawal from shadow account",
14     "feePaymentType": "ACHR",
15     "feeAmount": 15,
16     "feeCurrencyId": 1,
17     "feeDescription": "Withdrawal processing fee",
18     "bankAccountId": 54321,
19     "approved": true,
20     "status": "Approved",
21     "autoApprovalDate": {
22       "year": 2024,
23       "month": 6,
24       "day": 10
25     },
26     "suspendReason": "",
27     "suspendReasonNotes": "",
28     "fullBalance": false,
29     "approvalDate": "2024-06-10T14:45:00Z",
30     "submissionSignalId": 112233,
31     "achId": 445566,
32     "achrSecondCheckResult": "OK",
33     "achrSecondCheckTimestamp": "2024-06-10T14:46:00Z",
34     "achrSecondCheckComments": "Second check passed successfully",
35     "returnCode": "00",
36     "statementDate": {
37       "year": 2024,
38       "month": 6,
39       "day": 10
40     },
41     "managedFundingMethodId": 778899,
42     "paymentInitiationApplicationId": 334455,
43     "transactionIdentifier": "TXN-20240610-987654"
44   },
45   "errorCode": ""
46 }

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.

### Submit a deposit or withdrawal against a shadow account. **Available to:** Organization administrators with shadow fund transactions enabled **Environments:** Live **[Rate Limit](/overview/core-concepts/rate-limits):** 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`](/api/rest-api-endpoints/funds/submit-managed-fund-transaction) to submit a shadow account transaction through a stored managed funding method with pending approval. - Use [`submitFundTransaction`](/api/rest-api-endpoints/funds/submit-fund-transaction) 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

errorTextstring<=8192 characters

Non-empty if the request failed

errorHeaderstring<=8192 characters

Non-empty if the request failed

fundTransactionobject

errorCodeenum

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