Skip to main content

​
What are OKX tasks?

OKX tasks let users connect their OKX account to Claimr through an API key they create on OKX. Claimr then reads the account to verify activity and reward it. There are 5 OKX task types:
  • Connect OKX Account: Link a user’s OKX account with an API key.
  • OKX KYC: Verify that the connected account has completed identity verification.
  • OKX Trading Volume: Track the spot volume the user traded over a time window.
  • OKX Hold Token: Check that the user holds at least a set amount of a token.
  • OKX Deposit: Check that the user deposited at least a set amount of a token onto OKX.
The user connects the account once, with the Connect OKX Account task. Every other OKX task reuses that key, and asks for one only if none is stored yet.

​
Connect OKX account

  1. Go to your quest and click + Create new task.
  2. Under the Category section, select Onchain Actions.
  3. In the Groups list, choose OKX.
  4. Select Connect OKX Account from the list of task types.
  5. Click Continue to proceed to task settings.
  • Completion points: Set the number of points awarded when the user completes the task.
  • Points multiplier (%): Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
Users create an API key in their OKX account settings and enter it in the task (API key, secret and passphrase). Only read-only keys are accepted. If a key can trade or withdraw, the task refuses it and asks the user for a read-only key, so Claimr never stores a key that could move funds. Once the key works, Claimr stores it for the user’s other OKX tasks and marks the task as complete.

​
OKX KYC

  1. Go to your quest and click + Create new task.
  2. Under the Category section, select Onchain Actions.
  3. In the Groups list, choose OKX.
  4. Select OKX KYC from the list of task types.
  5. Click Continue to proceed to task settings.
  • Completion points: Set the number of points awarded when the user completes the task.
  • Points multiplier (%): Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
This task confirms that the connected OKX account has completed identity verification. The task passes once OKX reports KYC level 1 or higher.
Claimr doesn’t receive KYC data, only whether the account is verified.

​
OKX trading volume

  1. Go to your quest and click + Create new task.
  2. Under the Category section, select Onchain Actions.
  3. In the Groups list, choose OKX.
  4. Select OKX Trading Volume from the list of task types.
  5. Click Continue to proceed to task settings.
  • Completion points: Set the number of points awarded when the user completes the task.
  • Points multiplier (%): Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
  • Symbol: The spot trading pair, written the way OKX writes it (for example, BTC-USDT). To count several pairs, separate them with commas. Their volumes are added up, so pick pairs that share a quote currency.
  • Volume: The volume the user must reach, in the pair’s quote currency.
  • Maker volume only? (optional): Count only trades where the user provided liquidity as a maker.
  • Time, h (optional): Count only trades from the last number of hours.
  • Start at and End at (optional): Count only trades between these dates. With no time window set, the task counts the last 90 days, the most OKX keeps.
  • Is progressive reward? (optional): Scale the reward with how many times the user reaches the volume. Example: if 10 USDT of volume earns 2 points, 20 USDT earns 4 points.
  • Max progressive amount (optional): The highest volume used to calculate progressive rewards. Example: with a limit of 100,000 USDT, a user who trades 1,000,000 USDT still receives the reward for 100,000 USDT.
  • Is continuous (optional): Keep the task open after completion, so users keep earning as their volume grows.

​
OKX hold token

  1. Go to your quest and click + Create new task.
  2. Under the Category section, select Onchain Actions.
  3. In the Groups list, choose OKX.
  4. Select OKX Hold Token from the list of task types.
  5. Click Continue to proceed to task settings.
  • Completion points: Set the number of points awarded when the user completes the task.
  • Points multiplier (%): Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
  • Token: The token ticker, for example USDT.
  • Amount: The amount of the token the user must hold.
Claimr checks the balance when the user claims the task. The trading account and the funding account both count. Borrowed funds don’t count.

​
OKX deposit

  1. Go to your quest and click + Create new task.
  2. Under the Category section, select Onchain Actions.
  3. In the Groups list, choose OKX.
  4. Select OKX Deposit from the list of task types.
  5. Click Continue to proceed to task settings.
  • Completion points: Set the number of points awarded when the user completes the task.
  • Points multiplier (%): Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
  • Token: The token ticker, for example USDT.
  • Amount: The amount the user must deposit, in the token.
  • Network (optional): Count only deposits that arrived on this network. Use the part of OKX’s chain name after the token, for example TRC20 for USDT-TRC20. Leave it empty to count any network.
  • Time, h, Start at and End at (optional): Count only deposits made in this window.
Only deposits the exchange has credited to the account count. Deposits older than 89 days are never counted, because some exchanges keep no older deposit history.