Planbok V2 API

Transactions

Endpoint

Transfer Tokens

POST

https://api.planbok.io

/v2/organization/transactions/transfer

Initiates a direct token transfer from an organizational wallet.

Transfer Tokens › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Transfer Tokens › Request Body

idempotencyKey

string · uuid · required

A unique UUID v4 to ensure request idempotency.

walletId

string · required

Wallet ID

destinationAddress

string · required

Destination address

tokenId

string · required

Token ID

amounts

string[] · required

List of amounts to transfer

feeLevel

string · enum

Fee level

Enum values:

low

medium

high

Default: medium

refId

string

Reference ID (reference or description used to identify the transaction.)

encryptedOrganizationSecret

string

Required only for organizations operating in trustless MPC mode. Must be a base64 encoded ciphertext.

Transfer Tokens › Responses

200

Transaction broadcast successfully

success

boolean

status

integer

message

string

object

POST/v2/organization/transactions/transfer

curl --request POST \
  --url https://api.planbok.io/v2/organization/transactions/transfer \
  --header 'Content-Type: application/json' \
  --header 'PLANBOK-X-API-KEY: <string>' \
  --data '
{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174020",
  "walletId": "69a2f6c2a80a22691f80f868",
  "destinationAddress": "0xa0780f1403419ad992cA0420AAb81a4562e179dd",
  "tokenId": "69a2f6c2a80a22691f80f86f",
  "amounts": [
    "0.0005"
  ],
  "feeLevel": "low",
  "encryptedOrganizationSecret": ""
}
'

shell

Example Request Body

{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174020",
  "walletId": "69a2f6c2a80a22691f80f868",
  "destinationAddress": "0xa0780f1403419ad992cA0420AAb81a4562e179dd",
  "tokenId": "69a2f6c2a80a22691f80f86f",
  "amounts": [
    "0.0005"
  ],
  "feeLevel": "low",
  "encryptedOrganizationSecret": ""
}

json

application/json

Example Responses

{
  "success": true,
  "data": {
    "id": "70213f5333104e16a8b2bb27be16180e",
    "transactionHash": "0xff0ca78ffa748c1b3636aacdde49e7066505e22b8833c613655788ac23cc2c56",
    "signedTransaction": "0x02f87283aa36a780830f4240830f425482520894a0780f1403419ad992ca0420aab81a4562e179dd8701c6bf5263400080c080a0b3d8befdeb8d6aac61f43b4ad18dacacbd4c2c2942b3c4e19ed214943e2332f2a034ddfcc3d50b7604c9c13c621b72f384946996e4ecd097f306284211f335dbe9",
    "signature": {
      "r": "b3d8befdeb8d6aac61f43b4ad18dacacbd4c2c2942b3c4e19ed214943e2332f2",
      "s": "34ddfcc3d50b7604c9c13c621b72f384946996e4ecd097f306284211f335dbe9",
      "v": 0,
      "signature": "b3d8befdeb8d6aac61f43b4ad18dacacbd4c2c2942b3c4e19ed214943e2332f234ddfcc3d50b7604c9c13c621b72f384946996e4ecd097f306284211f335dbe9"
    },
    "status": "broadcast"
  },
  "message": "Transaction broadcast successfully",
  "status": 200
}

json

application/json

Contract Execution

POST

https://api.planbok.io

/v2/organization/transactions/contract-execution

Executes a smart contract interaction from an organizational wallet.

Contract Execution › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Contract Execution › Request Body

idempotencyKey

string · uuid · required

A unique UUID v4 to ensure request idempotency.

walletId

string · required

Wallet ID

contractAddress

string · required

Contract Address

abiFunctionSignature

string · required

ABI Function Signature e.g. transfer(address,uint256). For Solana and Near chain types use the operation name and operation parameter names like transfer(to,amount), ft_transfer(receiver_id,amount)

abiParameters

string[] · required

Array of ABI/operation parameters in order of the function signature.

amount

string

The amount of native token in decimals, that will be sent to the contract abi execution. Optional field for payable api only, if not provided, no native token will be sent.

feeLevel

string · enum

Fee level

Enum values:

low

medium

high

Default: medium

refId

string

Reference ID (reference or description used to identify the transaction.)

encryptedOrganizationSecret

string

Required only for organizations operating in trustless MPC mode. Must be a base64 encoded ciphertext.

Contract Execution › Responses

200

Contract execution transaction broadcast successfully

success

boolean

status

integer

message

string

object

POST/v2/organization/transactions/contract-execution

curl --request POST \
  --url https://api.planbok.io/v2/organization/transactions/contract-execution \
  --header 'Content-Type: application/json' \
  --header 'PLANBOK-X-API-KEY: <string>' \
  --data '
{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174021",
  "walletId": "69a2f6c2a80a22691f80f868",
  "contractAddress": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
  "abiFunctionSignature": "approve(address,uint256)",
  "abiParameters": [
    "0xa0780f1403419ad992cA0420AAb81a4562e179dd",
    "100000000000000000000"
  ],
  "amount": "",
  "feeLevel": "low",
  "refId": "Approval for NGNT",
  "encryptedOrganizationSecret": ""
}
'

shell

Example Request Body

{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174021",
  "walletId": "69a2f6c2a80a22691f80f868",
  "contractAddress": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
  "abiFunctionSignature": "approve(address,uint256)",
  "abiParameters": [
    "0xa0780f1403419ad992cA0420AAb81a4562e179dd",
    "100000000000000000000"
  ],
  "amount": "",
  "feeLevel": "low",
  "refId": "Approval for NGNT",
  "encryptedOrganizationSecret": ""
}

