Planbok V2 API

Tokens

Endpoint

List Supported Tokens

GET

https://api.planbok.io

/v2/tokens

Returns a list of tokens supported by the organization.

List Supported Tokens › query Parameters

page

integer

Default: 1

limit

integer

Default: 10

order

string · enum

Enum values:

asc

desc

Default: desc

List Supported Tokens › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

List Supported Tokens › Responses

200

List of tokens

success

boolean

status

integer

object

object[]

GET/v2/tokens

curl --request GET \
  --url https://api.planbok.io/v2/tokens \
  --header 'PLANBOK-X-API-KEY: <string>'

shell

Example Responses

{
  "success": true,
  "data": [
    {
      "id": "69a2f6c2a80a22691f80f893",
      "standard": "native",
      "blockchain": "NEAR-TESTNET",
      "name": "NEAR Testnet",
      "symbol": "NEAR",
      "decimals": 24,
      "organization": "69a1f47b0993b0d19f40e73c",
      "createdAt": "2026-02-28T14:08:02.937Z",
      "updatedAt": "2026-02-28T14:08:02.937Z"
    },
    {
      "id": "69a2f6c2a80a22691f80f887",
      "standard": "native",
      "blockchain": "BTC-TESTNET",
      "name": "Bitcoin Testnet",
      "symbol": "BTC",
      "decimals": 8,
      "organization": "69a1f47b0993b0d19f40e73c",
      "createdAt": "2026-02-28T14:08:02.915Z",
      "updatedAt": "2026-02-28T14:08:02.915Z"
    },
    {
      "id": "69a2f6c2a80a22691f80f87b",
      "standard": "native",
      "blockchain": "SOL-TESTNET",
      "name": "Solana Testnet",
      "symbol": "SOL",
      "decimals": 9,
      "organization": "69a1f47b0993b0d19f40e73c",
      "createdAt": "2026-02-28T14:08:02.889Z",
      "updatedAt": "2026-02-28T14:08:02.889Z"
    },
    {
      "id": "69a2f6c2a80a22691f80f86f",
      "standard": "native",
      "blockchain": "ETH-SEPOLIA",
      "name": "Sepolia ETH",
      "symbol": "ETH",
      "decimals": 18,
      "organization": "69a1f47b0993b0d19f40e73c",
      "createdAt": "2026-02-28T14:08:02.830Z",
      "updatedAt": "2026-02-28T14:08:02.830Z"
    }
  ],
  "pagination": {
    "total": 4,
    "page": 1,
    "pages": 1
  },
  "status": 200
}

json

application/json

Add Supported Token

POST

https://api.planbok.io

/v2/tokens

Adds a new token to the organization's supported tokens list.

Add Supported Token › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Add Supported Token › Request Body

blockchain

string · enum · required

The blockchain identifier.

Enum values:

ARB

ARB-SEPOLIA

AVAX-C

AVAX-C-FUJI

BASE

BASE-SEPOLIA

BSC

BSC-TESTNET

standard

string · enum · required

The token standard.

Enum values:

native

erc20

fungible

fungible-asset

cw20

psp22

nep141

symbol

string · required

decimals

integer · required

address

string

name

string

Add Supported Token › Responses

Token added successfully

success

boolean

status

integer

object

POST/v2/tokens

curl --request POST \
  --url https://api.planbok.io/v2/tokens \
  --header 'Content-Type: application/json' \
  --header 'PLANBOK-X-API-KEY: <string>' \
  --data '
{
  "blockchain": "ETH-SEPOLIA",
  "standard": "erc20",
  "address": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
  "name": "Nigerian Naira",
  "symbol": "NGN",
  "decimals": 18
}
'

shell

Example Request Body

{
  "blockchain": "ETH-SEPOLIA",
  "standard": "erc20",
  "address": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
  "name": "Nigerian Naira",
  "symbol": "NGN",
  "decimals": 18
}

json

application/json

Example Responses

{
  "success": true,
  "data": {
    "standard": "erc20",
    "blockchain": "ETH-SEPOLIA",
    "name": "Nigerian Naira",
    "address": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
    "symbol": "NGN",
    "decimals": 18,
    "organization": "69a1f47b0993b0d19f40e73c",
    "id": "69a36bb0cc41d43ac6956217",
    "createdAt": "2026-02-28T22:26:56.036Z",
    "updatedAt": "2026-02-28T22:26:56.036Z"
  },
  "status": 201
}

json

application/json

Get Token Metadata

GET

https://api.planbok.io

/v2/tokens/metadata

Returns metadata about supported chains and token standards.

Get Token Metadata › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Get Token Metadata › Responses

200

Metadata retrieved

success

boolean

status

integer

object

GET/v2/tokens/metadata

curl --request GET \
  --url https://api.planbok.io/v2/tokens/metadata \
  --header 'PLANBOK-X-API-KEY: <string>'

shell

Example Responses

