Browse Brokers & importing trades

All topics

File formats, size limits and upload errors

Broker-specific original reports, the 5 MB app limit, and how to interpret upload results and errors.

Same on every platform Updated
On this page

What this does

Everything the upload will and will not take, and how to read the errors it produces.

The AI import screen, before a file is chosen — Web
The AI import screen, before a file is chosen

Accepted files

Use the original report named in your broker’s guide. Accepted formats depend on the selected broker; an extension in the picker does not mean every broker can read that report.

File typeWhen to use it
CSV or TXTThe execution-level export named in the broker guide
XLS or XLSX workbookA supported original workbook, including the documented PropReports and Upstox routes
HTM or HTMLThe original supported report, such as a MetaTrader statement
PDFA specific supported broker statement; arbitrary PDFs are not supported

For example, eToro requires its original XLSX statement, while FYERS and Wealthsimple require their supported original CSV. Do not convert a workbook or PDF unless the broker guide explicitly asks for that conversion. Keep report columns, sheets, dates, currency and account details intact.

Text encoding and separators also depend on the report. Supported text readers handle UTF-8, a byte-order mark and relevant UTF-16 reports; supported delimited reports may use commas, semicolons or tabs. See Supported brokers for the route to use.

The size ceiling

The broker upload screen’s limit is 5 MB (5 MiB, 5 × 1,024 × 1,024 bytes) per file on web, iPhone, iPad and Android. A file exactly at that boundary can pass the size check; larger files are refused before upload. File type and report validation still apply.

If the file is larger, export smaller date ranges. Preserve the original report format. See Re-uploading files and duplicate trades.

The server separately refuses any upload over 20 MB (20 MiB), the same limit on every client. AI import uses that 20 MB limit too: on web, the AI upload page checks it before it sends the file, so an oversized file is refused straight away. The 20 MB server limit is not the size the broker upload screen lets you select.

The one that confuses everyone: a failed upload that worked

The app stops waiting for an answer after five minutes. The server keeps working for up to nine. A genuinely large file can therefore show an error on screen while the import completes behind it.

If a big upload appears to fail, wait a minute and check your trades before doing anything else. If they are there, the import worked and only the reply was late. If they are not, upload again. Uploading the same file twice never doubles anything.

Upload error messages

MessageWhat it meansWhat to do
No valid executions found in file after parsing and validationThe file was read and contained no usable fills.Almost always the wrong report from your broker. See My import said success but nothing appeared.
File size must be less than 5MBThe selected file exceeds the app’s 5 MiB ceiling.Export a shorter date range.
This upload is too large. Use a file up to 20 MB, or export a shorter date range and upload each file separately.The file is over the server’s 20 MB limit, which also applies to AI import.Export a shorter date range and upload each file separately.
Invalid IANA timezoneThe timezone value sent with the upload was not a real zone name.Set the timezone again from the picker rather than typing it.
fileName and fileContent are requiredThe file was not attached properly.Pick the file again.
User must be authenticatedYour session expired mid-upload.Sign in again and retry.
Upload failed unexpectedlySomething went wrong that has no specific handler.Retry once. If it repeats, send the file and the broker name to support.

Any raw technical error is rewritten into readable wording before you see it, with a fallback saying the file could not be imported and to check it and try again.

Errors you can hit elsewhere in VEXA

These are the app-wide error messages, including the two that come up around importing: a file that is too large, and a broker connection that has been lost.

Every error message VEXA shows, and what to do about it
CodeWhat you seeWhat it meansWhat to do
auth/invalid-credentialCouldn't sign inThat email or password didn't match our records.Try again or use Forgot Password to reset.
auth/user-not-foundNo account foundWe couldn't find an account with that email.Check the email or create a new account.
auth/wrong-passwordCouldn't sign inThat email or password didn't match our records.Try again or use Forgot Password to reset.
auth/email-already-in-useEmail already in useAn account with this email already exists.Sign in instead, or use a different email.
auth/weak-passwordPassword too weakPlease choose a stronger password.Use at least 8 characters with a mix of letters and numbers.
auth/invalid-emailInvalid emailPlease enter a valid email address.No action needed.
auth/too-many-requestsToo many attemptsWe've paused sign-in for a few minutes for your security.Wait a moment and try again.
auth/network-request-failedConnection troubleWe couldn't reach our servers.Check your internet and try again.
permission-deniedAccess deniedYou don't have permission to do that.Try signing out and back in. If it keeps happening, contact support.
unavailableConnection troubleWe're having trouble reaching our servers.Check your internet and try again.
deadline-exceededThat took too longThe request timed out before we could finish.Please try again.
resource-exhaustedYou've hit a limitYou've reached the limit for this feature on your current plan.Wait for your next reset or upgrade your plan.
file-too-largeFile too largeThat file is bigger than we can process.Try a smaller file or split it into parts.
broker-disconnectedBroker disconnectedWe've lost the connection to your broker.Reconnect from your profile.
subscription-requiredPro featureThis feature is available on the Pro plan.Upgrade to unlock it.
already-subscribedAlready subscribedYou already have an active VEXA subscription.Manage or change your plan from your profile instead of starting a new checkout.
schedule-unavailablePlan change not scheduledWe couldn't schedule this plan change, and no charge was made.Please try again shortly or contact support.
defaultSomething went wrongWe hit an unexpected snag.Please try again. If it keeps happening, contact support.

What you should see

A result panel naming the detected format, counting imported trades, duplicates skipped, open positions saved and any rows that could not be read. While it runs, a progress display steps through the stages with live counters, and the screen stays blocked so you do not navigate away mid-import. Large files can take a minute.

Your uploaded files

The original file is kept for 30 days and then deleted automatically. That window matters if you ask support to look at an import: after 30 days the file is gone and the investigation has to start from your data instead.

If it doesn’t work

  • The file is rejected before uploading. Check the extension against the table above.
  • The upload works and the trades do not appear. See My import said success but nothing appeared.
  • Some rows failed. The result panel lists them with a reason each. Fix those rows and upload again. The rows that succeeded the first time are skipped.

Related

Still stuck? Email support@vexatrade.ai.