json

application/json

Example Responses

{
  "success": true,
  "data": {
    "id": "faf26bfbeea34c1abaf06597d39c5219",
    "transactionHash": "0x307567218c1a4766279d10582a7501d29f2065c279912f9c77fca94540b52538",
    "signedTransaction": "0x02f8b083aa36a702830b71b0830b71bf826aba9421ef7290c016556eb7dc62e889f20a9cc89dfe4280b844095ea7b3000000000000000000000000a0780f1403419ad992ca0420aab81a4562e179dd0000000000000000000000000000000000000000000000056bc75e2d63100000c080a00d7134dbe92d010d5dd63732f8a2a603cc6636d011a3ea192e1461c43950dad7a04f7e7c3362a644738cb37d5091f6498ec7a2e3bf396a61ec6dea1d3e644d6196",
    "signature": {
      "r": "0d7134dbe92d010d5dd63732f8a2a603cc6636d011a3ea192e1461c43950dad7",
      "s": "4f7e7c3362a644738cb37d5091f6498ec7a2e3bf396a61ec6dea1d3e644d6196",
      "v": 0,
      "signature": "0d7134dbe92d010d5dd63732f8a2a603cc6636d011a3ea192e1461c43950dad74f7e7c3362a644738cb37d5091f6498ec7a2e3bf396a61ec6dea1d3e644d6196"
    },
    "status": "broadcast"
  },
  "message": "Contract execution transaction broadcast successfully",
  "status": 200
}

json

application/json

Cancel Transaction

POST

https://api.planbok.io

/v2/organization/transactions/{id}/cancel

Attempts to cancel a pending transaction.

Cancel Transaction › path Parameters

id

string · required

Transaction ID

Cancel Transaction › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Cancel Transaction › Request Body

idempotencyKey

string · uuid · required

A unique UUID v4 to ensure request idempotency.

encryptedOrganizationSecret

string

Required only for organizations operating in trustless MPC mode. Must be a base64 encoded ciphertext.

Cancel Transaction › Responses

200

Transaction cancellation processed

success

boolean

status

integer

message

string

object

POST/v2/organization/transactions/{id}/cancel

curl --request POST \
  --url https://api.planbok.io/v2/organization/transactions/:id/cancel \
  --header 'Content-Type: application/json' \
  --header 'PLANBOK-X-API-KEY: <string>' \
  --data '
{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174022",
  "encryptedOrganizationSecret": ""
}
'

shell

Example Request Body

{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174022",
  "encryptedOrganizationSecret": ""
}

json

application/json

Example Responses

{
  "success": true,
  "data": {
    "id": "bc5738bce4064595894314c837c9d48c",
    "transactionHash": "0x0b4207ac4ea936aee8a918b299356e0c1a23efec23bf785ea6bb19d7d36f0f70",
    "signedTransaction": "0x02f86b83aa36a780832255108322553d825208940fec65f498d3df36c9c4242b539a5ce0c3ff35088080c080a0b13092cdb4eadb54a8ab03ec52c953052eebeba4cd2cd936437bffef7f26d602a028b2bb42b01b3dc6c25e4107235172afa405e1952311f8f169376448956bbb1c",
    "signature": {
      "r": "b13092cdb4eadb54a8ab03ec52c953052eebeba4cd2cd936437bffef7f26d602",
      "s": "28b2bb42b01b3dc6c25e4107235172afa405e1952311f8f169376448956bbb1c",
      "v": 0,
      "signature": "b13092cdb4eadb54a8ab03ec52c953052eebeba4cd2cd936437bffef7f26d60228b2bb42b01b3dc6c25e4107235172afa405e1952311f8f169376448956bbb1c"
    }
  },
  "message": "Transaction cancellation processed",
  "status": 200
}

json

application/json

Accelerate Transaction

POST

https://api.planbok.io

/v2/organization/transactions/{id}/accelerate

Attempts to accelerate a pending transaction by increasing fees.

Accelerate Transaction › path Parameters

id

string · required

Transaction ID

Accelerate Transaction › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Accelerate Transaction › Request Body

idempotencyKey

string · uuid · required

A unique UUID v4 to ensure request idempotency.

encryptedOrganizationSecret

string

Required only for organizations operating in trustless MPC mode. Must be a base64 encoded ciphertext.

Accelerate Transaction › Responses

200

Transaction acceleration processed

success

boolean

status

integer

message

string

object

POST/v2/organization/transactions/{id}/accelerate

curl --request POST \
  --url https://api.planbok.io/v2/organization/transactions/:id/accelerate \
  --header 'Content-Type: application/json' \
  --header 'PLANBOK-X-API-KEY: <string>' \
  --data '
{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174023",
  "encryptedOrganizationSecret": ""
}
'

shell

Example Request Body

{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174023",
  "encryptedOrganizationSecret": ""
}

json

application/json

Example Responses

