Firefish Step-by-Step Guide
Firefish offers the following workflows:
- Firefish Borrow - enables Borrowers to receive cash loans while using Bitcoin as collateral
- Firefish Invest - enables Investors to earn interest on their investment by providing funds for Bitcoin-backed loans
Borrowing & Locking Bitcoin
- Firefish Borrow enables Borrowers to receive cash loans while using Bitcoin as collateral
- To secure your loan, we require you to place your Bitcoin in a designated multi-signature escrow address. This escrow can only be accessed in two ways: returned to your wallet (e.g. if you pay back the loan) or transferred to the liquidator's address (e.g. if you don't repay the loan by the due date).
- For the loan to be safe for both you and the Investor, it's important that the value of the collateral always exceeds the value of the loan. The required initial Loan-To-Value ratio is 50%, which means the value of collateral is 2x the size of the loan.
- If the value of your Bitcoin falls close to the value of the loan (due to a significant drop in the Bitcoin exchange rate), your Bitcoin will be sold on the open market, and the proceeds will be used to pay off the loan. This process is known as liquidation. The current liquidation level is set at 95% loan-to-value (LTV), meaning that if the value of your collateral gets to 95% of the loan amount, liquidation would be triggered to protect the lender's interests.
- You have the option to add more Bitcoin to the collateral to maintain a safe margin and prevent liquidation. Furthermore, if you are able to pay off the loan early, it eliminates the risk of liquidation entirely.
- In a highly unlikely scenario of a complete meltdown of Firefish infrastructure you have at your disposal a text file with a ‘Recovery transaction’ which gives you (the Borrower) the ability retrieve your Bitcoin from the escrow. In such a scenario, you can use the 'Broadcast transaction' feature on a standard blockchain explorer like Mempool.space, one month after the loan matures, to unlock and send your Bitcoin back to your return address. You can download this transaction during the escrow setup process, or directly from the loan card on the platform.
Firefish Borrow Step-By-Step
- If you’re interested in borrowing cash against your Bitcoin, navigate to the ‘Borrow’ menu and select ‘Request a loan’.
- Next, fill in the details about Amount you’d like to borrow, currency, loan period and your prefererred interest rate (in % p.a.). The ‘Loan request summary’ element will calculate the Amount due, as well as details about the amount of Bitcoin required for such deal.
- Your loan request will appear under the ‘My loan requests’ tab. Should you wish to cancel your request, simply click on the ‘Cancel’ button.
- Once you are matched with an Investor, you will be asked to ‘Accept’ or ‘Reject’ the deal.
- Next, you will proceed to confirming the details of the deal and accepting the Terms of Service and Loan and Security Agreement.
- Next, you will proceed to the Bitcoin escrow setup process which will guide you through locking your Bitcoin collateral.
- First, due security reasons you will be asked to confirm your current firefish.io app password.
- Next, enter your Bitcoin return address. This address will be used to return your Bitcoin collateral at maturity. Please note that this address can’t be changed during the lifetime of the loan!
- You can then proceed to the Bitcoin transfer. You can either use the embedded QR code or the Bitcoin funding address displayed below the Bitcoin amount. If you’re copy & pasting the Bitcoin funding address, please make sure you transfer the exact amount of Bitcoin that is displayed in the ‘Bitcoin amount’ field.
- After your Bitcoin transaction is successfully completed the next steps in the Escrow setup process will be conducted by the Oracles. In the mean time, you can safely return to the Dashboard.
- Once Oracle complete their duties a notification from Firefish will be sent to you and you will be required to finalize the process by clicking ‘Complete setup’.
- After the setup is completed, the investor will receive a notification to proceed with the bank transfer and confirm the payment.
- The final step is to confirm that you have received cash from the Investor. In such case, click the ‘Confirm’ button next to ’Payment confirmation’ on your loan card.
- In the Payment confirmation window select the tick-box and click ‘Confirm funds’. This provides Firefish with a proof that the funds have successfully arrived on your bank account.
- You are all set! The loan card contains all details about your loan, as well as a link to loan documents and Bitcoin collateral details and various actions available under the ‘Loan Actions’ menu.
- Finally, 1week before the maturity, you will have access to ‘Transfer instructions’ menu which provides you with all repayment details, including Investor’s bank account and the Amount due to be repaid. 2 weeks, 1 week, 2 days and on the day of maturity you will receive an email notification about the need to repay the loan. These notifications will be sent to you automatically until the moment you confirm the repayment.
- Once you repay your loan (i.e. send the Amount due to the Investor via a bank transfer), you can confirm the repayment in the following window by clicking “Confirm bank transfer”.
- Upon confirmation from the Investor, your Bitcoin will be returned to you within the next 72 hours and your loan is successfully closed.
EARLY REPAYMENT: You also have an option to repay your loan before the maturity. To do so, please select the ‘Request early repayment’ option in the ‘Loan Actions’ menu.
We will then seek agreement from the investor that they are ready to confirm the repayment of your loan. Once they agree, you will get notified and the platform will guide you through the repayment process.
📑 Loan actions menu on the loan card enables a quick access to key actions related to the loan:
- View loan documents - access to loan agreement and loan confirmation
- Top-up collateral - start a collateral top-up process
- Save recovery transaction - download text file of the Bitcoin recovery transaction. In a highly unlikely scenario of a complete meltdown of Firefish infrastructure this transaction gives you (the Borrower) the ability retrieve your Bitcoin from the escrow. In such a scenario, you can use the 'Broadcast transaction' feature on a standard blockchain explorer like Mempool.space, one month after the loan matures, to unlock and send your Bitcoin back to your return address.
- Request early repayment - submit a request to repay the loan before maturity
- Add maturity event to calendar - download .ics file to import loan maturity event into your calendar
⬆️ Collateral top-up is a feature that allows you to send additional Bitcoin to your escrow should you be willing to improve your Loan-to-Value (LTV) ratio, for example in an event of a margin call.
Please bear in mind, that this is the only way of adding more Bitcoin to your collateral. Any other approach, for example directly sending more Bitcoin to the escrow address, would result in loss of your Bitcoin!
To add more Bitcoin to your collateral, select the “Top-up collateral” item in the Loan actions menu of the loan card. You will be guided through a similar process as during the Escrow setup phase (point 7 onwards of this step-by-step guide).
In addition, you will be able to input your preferred Bitcoin amount to top up or you can keep the recommended value, that is automatically calculated to get your LTV back to 50%. Based on your input, the Top-up amount menu will calculate your new liquidation price, collateral health indicator, as well as the new LTV.
Investing
- Firefish Invest enables Investors earn income by providing funds for Bitcoin-backed loans
- To ensure the security of your loan, we require the Borrower to place their Bitcoin in a designated multi-signature escrow address. You can easily track the activity on this escrow address using a public blockchain explorer.
- Your investment is always protected as the value of the collateral exceeds the value of the loan.
- If the value of the Bitcoin collateral drops close to the value of the loan (due to a decline in the Bitcoin price), the collateral will be sold on the open market and the proceeds used to pay back your investment. This process is called liquidation. Liquidation may also occur if the Borrower fails to pay back the loan on the due date.
- You don't need to worry about handling, trading, or exchanging Bitcoin yourself. You can choose to use a trusted third party, known as the Liquidator, to handle the process of liquidation on your behalf. However, if you are comfortable working with Bitcoin, you have the option to opt-out and act as your own liquidator.
Investing Step-by-Step
For Investors, there are two methods of interacting with the platform available under the ‘Invest’ menu:
- Loan Marketplace - displays all available deals that haven’t been matched with a particular investor. Investors can select any of the available deals and accept the opportunity.
- Watchdog - an email notification service that enables Investors to receive investment opportunities directly to their inbox. Watchdog allows Investors to customize their preferences for currencies, minimum and maximum loan amounts, interest rates, and loan periods.
❗️IMPORTANT: Investors have two options for the collateral liquidation model in the event of borrowers' default (i.e. failing to repay the loan) or price liquidation (i.e. when the value of Bitcoin collateral not sufficient anymore):
- Self-liquidation - Investor receives Bitcoin collateral to their designated liquidation address.
- Firefish liquidation - Firefish manages the collateral liquidation process on behalf of the Investors, and Investors receive their investment back in bank currency.
Please, see the ‘Liquidation Preferences’ section below for more details.
Loan Marketplace lists all loan requests that haven’t been matched with any of the Investors on the platform and are available for execution.
- If you’re interested in any of the listed deals, select ‘Investment details’ and you can accept the deal by clicking ‘Accept Opportunity’ the button:
- In the next step you can double-check the deal details and tick respective boxes to agree with the Terms of Service and Loan & Security Agreement.
- Once you confirm the details a notification will be sent to the Borrower to confirm loan details on their side and to lock Bitcoin collateral. Your deal will be marked as ‘Pending investment’.
- In the next step, the Borrower locks their Bitcoin collateral. Once the process, which might take a couple of days, is finalized, you will be notified to transfer funds to Borrower’s bank account. The details for the transfer are available under ‘Bank transfer / Transfer funds’ segment of the loan card.
- Once you execute the funds transfer, you need to confirm this by selecting the “I confirm” tick-box and clicking “Confirm bank transfer”.
- Finally, the Borrower confirms that they have received the funds and your deal becomes active.
- At maturity, you will have access to ‘Confirm return’ menu which gives you the ability confirm that Borrower returned your investment with interest earned (Amount due). Once funds received you can proceed to confirming the repayment by selecting the “I confirm” tick-box and clicking on “Confirm repayment” button.
- Your investment is successfully closed!
Watchdog is an email notification service that enables Investors to receive investment opportunities directly to their inbox. Watchdog allows Investors to customize their preferences for currencies, minimum and maximum loan amounts, interest rates, and loan periods.
- To create a Watchdog, select 'Invest / My watchdogs’ and click ‘Create watchdog’ button.
- Select your preferences, such as minimum and maximum investment amount, currency, loan periods and minimum acceptable interest rate in % p.a.
- Your Watchdog is created and available under ‘My watchdogs’ menu.
- If a Borrower submits a new loan request that is in line with your preferences, you will get notification to your inbox and will be able to accept or reject that particular offer. Once accepted, you will follow the same steps as in the above ‘Loan Marketplace’ guide, from step number 2.
Liquidation is a protective process designed to safeguard investors in two scenarios:
- Default - where the Borrower fails to repay their loan
- Price liquidation - triggered if the Bitcoin price falls to a ‘Liquidation price’ level set for each deal. The threshold for price liquidation is set at 95% of the loan-to-value (LTV) ratio, calculated as the notional amount plus interest, compared to the actual value of the Bitcoin collateral.
There are two types of liquidation methods available for Investors:
- Self-liquidation - Investors receive Bitcoin collateral to their designated liquidation address, which they set during the deal setup process.
- Firefish liquidation - Firefish manages the collateral liquidation process on behalf of the Investors, and Investors receive their investment back in bank currency. Firefish receives the collateral only once the Investor is fully repaid. This mode allows Investors not to worry about handling cryptographic material, such as private keys or about interacting with exchanges.
Firefish liquidation is set as the default option. If you prefer self-liquidation for each deal instead, please navigate to ‘My Account / Settings’ and enable the ‘Self-liquidation’ option:
If ‘Self-liquidation’ is on, you will be prompted to provide your Bitcoin liquidation address when confirming your investment :
Alternatively, you can switch back to Firefish Liquidation when confirming the deal by triggering the ‘I want to self-liquidate’ button.
NOTE: It is not possible to change the liquidation method for live deals and deals that are in or past the Bitcoin collateral locking process stage.