Rewards

Mint Point/ERC-20

Reward users with points for completing specific actions in your application. This endpoint is designed to incentivise user engagement by awarding points for various activities such as:

User registration
Task completion
Video watching
Comment posting
Other custom actions

The endpoint returns an unsigned transaction that needs to be signed using your application’s private key (stored securely in server environment variables). After signing, you can broadcast the transaction using either:

Execute Transaction endpoint for immediate submission
Execute Transaction and Wait endpoint if you need to wait for transaction confirmation

This reward system helps build user engagement and loyalty while maintaining transparency through blockchain-based point distribution.

POST

reward

point

curl --request POST \
  --url https://api.openformat.tech/v1/reward/point \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "chain": "arbitrum-sepolia",
  "action_id": "dragon_slayed",
  "receiver": "0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266",
  "app_id": "0x9716fb655f2a72b1fc1b4db02b8ad20b6747442a",
  "token_address": "0xd1f09c70f6f2838a3ab6209c1465af68594667ec",
  "amount": 123
}'

{
  "status": "success",
  "unsignedTransaction": {
    "to": "0x014b680bed2433b1861239cf812dbe660fe339f2",
    "data": "0x609512c90000000000000000000000009574e9ba92cb0966c9d2ff1a9ab9e11949b9b873000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb922660000000000000000000000000000000000000000000000000de0b6b3a7640000647261676f6e5f736c6179656400000000000000000000000000000000000000414354494f4e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000000",
    "maxPriorityFeePerGas": "30000000000",
    "maxFeePerGas": "30000000015",
    "gasLimit": "95935",
    "nonce": 2484,
    "chainId": 80001,
    "type": 2
  }
}

{
  "status": "success",
  "unsignedTransaction": {
    "to": "0x014b680bed2433b1861239cf812dbe660fe339f2",
    "data": "0x609512c90000000000000000000000009574e9ba92cb0966c9d2ff1a9ab9e11949b9b873000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb922660000000000000000000000000000000000000000000000000de0b6b3a7640000647261676f6e5f736c6179656400000000000000000000000000000000000000414354494f4e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000000",
    "maxPriorityFeePerGas": "30000000000",
    "maxFeePerGas": "30000000015",
    "gasLimit": "95935",
    "nonce": 2484,
    "chainId": 80001,
    "type": 2
  }
}

Authorizations

X-API-KEY

string

header

required

Body

application/json

Response

200

application/json

Rewards Points

The response is of type object.

Challenge verification Transfer ERC-20

curl --request POST \
  --url https://api.openformat.tech/v1/reward/point \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "chain": "arbitrum-sepolia",
  "action_id": "dragon_slayed",
  "receiver": "0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266",
  "app_id": "0x9716fb655f2a72b1fc1b4db02b8ad20b6747442a",
  "token_address": "0xd1f09c70f6f2838a3ab6209c1465af68594667ec",
  "amount": 123
}'

{
  "status": "success",
  "unsignedTransaction": {
    "to": "0x014b680bed2433b1861239cf812dbe660fe339f2",
    "data": "0x609512c90000000000000000000000009574e9ba92cb0966c9d2ff1a9ab9e11949b9b873000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb922660000000000000000000000000000000000000000000000000de0b6b3a7640000647261676f6e5f736c6179656400000000000000000000000000000000000000414354494f4e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000000",
    "maxPriorityFeePerGas": "30000000000",
    "maxFeePerGas": "30000000015",
    "gasLimit": "95935",
    "nonce": 2484,
    "chainId": 80001,
    "type": 2
  }
}

API Key

Rewards

Credit

Transactions

Profile

Leaderboard

Webhook

Webhook Secret

Mint Point/ERC-20

Authorizations

Body

Response