{
  "success": true,
  "data": {
    "id": "bc4e3d930b66445ca995e0fd1141a724",
    "transactionHash": "0x4a68ad49075097c8d470bba046417d83d839a090a2488ccc8c2ca681326036da",
    "signedTransaction": "0x02f8b083aa36a780832255108322553d82b89e9421ef7290c016556eb7dc62e889f20a9cc89dfe4280b844095ea7b3000000000000000000000000a0780f1403419ad992ca0420aab81a4562e179dd0000000000000000000000000000000000000000000000056bc75e2d63100000c080a05351d47c59c46c18f5170bb1c8b21fce1e60a617773c37abaef801e2010b9c74a05b978951e6278a427ca713fe9b7da7f439b69e05a299c93f51f54ab39e54e96c",
    "signature": {
      "r": "5351d47c59c46c18f5170bb1c8b21fce1e60a617773c37abaef801e2010b9c74",
      "s": "5b978951e6278a427ca713fe9b7da7f439b69e05a299c93f51f54ab39e54e96c",
      "v": 0,
      "signature": "5351d47c59c46c18f5170bb1c8b21fce1e60a617773c37abaef801e2010b9c745b978951e6278a427ca713fe9b7da7f439b69e05a299c93f51f54ab39e54e96c"
    }
  },
  "message": "Transaction acceleration processed",
  "status": 200
}

json

application/json

List Transaction History

GET

https://api.planbok.io

/v2/transactions

Returns a history of transactions.

List Transaction History › query Parameters

page

integer

Default: 1

limit

integer

Default: 10

order

string · enum

Enum values:

asc

desc

Default: desc

blockchain

string · enum

The blockchain identifier.

Enum values:

ARB

ARB-SEPOLIA

AVAX-C

AVAX-C-FUJI

BASE

BASE-SEPOLIA

BSC

BSC-TESTNET

controller

string · enum

Enum values:

organization

customer

destinationAddress

string

operation

string · enum

Enum values:

transfer

contract-execution

accelerate

cancel

sign

status

string · enum

Enum values:

pending

signed

broadcasted

confirmed

failed

cancelled

walletIds

string

Wallet IDs to filter transactions by. Separate multiple wallet IDs with commas.

txHash

string

Transaction hash to filter transactions by.

refId

string

Reference ID to filter transactions by.

contractAddress

string

Contract address to filter transactions by.

search

string

Search by wallet name, address or ID, token ID, or transaction hash.

List Transaction History › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

List Transaction History › Responses

200

List of transactions

success

boolean

status

integer

object

message

string

object[]

GET/v2/transactions

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

shell

Example Responses

