Token Layer Action Guide

Use this guide for practical integration with POST /token-layer.

Decision Flow

New wallet with no user_wallets mapping: call action.type=register.
Registered wallet: call action.type=createToken.
If you get IDENTITY_NOT_REGISTERED, run register first, then retry your action.

Register (Web3, Single Step)

Use this action to bootstrap identity for wallets that are not registered yet. Requirements:

Authorization: Bearer 0x... (wallet address)
signature: EIP-712 signature for register action
nonce: timestamp in ms
action.message + action.signature
action.message must include a 13-digit timestamp in ms
message timestamp must match nonce and be inside expiresAfter

curl --request POST \
  --url https://api.tokenlayer.network/functions/v1/token-layer \
  --header 'Authorization: Bearer 0xafe140dbfe00606990d913c04efd318701c99d17' \
  --header 'Content-Type: application/json' \
  --data '{
    "action": {
      "type": "register",
      "method": "web3",
      "message": "TokenLayer register\naddress: 0xafe140dbfe00606990d913c04efd318701c99d17\ntimestamp: 1737600000000",
      "signature": "0x..."
    },
    "source": "Mainnet",
    "nonce": 1737600000000,
    "expiresAfter": 300000,
    "signatureChainId": "0x1",
    "signature": "0x..."
  }'

{
  "actionType": "register",
  "success": true,
  "name": "register",
  "userId": "b558937d-fd36-4e49-944e-691806190f46",
  "walletAddress": "0xafe140dbfe00606990d913c04efd318701c99d17",
  "method": "web3"
}

Create Token

Use this action after wallet registration. Requirements:

Authorization: Bearer 0x... for wallet-signed mode
signature: EIP-712 signature for createToken payload
nonce: timestamp in ms

curl --request POST \
  --url https://api.tokenlayer.network/functions/v1/token-layer \
  --header 'Authorization: Bearer 0xafe140dbfe00606990d913c04efd318701c99d17' \
  --header 'Content-Type: application/json' \
  --data '{
    "action": {
      "type": "createToken",
      "name": "My Cool Token",
      "symbol": "MCT",
      "description": "A new token",
      "image": "https://example.com/logo.png",
      "chainSlug": "base"
    },
    "source": "Mainnet",
    "nonce": 1737600001000,
    "expiresAfter": 300000,
    "signatureChainId": "0x1",
    "signature": "0x..."
  }'

{
  "actionType": "createToken",
  "name": "createToken",
  "success": true
}

Common Errors

IDENTITY_NOT_REGISTERED: wallet signature is valid but wallet has no user mapping.
REPLAY_DETECTED: same (wallet, nonce, actionHash) was already used.
ACTION_EXPIRED: nonce + expiresAfter is invalid.
INVALID_ACTION_SIGNATURE: EIP-712 signature does not match payload.

API Reference

For full schema and interactive testing, see:

POST /token-layer

About

Onboarding

Earn

Integrations

API Reference

Token Layer Action Guide

Token Layer Action Guide

Decision Flow

Register (Web3, Single Step)

Create Token

Common Errors

API Reference

​Token Layer Action Guide

​Decision Flow

​Register (Web3, Single Step)

​Create Token

​Common Errors

​API Reference

Token Layer Action Guide

Decision Flow

Register (Web3, Single Step)

Create Token

Common Errors

API Reference