Introduction
FTX allows you to build your own External Referral Program! These offer a way for you to:
- Execute trades on behalf of users that give you permission to do so
- Share revenue from those trades; you are paid a fraction of the fees they generate
This article describes how the system works and how to set it up.
Create your program
Reach out to whitelabel@ftx.com and let us know:
1. What you want your program to be called (see e.g. "TradeX100" in the image below)
2. The login email of the FTX account you want to receive the revenue share payments
Collect keys
Partners who have integrated Single Sign-On can create a user’s API keys with their respective bearer token. These partners may call https://ftx.com/api/api_keys to create the API keys for their users within the External Referral Program.
Alternatively, you may also ask your users to go to https://ftx.com/external-program-api-keys to create the API keys for your program and give them to you. By default these will be Trading-enabled but not Withdrawal-enabled.
Verify keys are associated with your program
For each pair of keys you are given, query the ftx.com/api/api_key_status endpoint to verify that they are associated with your program. You should see a response like so:
{'enabled': True,
'externalReferralProgram': 'TradeX100',
'readOnly': False,
'requireWhitelistedIp': False,
'subaccountNickname': None,
'withdrawalEnabled': False}
If the keys you have are not associated with your program (if, for instance, you collected keys before creating your external program), you can submit an `externalReferralProgram` argument to the `POST api/orders` endpoint. Orders tagged with that parameter (whose value should be set to your program's name, case-sensitive) will be associated with your program, just as if they had been requested with keys associated with your program.
1642157927003POST/api/orders
{"clientId":"example_client_id”,
"size":0.141,
"market":"MKR-PERP",
"type":"limit",
"price":2125.0,
"side":"sell”,
”externalReferralProgram”:“YOURREFCODEGOESHERE”}
Trade and collect a fraction of fees
You will be paid 25-40% of all fees (according to the same scheme described here) generated by orders sent using keys associated with your program. The payments are daily and are reflected on the Referrals page.