{
  "success": true,
  "data": [
    {
      "id": "69a4a053183fc48e02f74c75",
      "txHash": "0x4a68ad49075097c8d470bba046417d83d839a090a2488ccc8c2ca681326036da",
      "txExplorerUrl": "https://sepolia.etherscan.io/tx/0x4a68ad49075097c8d470bba046417d83d839a090a2488ccc8c2ca681326036da",
      "blockchain": "ETH-SEPOLIA",
      "chainType": "evm",
      "controller": "organization",
      "status": "confirmed",
      "operation": "accelerate",
      "wallet": {
        "id": "69a43b8c1775de36fc80dd7e",
        "address": "0x0fec65f498d3df36c9c4242b539a5ce0c3ff3508",
        "blockchain": "ETH-SEPOLIA",
        "controller": "organization",
        "name": "nerdjango@gmail.com",
        "refId": "1fbef7ba-95e4-4fe4-a951-03db4989c8d4"
      },
      "signature": {
        "r": "5351d47c59c46c18f5170bb1c8b21fce1e60a617773c37abaef801e2010b9c74",
        "s": "5b978951e6278a427ca713fe9b7da7f439b69e05a299c93f51f54ab39e54e96c",
        "v": 0,
        "signature": "5351d47c59c46c18f5170bb1c8b21fce1e60a617773c37abaef801e2010b9c745b978951e6278a427ca713fe9b7da7f439b69e05a299c93f51f54ab39e54e96c"
      },
      "metadata": {
        "transactionData": "{\"to\":\"0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42\",\"value\":\"0\",\"data\":\"0x095ea7b3000000000000000000000000a0780f1403419ad992ca0420aab81a4562e179dd0000000000000000000000000000000000000000000000056bc75e2d63100000\",\"nonce\":1,\"feeLevel\":\"higher\"}",
        "nonce": 1,
        "amount": "0.0",
        "tokenSymbol": "ETH",
        "destinationAddress": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
        "blockHash": "0x602d50cf85c3ac76088c973ac0d5932c6a8badd4d0169a4be8d5466f29f76393",
        "blockHeight": "10363840",
        "effectiveGasPrice": "2250010",
        "gasUsed": "46878",
        "networkFee": "105475968780"
      },
      "createdAt": "2026-03-01T20:23:47.692Z",
      "updatedAt": "2026-03-01T20:24:28.713Z"
    },
    {
      "id": "69a4a04d183fc48e02f74c64",
      "txHash": "0xe966b8768e1f66aa1d7e4b0648099d0204715595ad4bb3771c5737c1f70f25d0",
      "txExplorerUrl": "https://sepolia.etherscan.io/tx/0xe966b8768e1f66aa1d7e4b0648099d0204715595ad4bb3771c5737c1f70f25d0",
      "blockchain": "ETH-SEPOLIA",
      "chainType": "evm",
      "controller": "organization",
      "status": "broadcast",
      "operation": "contract-execution",
      "refId": "",
      "wallet": {
        "id": "69a43b8c1775de36fc80dd7e",
        "address": "0x0fec65f498d3df36c9c4242b539a5ce0c3ff3508",
        "blockchain": "ETH-SEPOLIA",
        "controller": "organization",
        "name": "nerdjango@gmail.com",
        "refId": "1fbef7ba-95e4-4fe4-a951-03db4989c8d4"
      },
      "signature": {
        "r": "107303aebf3d8f5edef9e9ade760f2c7afc8583081366d278b7b547c0c3cd2f7",
        "s": "02f482e9fe2947bda2731cad3261233b3379f2f2b09fe6cc4d8d0ed853481090",
        "v": 1,
        "signature": "107303aebf3d8f5edef9e9ade760f2c7afc8583081366d278b7b547c0c3cd2f702f482e9fe2947bda2731cad3261233b3379f2f2b09fe6cc4d8d0ed853481090"
      },
      "metadata": {
        "transactionData": "{\"to\":\"0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42\",\"value\":\"0\",\"data\":\"0x095ea7b3000000000000000000000000a0780f1403419ad992ca0420aab81a4562e179dd0000000000000000000000000000000000000000000000056bc75e2d63100000\",\"feeLevel\":\"low\"}",
        "amount": "0.0",
        "tokenSymbol": "ETH",
        "destinationAddress": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
        "nonce": 1,
        "acceleratedBy": "0x4a68ad49075097c8d470bba046417d83d839a090a2488ccc8c2ca681326036da"
      },
      "createdAt": "2026-03-01T20:23:41.169Z",
      "updatedAt": "2026-03-01T20:23:49.556Z"
    },
    {
      "id": "69a491df183fc48e02f74bf6",
      "txHash": "0x0b4207ac4ea936aee8a918b299356e0c1a23efec23bf785ea6bb19d7d36f0f70",
      "txExplorerUrl": "https://sepolia.etherscan.io/tx/0x0b4207ac4ea936aee8a918b299356e0c1a23efec23bf785ea6bb19d7d36f0f70",
      "blockchain": "ETH-SEPOLIA",
      "chainType": "evm",
      "controller": "organization",
      "status": "confirmed",
      "operation": "cancel",
      "wallet": {
        "id": "69a43b8c1775de36fc80dd7e",
        "address": "0x0fec65f498d3df36c9c4242b539a5ce0c3ff3508",
        "blockchain": "ETH-SEPOLIA",
        "controller": "organization",
        "name": "nerdjango@gmail.com",
        "refId": "1fbef7ba-95e4-4fe4-a951-03db4989c8d4"
      },
      "signature": {
        "r": "b13092cdb4eadb54a8ab03ec52c953052eebeba4cd2cd936437bffef7f26d602",
        "s": "28b2bb42b01b3dc6c25e4107235172afa405e1952311f8f169376448956bbb1c",
        "v": 0,
        "signature": "b13092cdb4eadb54a8ab03ec52c953052eebeba4cd2cd936437bffef7f26d60228b2bb42b01b3dc6c25e4107235172afa405e1952311f8f169376448956bbb1c"
      },
      "metadata": {
        "transactionData": "{\"to\":\"0x0fec65f498d3df36c9c4242b539a5ce0c3ff3508\",\"value\":\"0\",\"data\":\"0x\",\"nonce\":0,\"feeLevel\":\"higher\"}",
        "nonce": 0,
        "amount": "0.0",
        "tokenSymbol": "ETH",
        "destinationAddress": "0x0fec65f498d3df36c9c4242b539a5ce0c3ff3508",
        "blockHash": "0x1dd17b1c780d91d4fc09715c6d9e3d347b714f28c36a5780a02d1374ab97fd60",
        "blockHeight": "10363543",
        "effectiveGasPrice": "2250010",
        "gasUsed": "21000",
        "networkFee": "47250210000"
      },
      "createdAt": "2026-03-01T19:22:07.545Z",
      "updatedAt": "2026-03-01T19:22:32.855Z"
    },
    {
      "id": "69a491d2183fc48e02f74ba5",
      "txHash": "0x408e16ad895c8660b43f379f8d86b25b6d57f97221022f912f9380654434da4d",
      "txExplorerUrl": "https://sepolia.etherscan.io/tx/0x408e16ad895c8660b43f379f8d86b25b6d57f97221022f912f9380654434da4d",
      "blockchain": "ETH-SEPOLIA",
      "chainType": "evm",
      "controller": "organization",
      "status": "cancelled",
      "operation": "contract-execution",
      "refId": "",
      "wallet": {
        "id": "69a43b8c1775de36fc80dd7e",
        "address": "0x0fec65f498d3df36c9c4242b539a5ce0c3ff3508",
        "blockchain": "ETH-SEPOLIA",
        "controller": "organization",
        "name": "nerdjango@gmail.com",
        "refId": "1fbef7ba-95e4-4fe4-a951-03db4989c8d4"
      },
      "signature": {
        "r": "985ac46ae3037f0c4cdbfa42b40b31d636d91309eb2f2845fe49e60c9925fbce",
        "s": "463214fe3eabdca93351ad33e04b0675f80fe9df8026ec9c518e3b15a614bb76",
        "v": 1,
        "signature": "985ac46ae3037f0c4cdbfa42b40b31d636d91309eb2f2845fe49e60c9925fbce463214fe3eabdca93351ad33e04b0675f80fe9df8026ec9c518e3b15a614bb76"
      },
      "metadata": {
        "transactionData": "{\"to\":\"0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42\",\"value\":\"0\",\"data\":\"0x095ea7b3000000000000000000000000a0780f1403419ad992ca0420aab81a4562e179dd0000000000000000000000000000000000000000000000056bc75e2d63100000\",\"feeLevel\":\"low\"}",
        "amount": "0.0",
        "tokenSymbol": "ETH",
        "destinationAddress": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
        "nonce": 0,
        "cancelledBy": "0x0b4207ac4ea936aee8a918b299356e0c1a23efec23bf785ea6bb19d7d36f0f70"
      },
      "createdAt": "2026-03-01T19:21:54.897Z",
      "updatedAt": "2026-03-01T19:22:10.605Z"
    },
    {
      "id": "69a4914c183fc48e02f74b59",
      "blockchain": "ETH-SEPOLIA",
      "chainType": "evm",
      "controller": "organization",
      "status": "failed",
      "operation": "contract-execution",
      "refId": "",
      "wallet": {
        "id": "69a43b8c1775de36fc80dd7e",
        "address": "0x0fec65f498d3df36c9c4242b539a5ce0c3ff3508",
        "blockchain": "ETH-SEPOLIA",
        "controller": "organization",
        "name": "nerdjango@gmail.com",
        "refId": "1fbef7ba-95e4-4fe4-a951-03db4989c8d4"
      },
      "error": "Insufficient funds for transaction",
      "metadata": {
        "transactionData": "{\"to\":\"0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42\",\"value\":\"0\",\"data\":\"0x095ea7b3000000000000000000000000a0780f1403419ad992ca0420aab81a4562e179dd0000000000000000000000000000000000000000000000056bc75e2d63100000\",\"feeLevel\":\"low\"}",
        "amount": "0.0",
        "tokenSymbol": "ETH",
        "destinationAddress": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42"
      },
      "createdAt": "2026-03-01T19:19:40.818Z",
      "updatedAt": "2026-03-01T19:19:43.906Z"
    },
    {
      "id": "69a4860d183fc48e02f74ac6",
      "txHash": "0x307567218c1a4766279d10582a7501d29f2065c279912f9c77fca94540b52538",
      "txExplorerUrl": "https://sepolia.etherscan.io/tx/0x307567218c1a4766279d10582a7501d29f2065c279912f9c77fca94540b52538",
      "blockchain": "ETH-SEPOLIA",
      "chainType": "evm",
      "controller": "organization",
      "status": "confirmed",
      "operation": "contract-execution",
      "refId": "Approval for NGNT",
      "wallet": {
        "id": "69a2f6c2a80a22691f80f868",
        "address": "0xbba521dfce426f5b77096d440d7199c1503d1f9d",
        "blockchain": "ETH-SEPOLIA",
        "controller": "organization",
        "name": "ifeanyi",
        "refId": "user_0"
      },
      "signature": {
        "r": "0d7134dbe92d010d5dd63732f8a2a603cc6636d011a3ea192e1461c43950dad7",
        "s": "4f7e7c3362a644738cb37d5091f6498ec7a2e3bf396a61ec6dea1d3e644d6196",
        "v": 0,
        "signature": "0d7134dbe92d010d5dd63732f8a2a603cc6636d011a3ea192e1461c43950dad74f7e7c3362a644738cb37d5091f6498ec7a2e3bf396a61ec6dea1d3e644d6196"
      },
      "metadata": {
        "transactionData": "{\"to\":\"0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42\",\"value\":\"0\",\"data\":\"0x095ea7b3000000000000000000000000a0780f1403419ad992ca0420aab81a4562e179dd0000000000000000000000000000000000000000000000056bc75e2d63100000\",\"feeLevel\":\"low\"}",
        "amount": "0.0",
        "tokenSymbol": "ETH",
        "destinationAddress": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
        "nonce": 2,
        "blockHash": "0xbb164e165346485b14266f5f1edea75a0697bb291afccf8269fadce9c39e68e0",
        "blockHeight": "10363296",
        "effectiveGasPrice": "750010",
        "gasUsed": "26978",
        "networkFee": "20233769780"
      },
      "createdAt": "2026-03-01T18:31:41.395Z",
      "updatedAt": "2026-03-01T18:32:37.865Z"
    },
    {
      "id": "69a485af183fc48e02f74ab8",
      "txHash": "0xl0cf805dfe7416ad0209e312d30e80d2d5f9d899852809e906df133c0df95f57",
      "txExplorerUrl": "https://sepolia.etherscan.io/tx/0xc0cf805dfe7416ad0209e312d30e80d2d5f9d899852809e906df133c0df95f57",
      "blockchain": "ETH-SEPOLIA",
      "chainType": "evm",
      "controller": "organization",
      "status": "confirmed",
      "operation": "contract-execution",
      "refId": "Approval for NGNT",
      "wallet": {
        "id": "69a2f6c2a80a22691f80f868",
        "address": "0xbba521dfce426f5b77096d440d7199c1503d1f9d",
        "blockchain": "ETH-SEPOLIA",
        "controller": "organization",
        "name": "ifeanyi",
        "refId": "user_0"
      },
      "signature": {
        "r": "e1e54f35f8a72fc0590f6e3f44c3271b5f185faf6ebe6cd31f8eee9e536b9f93",
        "s": "21473a4054e9e8abd35c281c4cc58a80a051cb09deae61db7401a878c9ccf941",
        "v": 1,
        "signature": "e1e54f35f8a72fc0590f6e3f44c3271b5f185faf6ebe6cd31f8eee9e536b9f9321473a4054e9e8abd35c281c4cc58a80a051cb09deae61db7401a878c9ccf941"
      },
      "metadata": {
        "transactionData": "{\"to\":\"0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42\",\"value\":\"0\",\"data\":\"0x095ea7b3000000000000000000000000a0780f1403419ad992ca0420aab81a4562e179dd0000000000000000000000000000000000000000000000056bc75e2d63100000\",\"feeLevel\":\"low\"}",
        "amount": "0.0",
        "tokenSymbol": "ETH",
        "destinationAddress": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
        "nonce": 1,
        "blockHash": "0x124344eedecb47bdeb1768addeab74d7b38975dc4032dff5e88136c4285a0bea",
        "blockHeight": "10363291",
        "effectiveGasPrice": "750010",
        "gasUsed": "46878",
        "networkFee": "35158968780"
      },
      "createdAt": "2026-03-01T18:30:07.530Z",
      "updatedAt": "2026-03-01T18:31:32.817Z"
    },
    {
      "id": "69a45c25183fc48e02f74aab",
      "txHash": "0xff0ca78ffa748c1b3636aacdde49e7066505e22b8833c613655788ac23cc2c56",
      "txExplorerUrl": "https://sepolia.etherscan.io/tx/0xff0ca78ffa748c1b3636aacdde49e7066505e22b8833c613655788ac23cc2c56",
      "blockchain": "ETH-SEPOLIA",
      "chainType": "evm",
      "controller": "organization",
      "status": "confirmed",
      "operation": "transfer",
      "refId": "",
      "wallet": {
        "id": "69a2f6c2a80a22691f80f868",
        "address": "0xbba521dfce426f5b77096d440d7199c1503d1f9d",
        "blockchain": "ETH-SEPOLIA",
        "controller": "organization",
        "name": "ifeanyi",
        "refId": "user_0"
      },
      "signature": {
        "r": "b3d8befdeb8d6aac61f43b4ad18dacacbd4c2c2942b3c4e19ed214943e2332f2",
        "s": "34ddfcc3d50b7604c9c13c621b72f384946996e4ecd097f306284211f335dbe9",
        "v": 0,
        "signature": "b3d8befdeb8d6aac61f43b4ad18dacacbd4c2c2942b3c4e19ed214943e2332f234ddfcc3d50b7604c9c13c621b72f384946996e4ecd097f306284211f335dbe9"
      },
      "metadata": {
        "transactionData": "{\"to\":\"0xa0780f1403419ad992cA0420AAb81a4562e179dd\",\"value\":\"500000000000000\"}",
        "amount": "0.0005",
        "tokenSymbol": "ETH",
        "destinationAddress": "0xa0780f1403419ad992cA0420AAb81a4562e179dd",
        "nonce": 0,
        "blockHash": "0x1662afbfe0074ac7fb647496380b9a89b103990b841366982e4a01f454327063",
        "blockHeight": "10362423",
        "effectiveGasPrice": "1000010",
        "gasUsed": "21000",
        "networkFee": "21000210000"
      },
      "createdAt": "2026-03-01T15:32:53.469Z",
      "updatedAt": "2026-03-01T15:33:05.134Z"
    },
    {
      "id": "69a4555e183fc48e02f74a9e",
      "blockchain": "NEAR-TESTNET",
      "chainType": "near",
      "controller": "organization",
      "status": "signed",
      "operation": "sign",
      "wallet": {
        "id": "69a2f6c2a80a22691f80f88d",
        "address": "01b1a7c4e325d574e24829fb2343c35fc9e9b139b2b2ec1d2ea345f6893c7f08",
        "blockchain": "NEAR-TESTNET",
        "controller": "organization",
        "name": "ifeanyi",
        "refId": "user_0"
      },
      "signature": {
        "signature": "992ab844e5eb1dfe95700eee464fbd15fd5481ea4b2db5274584c8bd1104382d7a5a19ebeaadf205e6c99a67d2e69826326525f01566bad663ae0abd8aed1107"
      },
      "metadata": {
        "unsignedDelegateAction": "ewogICJ0byI6ICIweC4uLiIsCiAgInZhbHVlIjogIjAiLAogICJkYXRhIjogIjB4Igp9",
        "delegateActionType": "near-delegate-action"
      },
      "createdAt": "2026-03-01T15:03:58.341Z",
      "updatedAt": "2026-03-01T15:03:58.522Z"
    },
    {
      "id": "69a4529f183fc48e02f74a95",
      "blockchain": "NEAR-TESTNET",
      "chainType": "near",
      "controller": "organization",
      "status": "signed",
      "operation": "sign",
      "wallet": {
        "id": "69a43b8c1775de36fc80dd72",
        "address": "dbff856230a108a159129e6ea13cb2c953dc350a40dda31e2967d779e34a8fe4",
        "blockchain": "NEAR-TESTNET",
        "controller": "organization",
        "name": "nerdjango@gmail.com",
        "refId": "1fbef7ba-95e4-4fe4-a951-03db4989c8d4"
      },
      "signature": {
        "signature": "53e691c414de047b70d21493dabae242868fcda92b3ecc1a71ad7825b1d3b8bf1b75fe97b77638124e7ebdfdeef98b88dd8f0a0931d6448f121b3546134ef807"
      },
      "metadata": {
        "unsignedDelegateAction": "ewogICJ0byI6ICIweC4uLiIsCiAgInZhbHVlIjogIjAiLAogICJkYXRhIjogIjB4Igp9",
        "delegateActionType": "near-delegate-action"
      },
      "createdAt": "2026-03-01T14:52:15.721Z",
      "updatedAt": "2026-03-01T14:52:15.805Z"
    }
  ],
  "message": "Transactions retrieved successfully",
  "pagination": {
    "total": 15,
    "page": 1,
    "pages": 2
  },
  "status": 200
}

