cURL

curl --request POST \
  --url https://api.openformat.tech/v1/reward/credit \
  --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,
  "mint": false
}
'

{
  "success": true,
  "unsignedTransaction": {
    "to": "0x3f0431f04c76623481d5a27056174d550cff5e55",
    "data": "0x609512c90000000000000000000000008102a11ecb4f81da915e1d21b2e525d0a67e83b3012dc3a010c7d01b50e0d17dc79e0b646865725f6a756d7000000000000000000000000000000000000000000000414354494f4e0000000000000000000000000000000000000000000000",
    "maxPriorityFeePerGas": "1020840008",
    "maxFeePerGas": "1035102698",
    "gas": "99572",
    "gasLimit": "99572",
    "nonce": 36,
    "chainId": 31337,
    "type": 2
  }
}

Rewards

Transfer ERC-20

Transfer ERC-20 tokens to users in your application. This endpoint (previously known as “Credit”) enables you to reward users with ERC-20 tokens for their actions or achievements. 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

Important Notes:

Default Behavior: By default, this endpoint transfers existing ERC-20 tokens from the transaction sender’s account to the receiver’s account through the Application contract specified in the app_id parameter.
Required Setup: Before using this endpoint, you must create an allowance for the Application contract to transfer the required amount of tokens. This can be done using the approve endpoint.
Minting Option: If you want to mint new tokens instead of transferring existing ones, set the optional parameter mint to true.

POST

reward

credit

cURL

curl --request POST \
  --url https://api.openformat.tech/v1/reward/credit \
  --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,
  "mint": false
}
'

{
  "success": true,
  "unsignedTransaction": {
    "to": "0x3f0431f04c76623481d5a27056174d550cff5e55",
    "data": "0x609512c90000000000000000000000008102a11ecb4f81da915e1d21b2e525d0a67e83b3012dc3a010c7d01b50e0d17dc79e0b646865725f6a756d7000000000000000000000000000000000000000000000414354494f4e0000000000000000000000000000000000000000000000",
    "maxPriorityFeePerGas": "1020840008",
    "maxFeePerGas": "1035102698",
    "gas": "99572",
    "gasLimit": "99572",
    "nonce": 36,
    "chainId": 31337,
    "type": 2
  }
}

{
  "success": true,
  "unsignedTransaction": {
    "to": "0x3f0431f04c76623481d5a27056174d550cff5e55",
    "data": "0x609512c90000000000000000000000008102a11ecb4f81da915e1d21b2e525d0a67e83b3012dc3a010c7d01b50e0d17dc79e0b646865725f6a756d7000000000000000000000000000000000000000000000414354494f4e0000000000000000000000000000000000000000000000",
    "maxPriorityFeePerGas": "1020840008",
    "maxFeePerGas": "1035102698",
    "gas": "99572",
    "gasLimit": "99572",
    "nonce": 36,
    "chainId": 31337,
    "type": 2
  }
}

Authorizations

X-API-KEY

string

header

required

Body

application/json

chain

string

required

Blockchain network to use

Required string length: 1 - 255

Example:

"arbitrum-sepolia"

action_id

string

required

Action Id

Required string length: 1 - 32

Example:

"dragon_slayed"

receiver

string

required

Ethereum addres of the receiver

Pattern: ^(0x)?[0-9a-fA-F]{40}$

Example:

"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266"

app_id

string

required

Ethereum address of the application

Pattern: ^(0x)?[0-9a-fA-F]{40}$

Example:

"0x9716fb655f2a72b1fc1b4db02b8ad20b6747442a"

token_address

string

required

Ethereum address of the Credit token

Pattern: ^(0x)?[0-9a-fA-F]{40}$

Example:

"0xd1f09c70f6f2838a3ab6209c1465af68594667ec"

amount

number

required

Amount of tokens to reward

Required range: x > 0

Example:

123

mint

boolean

default:false

Whether to mint the Credit tokens instead of doing a transfer

Example:

false

Response

Rewards Credit token

success

enum<boolean>

required

Success response

Available options:

true

Example:

true

unsignedTransaction

any | null

Unsigned transaction object for the user to sign

Mint Point/ERC-20 Reward Badge

Documentation Index

Authorizations

Body

Response