Skip to content

Brokers

What it does

The Brokers page manages ArkFolio’s supported broker connections. Holdings from connected brokers are combined on Holdings, while open trades appear on Positions.

ArkFolio currently exposes six broker connections:

  • Broker authorisation flow: Zerodha Kite, Upstox, and Fyers. ArkFolio sends you to the broker’s authorisation page and receives a session after approval.
  • Credential form: Angel One, Dhan, and Groww. The required fields differ by broker and are shown in ArkFolio.

Credential requirements

Use the current form as the definitive field list:

BrokerFields currently requested by ArkFolio
Angel OneAPI key, client ID, password, and TOTP secret
DhanClient ID and access token
GrowwAPI key and API secret; an active Groww Trading API subscription is required

Broker credentials and tokens are sensitive. Do not share them. For information about ArkFolio’s data handling, see the current Privacy Policy and Terms of Service.

Connect a broker-authorised account

  1. Open Brokers from the bottom of the sidebar.
  2. Find Zerodha Kite, Upstox, or Fyers and select Connect.
  3. Complete the broker’s authorisation flow.
  4. Return to ArkFolio and confirm that the broker card shows its current connection state.

Broker sessions can expire. Reconnect through the same flow when ArkFolio shows an expired or disconnected state.

Connect a credential-form account

  1. Obtain the required access or API credentials from the broker.
  2. Open that broker’s connection form in ArkFolio.
  3. Enter each field exactly as requested.
  4. Save the connection and review the resulting status on the broker card.

Refer to the broker’s current documentation for account permissions, subscriptions, credential creation, and expiry rules.

Optional saved holdings snapshots

The Brokers page includes an opt-in Save a snapshot of my holdings setting.

When enabled:

  • ArkFolio stores an encrypted copy of successfully fetched holdings for the signed-in account.
  • If a broker session later expires or a live fetch fails, a fresh saved snapshot may keep that broker’s holdings visible.
  • Snapshot holdings are re-priced with the latest market data ArkFolio can obtain; when no new quote is available, the stored price may remain in use.
  • The Holdings page clearly identifies brokers being served from saved data and shows when the snapshot was captured.
  • A snapshot does not keep the broker session active and does not sync later transactions. Reconnect to refresh quantities and cost data.
  • Snapshots are considered stale after 14 days.
  • Turning the setting off purges saved snapshots. Disconnecting a broker deletes that broker’s saved snapshot.

The snapshot contains holdings data, not the broker password or access token used for the connection.

Disconnect a broker

Select Disconnect on the broker card and confirm the action. ArkFolio stops using that session, clears the affected portfolio caches, and deletes that broker’s saved holdings snapshot if one exists. The action does not close or modify the brokerage account itself.

Troubleshooting

  • Check the broker’s own portal first when credentials or authorisation fail.
  • Confirm that API access or any required subscription is active.
  • Reconnect an expired session before diagnosing missing live data.
  • A saved snapshot can preserve a view of holdings, but it cannot replace a valid connection for current quantities or positions.

For additional steps, see Troubleshooting → A broker won’t connect.