json

application/json

Get Transaction Details

GET

https://api.planbok.io

/v2/transactions/{id}

Returns details for a specific transaction.

Get Transaction Details › path Parameters

id

string · required

Transaction ID

Get Transaction Details › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Get Transaction Details › Responses

200

Transaction details

success

boolean

status

integer

object

GET/v2/transactions/{id}

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

shell

Example Responses

{
  "success": true,
  "data": {
    "id": "69a4a053183fc48e02f74c75",
    "txHash": "0x4a68ad49075097c8d470bba046417d83d839a090a2488ccc8c2ca681326036da",
    "txExplorerUrl": "https://sepolia.etherscan.io/tx/0x4a68ad49075097c8d470bba046417d83d839a090a2488ccc8c2ca681326036da",
    "blockchain": "ETH-SEPOLIA",
    "chainType": "evm",
    "controller": "organization",
    "status": "confirmed",
    "operation": "accelerate",
    "wallet": {
      "id": "69a43b8c1775de36fc80dd7e",
      "address": "0x0fec65f498d3df36c9c4242b539a5ce0c3ff3508",
      "blockchain": "ETH-SEPOLIA",
      "controller": "organization",
      "name": "nerdjango@gmail.com",
      "refId": "1fbef7ba-95e4-4fe4-a951-03db4989c8d4"
    },
    "signature": {
      "r": "5351d47c59c46c18f5170bb1c8b21fce1e60a617773c37abaef801e2010b9c74",
      "s": "5b978951e6278a427ca713fe9b7da7f439b69e05a299c93f51f54ab39e54e96c",
      "v": 0,
      "signature": "5351d47c59c46c18f5170bb1c8b21fce1e60a617773c37abaef801e2010b9c745b978951e6278a427ca713fe9b7da7f439b69e05a299c93f51f54ab39e54e96c"
    },
    "metadata": {
      "transactionData": "{\"to\":\"0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42\",\"value\":\"0\",\"data\":\"0x095ea7b3000000000000000000000000a0780f1403419ad992ca0420aab81a4562e179dd0000000000000000000000000000000000000000000000056bc75e2d63100000\",\"nonce\":1,\"feeLevel\":\"higher\"}",
      "nonce": 1,
      "amount": "0.0",
      "tokenSymbol": "ETH",
      "destinationAddress": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
      "blockHash": "0x602d50cf85c3ac76088c973ac0d5932c6a8badd4d0169a4be8d5466f29f76393",
      "blockHeight": "10363840",
      "effectiveGasPrice": "2250010",
      "gasUsed": "46878",
      "networkFee": "105475968780"
    },
    "createdAt": "2026-03-01T20:23:47.692Z",
    "updatedAt": "2026-03-01T20:24:28.713Z"
  },
  "status": 200
}

