Adding Wallets via API
Automate your crypto tracking by directly pulling data from blockchains. Breezing automatically scrapes all relevant chains for your wallet address, saving you from having to select networks manually.- On the left menu, click the + (New) button next to Wallets.
- Select Blockchain.
- Enter the public wallet address (e.g., your Treasury wallet).
- Select via Network to pull data directly via API.
- Choose your date range (e.g., from 2023, or from the beginning of the wallet).
- Click Continue. Breezing will automatically scrape all chains and pull in the transactions. You can navigate away or add another wallet while this processes in the background!
Video Transcript
Video Transcript
All right, cool. Now you got uh now you’ve subscribed, you’re ready to go. You’re now ready to add your wallets onto Breezing. So, pretty simple. You just go ahead and hit new over here. Then when you go hit new, it’s going to give you kind of the option to add an exchange or a blockchain. Just go ahead and hit blockchain. And then once you’re in the blockchain view, you just go ahead and select the wallet address that you’re going to add. So, I’m going to click I’m going to choose this one. Go to continue. I’ll call this one maybe my treasury wallet. There we go. Then I’m going to pretty much choose between network or CSV. You’re going to choose network because you want to pull directly via the API. And then here you can select the from date and a to date. So it depends on how far back you want to go. Maybe you only want to pull starting in 2023. Maybe you want to pull from the beginning of the wallet. Whatever you want kind of super flexible and maybe you only want to pull like a specific period. Maybe 2024. You can also it’s super flexible. And difference between us and different maybe subleasers that you use, you don’t have to select the chain every time. So you don’t have to add it add it once for Ethereum, add it once for Optimism, add it once for Polygon. You just go ahead and add it once and our system will automatically scrape all the chains. So once you’ve added it, you go ahead and hit continue. You’ll see while it’s adding transactions, you can also go around and hit dashboard. You can see kind of the transactions being loaded. On top of that, too, while that is happening, you can also add a second wallet address. So you can go ahead and hit wallets as well. You can hit blockchain again and you can add your second wallet address already simultaneously. So I’m going to go ahead and add my second wallet address. Going to hit call this one offs wallet. Hit continue again via network again. I’ll just scrape the whole wallet basically. And then it’s kind of pulling in. You’ll see the Treasury wallet is done. It’s kind of already pulled in all the transactions. So I’m pretty much good to go. And then I’m kind of done at that point. And I’m just waiting now for my Ash wallet.
Adding Exchanges via API
Sync your crypto trading automatically from major exchanges like Binance, Coinbase, or Kraken.- Click the + (New) button next to Wallets on the left menu.
- Select Exchange and choose your exchange (e.g., Kraken).
- Name your connection and select via Network.
- Enter your API Key and Secret Key (generated from your exchange account). Enter an API password if your specific exchange requires one.
- Select your desired date range.
- Click Continue. Breezing will securely pull your trade history.
Video Transcript
Video Transcript
All right, cool. Now, I’m going to show you how to add an exchange basically via an API. So, you’re just going to go ahead. There’s a little plus button here on the left next to wallets. Go ahead and hit it. Here you got the option. You got an exchange or blockchain. I’m going to go ahead and hit exchange. I’m going to go ahead and select Kraken, basically. So, I got a couple options for Kraken. I’m going to select the original one. It’s going to take me next page. I’m going to call this one Kraken. Go to continue. And here I’m going to have three options. Via network, via CSV file, via Kraken file. I’ll show you what the other two are in a second, but first I’m just going to show you via network. Go ahead and hit via network. And here it’s going to ask you for your API and secret key. So these two you actually get from Kraken itself. You got to go into Kraken and you can see pretty much how to generate basically a Kraken API key. Super simple. Just uh follow the rules. You can type in Kraken API key and it’ll show you how to do it. Once you have those, just go ahead and throw in the API key here. Then you go ahead and throw in the secret key. And then some exchanges do require you a password. It’s optional, but you know, just add it. And then you select the from date and to date, wherever kind of you want to start pulling from. Some people maybe want to pull maybe from just 2022 data up to, oh, one second. Maybe 2022 data, January up to, yeah, December 2024 data. So, you can be super customizing what data you want to pull. Um, and then once you’re done, you hit continue and the system will start to pull in the transactions related to the Kraken CSV or sorry to the Kraken API. Nope, pretty fast. It’s already done. You can see already there all them pretty clean. All inputed in there. Cool. Hope that helps.
Uploading via CSV (Unsupported Wallets & Exchanges)
If an API integration isn’t available for a specific wallet or exchange, you can easily use CSV imports.1. Exchange CSV Uploads
If an exchange is not supported via API, you can upload its raw ledger via CSV.
- Export the raw CSV ledger from your exchange (e.g., Bybit, Kucoin).
- In Breezing, click to add a new Exchange, name it, and select via CSV.
- Click Download CSV to grab the official Breezing CSV template.
- Copy the data from your exchange’s export into the corresponding columns of the Breezing template:
- Date / Timestamp
- Transaction Hash / ID
- Asset (the token ticker)
- Amount
- Fee
- Set the Direction Column (
INorOUT):- For deposits or inbound transfers, mark as
IN. - For withdrawals or outbound transfers, mark as
OUT. - Tip in Excel: You can use a formula like
=IF(AMOUNT>0, "IN", "OUT")and drag it down.
- For deposits or inbound transfers, mark as
- Handling Fees on Inbound Transactions (Crucial Step):
- Transaction fees are typically only recognized on outbound (
OUT) transactions in Breezing. - If a fee is tied to an inbound (
IN) transfer, you must extract it into its own line item:- Duplicate the inbound transaction row.
- On the original row, zero out the fee.
- On the duplicated row, set the Direction to
OUTand the Type tofee. - Zero out the token amount on this new row (since no tokens moved, only a fee was paid).
- Keep the fee amount in the fee column.
- Transaction fees are typically only recognized on outbound (
- Format the Date Column:
- Before saving, ensure your date format matches the exact format specified in the top row of the Breezing template.
- Tip in Excel: Right-click the Date column, select Format Cells, choose Custom, and paste the correct format.
- Save your cleaned CSV.
- Back in Breezing, click Upload and select your file.
- Enable Fiat Conversion: Toggle Fetch Fiat Amount ON before submitting. This tells Breezing to automatically price the historical transactions.
- Click Upload Transactions. The transactions will appear immediately, and the fiat amounts will populate shortly after as Breezing scrapes historical pricing.
Video Transcript
Video Transcript
All right, cool, guys. Next thing I’m going to show you, let’s say I have this ledger um out of like a out of an exchange, and I want to add this exchange via CSV because potentially Breezing may not support it. So, way to do that is pretty simple. Let’s go to add a wallet here. Go to exchange. I’m going to select one. Maybe I’ll do by the bit one right here. I’ll go to continue. I’ll go to add via CSV. And then here, there’s going to be a download CSV button. Go ahead and click that. It’s going to download the CSV option right over here. And then now I got everything I need right here. So now what I need to do is I need to grab my CSV ledger that I pulled from Bybit. Let’s say it’s this one. I’m going to start copying the columns into the CSV in Breezing so that like I can start to upload. So I’m going to copy the data in here first. I’ll take the deposit as well. Next, fill that one in here. I’ll leave the wallet from wallet two blank. I’ll blank out the rest of these guys. I’ll take the ID, copy that in here, throw that in here as well. Direction, I’ll do that in a bit. I’ll take the asset and carry that in here as well. Throw the asset in there. Copy the same one with the fee. Then I’ll look at the amount. Take that as well. Add that in there. Then I’ll take the fee. Copy that like so. Throw that in here. And then I’ll leave the amount, fiat item, fee, fiat amount empty. I do have to fill in the direction though. And for that you do kind of like a simple uh kind of statement. So you do if this one is greater than zero then in otherwise make it out basically. So I’m just telling the system this is the formula you can use. I’ll just click this little thing down. I’ll drag it all the way down just like that. So it’s looking pretty good. The other thing I need to also verify is on the fees. Make sure that the fee is associated to the outbound transaction. If there’s a fee associated to an inbound transaction like this one for example, you do need to add it separately. Um, fees on inbounds typically don’t work here. So, what you got to do is you got to just take this one right here. Just copy it again. Put it in here. Zero out this fee. Call this one basically out. Zero out the fiat amount. Oh, sorry, the the token amount there. Make sure that’s not the same. Keep it as a withdrawal. You can call this one type fee. And there you go. You got kind of everything you need here. You’re ready to now start to upload this CSV in here. But before you do, there’s a little date format. So, you got to kind of copy that date format in here as well into the CSV. Bring her down. Go to uh format cells. Go ahead and uh copy that in here like that. Hit format. Now, you just got to save the CSV and then come back to Breezing. Now, you got to upload that CSV. So, go ahead and hit upload. Go to your downloads. Should be somewhere. Oh, there it is. Click there. Now, you got an option here. It’s going to tell you these are the accepted transactions. If there’s any transactions that are wrong, it’ll highlight them here and you can see it. Be sure to highlight the fetch fiat amount. That’s pretty important because it’ll fetch the fiat amounts. Hit upload transactions and then just watch your work. There it is. It’s going to be converting to fiat shortly. But yeah, you can see all your transactions here. The amounts are here. The fee fiats are updating as we speak. Just got to give it a little bit of time. And there we go. They just updated. Just like that. Got your balance and you’re all
2. Unsupported Wallet CSV Uploads
- Export the CSV from a block explorer (e.g., Etherscan) for your desired date range.
- In Breezing, add a Blockchain wallet, name it, and select via CSV.
- Download the Breezing template.
- Copy over the Date, Transaction Hash, Asset ticker (e.g., ETH), Amount, and calculate the Direction (
INorOUT). - As with exchanges, allocate gas/network fees to the outbound transactions.
- Format the Date column properly, save the CSV, and upload it into Breezing with the Fetch Fiat Amount toggle enabled.
Video Transcript
Video Transcript
All right, cool. Now, let’s say you want to add some transactions on a chain that isn’t yet supported on Breezing. It’s totally doable. Just going to show you how it works. So, I’m just going to grab kind of a wallet address here. I’m going to go to Ether Scan. I’m going to put the wallet address in here. It’s going to pull the wallets here. I’m going to go all the way down to the bottom. I’m going to click download CSV exports. This is again a way to get the data, but you can get the data in any possible way, however you want. Let me go to the dates. I’m going to bring it all the way back. Maybe 2019. Go ahead download. It’s going to download the CSV for me. I’m going to open it up. All right, there it is. So now I got the CSV now from the blockchain explorer. This is an Ethereum CSV. So now I got to go back to Breezing. I’m going to hit add a wallet. I’m going to hit blockchain. I’m going to add the wallet address in there. I’m going to call it uh marketing wallet. Let’s call it that for now. Going to continue. I’m going to select via CSV, not via network. That’s how we usually pull via API. Via CSV. I’m going to hit download the CSV. It’s going to give me this template over here. It’s going to open up one second. So, there’s my template. And now, I’m going to basically start matching the columns for each of these CSVs, for each of these templates with these ones. So, I’m going to grab I’m going to grab the date. Take the date one first. Put that date one in here. Going to grab the I transaction hash. Take the transaction hash. Put that one in there. I’m going to leave this empty for now. Um, then I know this is ETH. So, I’m going to put that down as ETH. ETH. ETH. ETH. ETH all the way. Go ahead and bring that down. You’re good to go. I’m going to leave fiat amount amount fiat empty. Wallet front wallet 2 empty. I’ll take the type. So, the type I’m just going to grab this one. Again, you can fill in whatever you want in these. There’s no hardcoded areas, but these are the ones. Uh, these first columns right here, A to G, they’ve got to be filled in. H to L, you can kind of leave blank. However you want to do it there. Then I’m going to come back here. I’m going to grab the amount. So the these I know are like the inbound ones and these I know are like the outbound ones. So first I’m going to go like that. Probably just take the inbound ones. Again, your your data structure could be a little different than mine. All good. But I’m just going to do it this way. So these I know these are all my inbound ones. So I know basically if this one is greater than zero then I know it’s in basically otherwise I’m going to call it out basically. There you go. Run that all the way down. My outbound ones are here now. So that’s all solid and good. Um then I’m going to take my outbound ones. There’s a couple outbound ones here. These are all zero anyway. So it’s all good. Then I got some outbound ones here. Let’s see there. These are the outbound ones. Then I’m going to take there’s another outbound one there right above two above the 035. Put that one in there. There she goes. Then I’ll take these ones all the way down to 0.94. Yeah, there she is. And then Yep. Then I got a zero in the end there. Okay, cool. So I take these ones, put them in there. Zero this out. I’m going to remember those ones because I also want to grab the fees. There’s also some transaction fees there. So, I’ll grab the transaction fees of these guys. Put those in there. This one. Move that over. There’s a little transaction fee on that one as well. Again, the transaction fees are only on the outbounds. So, that you guys are aware. Remember, only outbounds are kind of transaction fees. Grab the transaction fees for these ones. Get those ones. Oh, first I’m going to move those over. One second. Move those over. Then get the transaction fees. Cool. And then that’s it. These ones are all zero. So, zero these out all the way. Zero the rest. There we go. The feed is going to be zeroed out. And there we go. We have our CSV. Now, I need to I need to go back to breezing. Copy that date format. Got to make sure that date format’s nice and nice. So, put that in there. Right click. Format cells. Go ahead. Okay. That. There you go. Then I’m going to save my CSV. Go back to Breezing. Click upload. There it is. I’m going to grab it. Showing me 31 transactions. The way to check that is just go back here. Go all the way down. What do we have? 31 transactions. So, we’re looking good. Come back to breezing. Now, we want to toggle amount fiat on. So, make sure that it converts to fiat. And then, if there’s any issues with your CSV, basically, uh the kind of system will tell you right over here there’s an issue with the CSV. And then you can go ahead and fix it. Usually, it’s a date issue. Once you’re ready, upload that thing. Watch your work. I think it’s already in there. Yeah. So, these transactions are in there now. And then you see they’re just about to be converted to fiat. They just did. And there you go. You’re all done. Your ETH is in there. Fiat’s in there. All set. Uploaded wallet.