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": 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 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.

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

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