json

application/json

Estimate Transfer Fee

POST

https://api.planbok.io

/v2/transactions/transfer/estimate-fee

Estimates fees for a token transfer.

Estimate Transfer Fee › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Estimate Transfer Fee › Request Body

walletId

string · required

Wallet ID

destinationAddress

string · required

Destination address

tokenId

string · required

Token ID

amounts

string[] · required

List of amounts to transfer

Estimate Transfer Fee › Responses

200

Fee estimation retrieved

success

boolean

status

integer

message

string

object

POST/v2/transactions/transfer/estimate-fee

curl --request POST \
  --url https://api.planbok.io/v2/transactions/transfer/estimate-fee \
  --header 'Content-Type: application/json' \
  --header 'PLANBOK-X-API-KEY: <string>' \
  --data '
{
  "walletId": "69a2f6c2a80a22691f80f868",
  "destinationAddress": "0xa0780f1403419ad992cA0420AAb81a4562e179dd",
  "tokenId": "69a2f6c2a80a22691f80f86f",
  "amounts": [
    "0.0001"
  ]
}
'

shell

Example Request Body

{
  "walletId": "69a2f6c2a80a22691f80f868",
  "destinationAddress": "0xa0780f1403419ad992cA0420AAb81a4562e179dd",
  "tokenId": "69a2f6c2a80a22691f80f86f",
  "amounts": [
    "0.0001"
  ]
}

