This guide walks you through connecting Deribit to your Parfin account. This assumes that you already have a valid administrator account in Parfin and that you have a valid and verified Deribit account.
1. Preparing Parfin
As an administrator, log into your Parfin account, go to “Counterparties” and click “Connect Counterparty”.
Select “Exchanges” from the tabs and select “Deribit” from the dropdown.
Give this connection any name (this name will show up across your account).
2. Account ID
You can connect Deribit Main or Sub accounts to Parfin, so please make sure you are in the correct Deribit account before going through these steps. Toggle between Deribit accounts in the top-right Menu where your Alias is shown.
Go to Deribit > My Account > Subaccounts tab.
Copy the Public Account ID corresponding to the Deribit Main account, similar to this: 168838.
Paste it in the Parfin window under "Account ID", and make sure to delete all spaces before and after.
If you are connecting a sub-account to Parfin, then copy the “Public Account ID” corresponding to this sub-account and paste it in the Parfin window under “Sub-account ID”, and make sure to delete all spaces before and after.
3. Creating Read-only keys
Go to Deribit > My Account > API tab > “Add new key” button.
Choose the “read” option from all the dropdowns: account, block trade, trade, wallet and custody.
Give the key a name such as “Parfin_RO” (there is a 16-character limit for this field).
Click the Add new key button.
Copy “Client ID” from the created key and paste it in the Parfin window under Read-Only Keys > API-Key.
Go back to Deribit and copy “Client Secret” and paste it into the Parfin window under Read-Only Keys > API-Secret.
4. Creating Transactional keys
Go back to Deribit > My Account > API tab > “Add new key” button.
Choose the “read_write” option from all the dropdowns: account, block trade, trade, wallet and custody.
Give the key a name such as “Parfin_Trans” (there is a 16-character limit for this field).
In the Optional IP Whitelist field input the following IP Address:
- Production environment: 18.135.67.109
- UAT environment: 3.9.99.37
Click the Add new key button.
Copy “Client ID” from the created key and paste it in the Parfin window under Transactional Keys > API-Key.
Go back to Deribit and copy “Client Secret” and paste it into the Parfin window under Transactional Keys > API-Secret.
5. Two-factor Authentication QR Code
If you are adding Transactional Keys you will need to reset (or add Two-factor Authentication) in order to retrieve the QR code.
Go to Deribit > My Account > Security > Two-Factor Authentication
If you don’t have 2FA enabled, click “Enable Two-Factor Authentication”, otherwise input your 2FA and click “Disable Two-Factor Authentication”, and then re-enable it.
When you are in the section Two-Factor Authentication setup page, copy the QR Code which should be similar to this: MJEVE653IQGIECNFTATTW4D6BVCFXNHO. Please remove any spaces or
Paste it in the Parfin window under “Two-factor Authentication QR Code”, and make sure to delete all spaces before and after.
6. Finishing Up
When all the desired fields are completed, at Parfin click the “Connect” button at the bottom of the Connect Counterparty Modal.
If any error is shown, check the keys you copied & pasted and if necessary repeat steps 3 to 5 above.
After successful setup and success message, a request will be sent to Parfin Super Admin to approve your counterparty connection. Your connection will be in Pending status and will only be displayed on Dashboard once approved.
7. Creating Whitelisted Withdrawal addresses in Deribit
Note: For extra security, we highly recommend deleting any other whitelisted addresses from your Deribit account and only leaving the Parfin ones.
Go to Deribit > My Account > Withdraw tab.
For whitelisting BTC or ETH addresses, toggle between Bitcoin and Ethereum on the top left of the platform.
Click Edit in the Address field and then the link “Create a new whitelist address”.
Go to Parfin > Settings > Wallets, and copy the respective address you wish to whitelist.
Go back to Deribit and paste this address into the Withdrawal Address field, and add a name to the whitelisted address.
Withdrawals to the selected address will be active after the number of days defined in the Withdrawal settings (min 0 or max 60 days).
8. OPTIONAL - Test Sending a Transaction
Go to the Parfin dashboard, click on “Create Transaction” and create a transaction to send money from your Deribit to your Parfin Internal Wallet.
Congratulations, your new connection to Deribit is completed!