TaskOn Performance-Based API Verification Guide

Overview

This task template is ideal for trading competitions, allowing you to sync points to TaskOn. For example, users with higher trading volume can earn more points, motivating them to strive for greater achievements.The system supports two types of user identifiers:

1.1 Supported ID Types

1. Social Media Account ID

   1. Twitter handle (e.g., taskonxyz)

   2. Discord ID (e.g., 1084460817220641111)

   3. Telegram ID (e.g., 6881505111)

   4. Email Address (e.g., [e-mail])

2. Blockchain Wallet Address

   1. Supported chains: EVM, Solana, Starknet, Sui, Tron, BTC, Aptos, Nibiru

Integration Guide

2.1 Quick Start

• Demo project: https://github.com/Taskon-xyz/taskon-verification-demo

• Features:

  • One-click Vercel deployment

  • Ready-to-use application template

  • Complete integration example

2.2 API Specifications

Endpoint

GET https://<domain>/<serverpath>?address=<identifier>

Response Format

{ "result": { "point": 100 // Indicates task completion result } }

Important Notes

• All API endpoints must be publicly accessible

• Optional bearer token support for TaskOn-exclusive access

• All identifiers are converted to lowercase for consistency

• Always return HTTP 200 status code

• Use point integer to indicate task completion result

2.3 Example Request

GET <https://your-app.vercel.app/api/task/verification?address=0xd5045deea369d64ab7efab41ad18b82eeabcdefg>

Task Configuration Steps

3.1. Slect API Task

• Go to the TaskOn dashboard and click on the "API Task" tab.

• Click on the "Performance-Based Task" button.

3.2 Click on the "Set API URL" button.

3. Fill the api url

• URL: If you use this repo and vercel, it shoud be like this: https://xxx.vercel.app/api/task/verification

• [Optional] Bearer Token: Enable this to restrict API access to TaskOn only.

4. Verify Configuration & Confirm Your Settings

• Purpose: Ensure everything works smoothly.

• Provide: User ID that has points reward

After verification, it's all done.

How it works

From the user side, users need to manually claim points for the first task completion. Afterward, points can be updated automatically via API when users click the refresh button.

You can also manually upload points to update user data as needed.