json

application/json

Example Responses

{
  "success": true,
  "data": {
    "low": {
      "estimatedFee": "15750378000",
      "estimatedFeeFormatted": "0.000000015750378 ETH",
      "currency": "ETH",
      "details": {
        "gasLimit": "21000",
        "maxFeePerGas": "750018",
        "maxPriorityFeePerGas": "750000",
        "maxFeePerGasGwei": "0.000750018",
        "maxPriorityFeePerGasGwei": "0.00075"
      }
    },
    "medium": {
      "estimatedFee": "21000504000",
      "estimatedFeeFormatted": "0.000000021000504 ETH",
      "currency": "ETH",
      "details": {
        "gasLimit": "21000",
        "maxFeePerGas": "1000024",
        "maxPriorityFeePerGas": "1000000",
        "maxFeePerGasGwei": "0.001000024",
        "maxPriorityFeePerGasGwei": "0.001"
      }
    },
    "high": {
      "estimatedFee": "31500756000",
      "estimatedFeeFormatted": "0.000000031500756 ETH",
      "currency": "ETH",
      "details": {
        "gasLimit": "21000",
        "maxFeePerGas": "1500036",
        "maxPriorityFeePerGas": "1500000",
        "maxFeePerGasGwei": "0.001500036",
        "maxPriorityFeePerGasGwei": "0.0015"
      }
    }
  },
  "message": "Fee estimates retrieved successfully",
  "status": 200
}

