Connect Binance

Create a read-only Binance API key and connect it to Viktury so your trades sync automatically.

  • BinanceAutomatic read-only syncCSV import

Connecting Binance lets Viktury sync your trades automatically. The key you create only needs read access, so Viktury can see your trade history but can never place an order or withdraw.

Create a read-only API key on Binance

  1. Sign in to Binance, click your profile icon, choose Account, then API Management, and click Create API.

    Binance API Management page with the Create API button at the top right
    Account, then API Management, then Create API.
  2. Keep System generated, click Next, name the key (Viktury is fine) and complete the security checks Binance asks for.

    Binance Choose API Key type dialog with System generated selected and a Next button
    Keep System generated and click Next.
  3. Binance shows your API Key and Secret Key. A new key has only Enable Reading ticked, which is exactly what Viktury needs, so leave the trading and withdrawal options switched off.

  4. Copy the API Key and the Secret Key. The secret is shown only once, so save it before you close the page.

    A new Binance API key with its API Key and Secret Key, and API restrictions with only Enable Reading ticked
    Copy both keys now. Only Enable Reading should be ticked.

Add it to Viktury

On the Add account screen, choose Binance, name the account, and paste your API Key and API Secret into the matching fields. Save, and Viktury runs its first sync.

Viktury Add Exchange Account form with an exchange picked and the API key tab open
Pick your exchange. The steps for it appear right under the tabs.

Futures and funding

A read-only key syncs your spot trades. Binance only shares futures trades and funding payments with a key that has "Enable Futures" switched on, and it only lets you switch that on after you restrict the key to trusted IP addresses. The Add account screen shows the IP addresses Viktury connects from.

Keep in mind that "Enable Futures" also allows futures trading with the key. Viktury never places an order, but if you would rather keep the key read-only, leave futures off and import your futures trades from a Binance CSV export instead. A CSV export does not include funding payments.

Import from a CSV instead

If you would rather not create a key, export your trades from Binance and upload the file.

  1. On binance.com, open Orders, then Spot Order, then the Trade History tab. For futures, use the USD-M futures order page instead.

  2. Click the download icon at the top right of the table (its tooltip says Export Trade History, or Export on the futures page). It opens the Data Download Center.

    Binance Spot Order Trade History tab, with the Export Trade History download icon at the top right
    Orders, Spot Order, Trade History, then the download icon at the top right.
  3. Pick your time range, choose CSV and click Generate. When Binance says the file is ready, click Download.

    Binance Data Download Center with Spot - Trade History, time range buttons including Customize, CSV selected and a Generate button
    Pick a time range, choose CSV, then Generate.
  4. On the Add account screen, choose Binance, open the Upload CSV tab and select the file as Binance gave it to you. Opening and re-saving it in a spreadsheet app can break the import.

    Viktury Add Exchange Account form on the Upload CSV tab, with the base currency and the file picker
    On the Upload CSV tab, pick your file and click Upload Trades.

Troubleshooting

  • Key rejected. Check for extra spaces in the pasted values and confirm the key is enabled on Binance. If you restricted the key to specific IP addresses, that can also block the sync.
  • No trades showing yet. Give the first sync a moment. If the account or the chosen range has no fills, there is nothing to import yet.
  • Permissions too narrow or too broad. If syncing fails, make sure reading is enabled on the key. If you turned on any trading or withdrawal permission, switch it off: Viktury never uses it.