{
  "success": true,
  "data": {
    "chains": {
      "ETH-SEPOLIA": {
        "name": "ETH Sepolia",
        "standards": [
          "native",
          "erc20"
        ]
      },
      "POL-AMOY": {
        "name": "POL Amoy",
        "standards": [
          "native",
          "erc20"
        ]
      },
      "BSC-TESTNET": {
        "name": "BSC Testnet",
        "standards": [
          "native",
          "erc20"
        ]
      },
      "LSK-SEPOLIA": {
        "name": "Lisk Sepolia",
        "standards": [
          "native",
          "erc20"
        ]
      },
      "@G-TESTNET": {
        "name": "Graphite Testnet",
        "standards": [
          "native",
          "erc20"
        ]
      },
      "BASE-SEPOLIA": {
        "name": "Base Sepolia",
        "standards": [
          "native",
          "erc20"
        ]
      },
      "CELO-SEPOLIA": {
        "name": "Celo Sepolia",
        "standards": [
          "native",
          "erc20"
        ]
      },
      "SCR-SEPOLIA": {
        "name": "Scroll Sepolia",
        "standards": [
          "native",
          "erc20"
        ]
      },
      "CRO-EVM-TESTNET": {
        "name": "Cronos EVM Testnet",
        "standards": [
          "native",
          "erc20"
        ]
      },
      "AVAX-C-FUJI": {
        "name": "Avalanche Fuji C-Chain",
        "standards": [
          "native",
          "erc20"
        ]
      },
      "ARB-SEPOLIA": {
        "name": "Arbitrum Sepolia",
        "standards": [
          "native",
          "erc20"
        ]
      },
      "OP-SEPOLIA": {
        "name": "Optimism Sepolia",
        "standards": [
          "native",
          "erc20"
        ]
      },
      "FTM-TESTNET": {
        "name": "Fantom Testnet",
        "standards": [
          "native",
          "erc20"
        ]
      },
      "SOL-TESTNET": {
        "name": "Solana Testnet",
        "standards": [
          "native",
          "fungible",
          "fungible-asset"
        ]
      },
      "SOL-DEVNET": {
        "name": "Solana Devnet",
        "standards": [
          "native",
          "fungible",
          "fungible-asset"
        ]
      },
      "BTC-TESTNET": {
        "name": "Bitcoin Testnet",
        "standards": [
          "native"
        ]
      },
      "NEAR-TESTNET": {
        "name": "NEAR Testnet",
        "standards": [
          "native",
          "nep141"
        ]
      }
    },
    "standards": {
      "native": {
        "requiresAddress": false,
        "requiresDecimals": true,
        "requiresName": true,
        "requiresSymbol": true
      },
      "erc20": {
        "requiresAddress": true,
        "requiresDecimals": true,
        "requiresName": true,
        "requiresSymbol": true
      },
      "fungible": {
        "requiresAddress": true,
        "requiresDecimals": true,
        "requiresName": true,
        "requiresSymbol": true
      },
      "fungible-asset": {
        "requiresAddress": true,
        "requiresDecimals": false,
        "requiresName": true,
        "requiresSymbol": true
      },
      "cw20": {
        "requiresAddress": true,
        "requiresDecimals": true,
        "requiresName": true,
        "requiresSymbol": true
      },
      "psp22": {
        "requiresAddress": true,
        "requiresDecimals": true,
        "requiresName": true,
        "requiresSymbol": true
      },
      "nep141": {
        "requiresAddress": true,
        "requiresDecimals": true,
        "requiresName": true,
        "requiresSymbol": true
      }
    }
  },
  "status": 200
}

json

application/json

Get Token Details

GET

https://api.planbok.io

/v2/tokens/{id}

Returns details for a specific token.

Get Token Details › path Parameters

id

string · required

Token ID

Get Token Details › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Get Token Details › Responses

200

Token details

success

boolean

status

integer

object

Remove Supported Token

DELETE

https://api.planbok.io

/v2/tokens/{id}

Removes a token from the organization's supported tokens list.

Remove Supported Token › path Parameters

id

string · required

Token ID

Remove Supported Token › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Remove Supported Token › Responses

Token removed successfully

No data returned

Wallets Signing

List Supported Tokens

GET

https://api.planbok.io

/v2/tokens

Returns a list of tokens supported by the organization.

List Supported Tokens › query Parameters

page

integer

Default: 1

limit

integer

Default: 10

order

string · enum

Enum values:

asc

desc

Default: desc

List Supported Tokens › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

List Supported Tokens › Responses

200

List of tokens

success

boolean

status

integer

object

object[]

Add Supported Token

POST

https://api.planbok.io

/v2/tokens

Adds a new token to the organization's supported tokens list.

Add Supported Token › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Add Supported Token › Request Body

blockchain

string · enum · required

The blockchain identifier.

Enum values:

ARB

ARB-SEPOLIA

AVAX-C

AVAX-C-FUJI

BASE

BASE-SEPOLIA

BSC

BSC-TESTNET

standard

string · enum · required

The token standard.

Enum values:

native

erc20

fungible

fungible-asset

cw20

psp22

nep141

symbol

string · required

decimals

integer · required

address

string

name

string

Add Supported Token › Responses

Token added successfully

success

boolean

status

integer

object

Get Token Details

GET

https://api.planbok.io

/v2/tokens/{id}

Returns details for a specific token.

Get Token Details › path Parameters

id

string · required

Token ID

Get Token Details › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Get Token Details › Responses

200

Token details

success

boolean

status

integer

object

Remove Supported Token

DELETE

https://api.planbok.io

/v2/tokens/{id}

Removes a token from the organization's supported tokens list.

Remove Supported Token › path Parameters

id

string · required

Token ID

Remove Supported Token › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Remove Supported Token › Responses

Token removed successfully

No data returned