json

application/json

Estimate Contract Fee

POST

https://api.planbok.io

/v2/transactions/contract-execution/estimate-fee

Estimates fees for a hypothetical contract execution.

Estimate Contract Fee › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Estimate Contract Fee › Request Body

walletId

string · required

Wallet ID

contractAddress

string · required

Contract Address

abiFunctionSignature

string · required

ABI Function Signature e.g. transfer(address,uint256). For Solana and Near chain types use the operation name and operation parameter names like transfer(to,amount), ft_transfer(receiver_id,amount)

abiParameters

string[] · required

Array of ABI/operation parameters in order of the function signature.

amount

string

The amount of native token in decimals, that will be sent to the contract abi execution. Optional field for payable api only, if not provided, no native token will be sent.

Estimate Contract Fee › Responses

200

Fee estimation retrieved

success

boolean

status

integer

message

string

object

POST/v2/transactions/contract-execution/estimate-fee

curl --request POST \
  --url https://api.planbok.io/v2/transactions/contract-execution/estimate-fee \
  --header 'Content-Type: application/json' \
  --header 'PLANBOK-X-API-KEY: <string>' \
  --data '
{
  "walletId": "69a2f6c2a80a22691f80f868",
  "contractAddress": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
  "abiFunctionSignature": "approve(address,uint256)",
  "abiParameters": [
    "0xa0780f1403419ad992cA0420AAb81a4562e179dd",
    "100000000000000000000"
  ],
  "amount": ""
}
'

shell

Example Request Body

{
  "walletId": "69a2f6c2a80a22691f80f868",
  "contractAddress": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
  "abiFunctionSignature": "approve(address,uint256)",
  "abiParameters": [
    "0xa0780f1403419ad992cA0420AAb81a4562e179dd",
    "100000000000000000000"
  ],
  "amount": ""
}

json

application/json

Example Responses

{
  "success": true,
  "data": {
    "low": {
      "estimatedFee": "20491909830",
      "estimatedFeeFormatted": "0.00000002049190983 ETH",
      "currency": "ETH",
      "details": {
        "gasLimit": "27322",
        "maxFeePerGas": "750015",
        "maxPriorityFeePerGas": "750000",
        "maxFeePerGasGwei": "0.000750015",
        "maxPriorityFeePerGasGwei": "0.00075"
      }
    },
    "medium": {
      "estimatedFee": "27322546440",
      "estimatedFeeFormatted": "0.00000002732254644 ETH",
      "currency": "ETH",
      "details": {
        "gasLimit": "27322",
        "maxFeePerGas": "1000020",
        "maxPriorityFeePerGas": "1000000",
        "maxFeePerGasGwei": "0.00100002",
        "maxPriorityFeePerGasGwei": "0.001"
      }
    },
    "high": {
      "estimatedFee": "40983819660",
      "estimatedFeeFormatted": "0.00000004098381966 ETH",
      "currency": "ETH",
      "details": {
        "gasLimit": "27322",
        "maxFeePerGas": "1500030",
        "maxPriorityFeePerGas": "1500000",
        "maxFeePerGasGwei": "0.00150003",
        "maxPriorityFeePerGasGwei": "0.0015"
      }
    }
  },
  "message": "Contract execution fee estimates retrieved successfully",
  "status": 200
}

json

application/json

Call Contract View Function

POST

https://api.planbok.io

/v2/transactions/contract-view/call

Executes a read-only (view/pure) contract function call. No signing or transaction record is created. Returns the decoded result from the blockchain.

Call Contract View Function › Headers

PLANBOK-X-API-KEY

string · required

API key for authentication

Call Contract View Function › Request Body

walletId

string · required

Wallet ID providing the context (blockchain, address as sender)

contractAddress

string · required

Contract/Program Address

abiFunctionSignature

string · required

Function name/signature. EVM: "balanceOf(address) returns (uint256)", NEAR/Anchor: "ft_balance_of", Cosmos: "balance". IMPORTANT: EVM requires "returns (...)" to decode the result.

abiParameters

string[]

Arguments for the call. For JSON-based chains (NEAR, Cosmos, Solana), pass the JSON string as the first element of the array.

Call Contract View Function › Responses

200

Function result retrieved

success

boolean

status

integer

object

POST/v2/transactions/contract-view/call

curl --request POST \
  --url https://api.planbok.io/v2/transactions/contract-view/call \
  --header 'Content-Type: application/json' \
  --header 'PLANBOK-X-API-KEY: <string>' \
  --data '
{
  "walletId": "69a2f6c2a80a22691f80f868",
  "contractAddress": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
  "abiFunctionSignature": "balanceOf(address) returns (uint256)",
  "abiParameters": [
    "0xa0780f1403419ad992cA0420AAb81a4562e179dd"
  ]
}
'

shell

Example Request Body

{
  "walletId": "69a2f6c2a80a22691f80f868",
  "contractAddress": "0x21ef7290c016556eb7dc62E889F20A9Cc89DFe42",
  "abiFunctionSignature": "balanceOf(address) returns (uint256)",
  "abiParameters": [
    "0xa0780f1403419ad992cA0420AAb81a4562e179dd"
  ]
}

json

application/json

Example Responses

{
  "success": true,
  "data": {
    "result": "1000000000000000000"
  },
  "message": "Contract view function called successfully",
  "status": 200
}

json

application/json

Signing Customers