Submit Managed Fund Transaction

POST

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

POST

/v1/fundTransaction/submitmanagedfundtransaction

$ curl -X POST https://live.tradovateapi.com/v1/fundTransaction/submitmanagedfundtransaction \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "managedFundingMethodId": 1024,
>   "outgoing": true,
>   "fundAmount": 2500.75,
>   "fundCurrencyId": 840
> }'

200Successful

1 {
2   "errorText": "",
3   "errorHeader": "",
4   "fundTransaction": {
5     "accountId": 78901,
6     "timestamp": "2024-06-10T14:45:00Z",
7     "submitterId": 3456,
8     "outgoing": true,
9     "fundPaymentType": "SHS",
10     "fundAmount": 2500.75,
11     "fundCurrencyId": 840,
12     "id": 458732,
13     "fundDescription": "Withdrawal request via managed funding method",
14     "feePaymentType": "SHS",
15     "feeAmount": 15,
16     "feeCurrencyId": 840,
17     "feeDescription": "Standard withdrawal fee",
18     "bankAccountId": 56789,
19     "approved": false,
20     "status": "Pending",
21     "autoApprovalDate": {
22       "year": 2024,
23       "month": 6,
24       "day": 12
25     },
26     "suspendReason": "Other",
27     "suspendReasonNotes": "Awaiting compliance review",
28     "fullBalance": false,
29     "approvalDate": "",
30     "submissionSignalId": 2345,
31     "achId": 67890,
32     "achrSecondCheckResult": "OK",
33     "achrSecondCheckTimestamp": "2024-06-10T15:00:00Z",
34     "achrSecondCheckComments": "Second check passed successfully",
35     "returnCode": "",
36     "statementDate": {
37       "year": 2024,
38       "month": 6,
39       "day": 10
40     },
41     "managedFundingMethodId": 1024,
42     "paymentInitiationApplicationId": 4321,
43     "transactionIdentifier": "TXN-20240610-458732"
44   },
45   "errorCode": ""
46 }

Submit a deposit or withdrawal through a managed funding method.

Available to: Organization administrators with the shadow account manager permission (deposits); users with access to the account (withdrawals)

Environments: Live

Rate Limit: No endpoint-specific limit

Submit a funding request using a managed funding method — a stored set of bank instructions registered for a shadow account. Set outgoing to false for a deposit or true for a withdrawal.

The request creates a shadow fund transaction (fundPaymentType of SHR for deposits or SHS for withdrawals) with status Pending. The transaction stays pending until it’s approved or rejected, so funds don’t move immediately.

Field Details

The managedFundingMethodId identifies the managed funding method to use. The target account is the one the funding method is registered to, and it must be linked to a shadow account you have access to.

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.

Set fullBalance to true on a withdrawal to request the account’s entire balance. Withdrawals are validated against the account’s available funds, with currency conversion taken into account.

Common Failure Scenarios

Account is closed or restricted
Deposit submitted by a caller who is not an organization administrator with the shadow account manager permission
Withdrawal amount exceeds the account’s available funds
Caller doesn’t have access to the account’s shadow account

Error Messages

`errorText`	Trigger
`"Account not open for funding"`	Account is closed or restricted
`"The selected currency is not supported. Please select either USD, EUR, AUD, or GBP."`	`fundCurrencyId` is not a supported currency
`"You do not have sufficient margin excess to place this request. Please decrease the amount."`	Withdrawal exceeds available funds (`errorCode: InsufficientFunds`)

Related Endpoints

Use submitShadowFundTransaction to submit a shadow account transaction directly, without a managed funding method.

### Submit a deposit or withdrawal through a managed funding method. **Available to:** Organization administrators with the shadow account manager permission (deposits); users with access to the account (withdrawals) **Environments:** Live **[Rate Limit](/overview/core-concepts/rate-limits):** No endpoint-specific limit Submit a funding request using a managed funding method — a stored set of bank instructions registered for a shadow account. Set `outgoing` to `false` for a deposit or `true` for a withdrawal. The request creates a shadow fund transaction (`fundPaymentType` of `SHR` for deposits or `SHS` for withdrawals) with status `Pending`. The transaction stays pending until it's approved or rejected, so funds don't move immediately. **Field Details** The `managedFundingMethodId` identifies the managed funding method to use. The target account is the one the funding method is registered to, and it must be linked to a shadow account you have access to. 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. Set `fullBalance` to `true` on a withdrawal to request the account's entire balance. Withdrawals are validated against the account's available funds, with currency conversion taken into account. **Common Failure Scenarios** - Account is closed or restricted - Deposit submitted by a caller who is not an organization administrator with the shadow account manager permission - Withdrawal amount exceeds the account's available funds - Caller doesn't have access to the account's shadow account **Error Messages** | `errorText` | Trigger | |-------------|---------| | `"Account not open for funding"` | Account is closed or restricted | | `"The selected currency is not supported. Please select either USD, EUR, AUD, or GBP."` | `fundCurrencyId` is not a supported currency | | `"You do not have sufficient margin excess to place this request. Please decrease the amount."` | Withdrawal exceeds available funds (`errorCode: InsufficientFunds`) | **Related Endpoints** - Use [`submitShadowFundTransaction`](/api/rest-api-endpoints/funds/submit-shadow-fund-transaction) to submit a shadow account transaction directly, without a managed funding method.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

managedFundingMethodIdlongRequired

outgoingbooleanRequired

fundAmountdoubleRequired

fundCurrencyIdlongRequired

fundDescriptionstringOptional<=8192 characters

fullBalancebooleanOptional

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