Connecting a broker
For two brokers, Freedom24 and Interactive Brokers, Borderfolio can read positions and trades directly with read-only credentials you create at the broker. A connection is optional: statement import covers the same ground for every broker.
How a connection works
You create read-only credentials in the broker’s own settings and paste them into Borderfolio, from Add an account → Connect a broker on Accounts or from Settings → Connections. The credentials are checked with a read call before they are saved. No broker password is ever asked for, and the integration has no code that could place, change or cancel an order or move money.
Freedom24
- In Freedom24, open Settings → API and create a key pair.
- Grant it read access only.
- Paste the public key and the secret key into Borderfolio. The secret is shown only once at Freedom24, when the pair is created.
Each sync reads your current positions and your trade history; trades already on record are skipped. More on the Freedom24 connection page.
Interactive Brokers
Interactive Brokers connects through its Flex Web Service: you paste the ID of a Flex Query and a Flex Web Service token, both created in the IBKR portal. Each sync reads complete current holdings and roughly the last 90 days of trades, so import older history from a Flex Query export (see Accounts and statements). Stocks, ETFs and funds are read; options, futures, warrants, CFDs, bonds and crypto are not. A Flex Query that covers several accounts is refused, so create one per account. IBKR tokens expire after at most a year.
Syncing on Free and Pro
- Pro
- Connected accounts sync automatically once a day, and Sync now runs one whenever you like. Syncs are never capped.
- Free
- There is no daily sync. Sync now works, and each press counts as one of the month’s three imports, the same allowance a statement upload uses. The first sync after connecting counts too; connecting is refused up front only when no import is left this month.
As with a statement, new positions from a sync wait for your confirmation. Connecting a broker as a new account counts towards your plan’s account limit.
Revoked keys and disconnecting
If the broker rejects the credentials (because you revoked them or they expired), the connection is marked Reconnect needed and syncing stops until you paste new ones. Disconnect deletes the stored credentials and keeps the holdings and history already imported. You can also revoke the credentials at the broker at any time, which cuts off access immediately.
How credentials are stored
The secret part of the credentials is encrypted with AES-256-GCM before it is stored, decrypted only to sign a request, and never written to logs. The app shows only a hint of the public key so you can tell connections apart.
Last updated . Describes the Borderfolio app as built; screenshots are from the sample portfolio. Figures in the app are informational estimates, not tax, legal or investment advice.