Blockchain

GetChains returns a list of chains (enabled only by default, or all if all=true)

get

https://backend.pay.kiichain.iohttps://backend.pay.staging.kiichain.io

/blockchain/v1/chains

Use GetChainByID instead when only one chain's details are needed

Query parameters

allbooleanOptional

all indicates whether to return all chains including disabled ones If false or omitted, only enabled chains are returned

Responses

200

A successful response.

application/json

default

An unexpected error response. details[0] is always an AppError, see #/components/schemas/AppError

application/json

get/blockchain/v1/chains

HTTPcURLJavaScriptPython

GET /blockchain/v1/chains HTTP/1.1
Host: backend.pay.kiichain.io
Accept: */*

{
  "chains": [
    {
      "chainId": "text",
      "confirmationDepth": 1,
      "contracts": {
        "ANY_ADDITIONAL_PROPERTY": {
          "address": "text",
          "version": "text"
        }
      },
      "enabled": true,
      "feeAddress": "text",
      "feeBps": 1,
      "id": 1,
      "logo": "text",
      "name": "text",
      "testnet": true,
      "type": "text"
    }
  ]
}

GetTokensByChainIDs returns tokens for a specific set of chains (enabled only by default, or all if all=true)

get

https://backend.pay.kiichain.iohttps://backend.pay.staging.kiichain.io

/blockchain/v1/chains/tokens

Response is keyed by chain_id, each mapping to its own token_symbol lookup

Query parameters

chainIdsstring[]Required

chain_ids is the list of chain IDs to get tokens for

allbooleanOptional

all indicates whether to return all tokens including disabled ones If false or omitted, only enabled tokens are returned

modestringOptional

mode filters tokens by feature category. Supported values: "dex". If omitted, no category filter is applied.

Responses

200

A successful response.

application/json

default

An unexpected error response. details[0] is always an AppError, see #/components/schemas/AppError

application/json

get/blockchain/v1/chains/tokens

HTTPcURLJavaScriptPython

GET /blockchain/v1/chains/tokens?chainIds=text HTTP/1.1
Host: backend.pay.kiichain.io
Accept: */*

{
  "chainsTokens": {
    "ANY_ADDITIONAL_PROPERTY": {
      "tokens": {
        "ANY_ADDITIONAL_PROPERTY": {
          "chain": {
            "chainId": "text",
            "confirmationDepth": 1,
            "contracts": {
              "ANY_ADDITIONAL_PROPERTY": {
                "address": "text",
                "version": "text"
              }
            },
            "enabled": true,
            "feeAddress": "text",
            "feeBps": 1,
            "id": 1,
            "logo": "text",
            "name": "text",
            "testnet": true,
            "type": "text"
          },
          "chainTokenEnabled": true,
          "contractAddress": "text",
          "enabledDex": true,
          "id": 1,
          "native": true,
          "token": {
            "decimals": 1,
            "enabled": true,
            "id": 1,
            "logo": "text",
            "name": "text",
            "stable": true,
            "symbol": "text"
          }
        }
      }
    }
  }
}

GetChainTokens returns all token/chains relations (enabled only by default, or all if all=true)

get

https://backend.pay.kiichain.iohttps://backend.pay.staging.kiichain.io

/blockchain/v1/chains/tokens/all

Flat list across every chain. Use GetTokensByChainIDs to scope the lookup to specific chains

Query parameters

allbooleanOptional

all indicates whether to return all chain-tokens including disabled ones If false or omitted, only enabled chain-tokens are returned

modestringOptional

mode filters chain-tokens by feature category. Supported values: "dex". If omitted, no category filter is applied.

Responses

200

A successful response.

application/json

default

An unexpected error response. details[0] is always an AppError, see #/components/schemas/AppError

application/json

get/blockchain/v1/chains/tokens/all

HTTPcURLJavaScriptPython

GET /blockchain/v1/chains/tokens/all HTTP/1.1
Host: backend.pay.kiichain.io
Accept: */*

{
  "chainsTokens": [
    {
      "chain": {
        "chainId": "text",
        "confirmationDepth": 1,
        "contracts": {
          "ANY_ADDITIONAL_PROPERTY": {
            "address": "text",
            "version": "text"
          }
        },
        "enabled": true,
        "feeAddress": "text",
        "feeBps": 1,
        "id": 1,
        "logo": "text",
        "name": "text",
        "testnet": true,
        "type": "text"
      },
      "chainTokenEnabled": true,
      "contractAddress": "text",
      "enabledDex": true,
      "id": 1,
      "native": true,
      "token": {
        "decimals": 1,
        "enabled": true,
        "id": 1,
        "logo": "text",
        "name": "text",
        "stable": true,
        "symbol": "text"
      }
    }
  ]
}

GetChainByID returns a single chain by ID

get

https://backend.pay.kiichain.iohttps://backend.pay.staging.kiichain.io

/blockchain/v1/chains/{chainId}

Includes the chain's contracts map and confirmation depth

Path parameters

chainIdstringRequired

chain_id is the blockchain network identifier (e.g., "1" for Ethereum)

Responses

200

A successful response.

application/json

default

An unexpected error response. details[0] is always an AppError, see #/components/schemas/AppError

application/json

get/blockchain/v1/chains/{chainId}

HTTPcURLJavaScriptPython

GET /blockchain/v1/chains/{chainId} HTTP/1.1
Host: backend.pay.kiichain.io
Accept: */*

{
  "chain": {
    "chainId": "text",
    "confirmationDepth": 1,
    "contracts": {
      "ANY_ADDITIONAL_PROPERTY": {
        "address": "text",
        "version": "text"
      }
    },
    "enabled": true,
    "feeAddress": "text",
    "feeBps": 1,
    "id": 1,
    "logo": "text",
    "name": "text",
    "testnet": true,
    "type": "text"
  }
}

GetChainTokenRelation returns a single chain-token relation

get

https://backend.pay.kiichain.iohttps://backend.pay.staging.kiichain.io

/blockchain/v1/chains/{chainId}/tokens/{tokenSymbol}

Looked up by chain_id and token_symbol together

Path parameters

chainIdstringRequired

chain_id is the unique identifier of the chain

tokenSymbolstringRequired

token_symbol is the ticker symbol of the token

Responses

200

A successful response.

application/json

default

An unexpected error response. details[0] is always an AppError, see #/components/schemas/AppError

application/json

get/blockchain/v1/chains/{chainId}/tokens/{tokenSymbol}

HTTPcURLJavaScriptPython

GET /blockchain/v1/chains/{chainId}/tokens/{tokenSymbol} HTTP/1.1
Host: backend.pay.kiichain.io
Accept: */*

{
  "chainToken": {
    "chain": {
      "chainId": "text",
      "confirmationDepth": 1,
      "contracts": {
        "ANY_ADDITIONAL_PROPERTY": {
          "address": "text",
          "version": "text"
        }
      },
      "enabled": true,
      "feeAddress": "text",
      "feeBps": 1,
      "id": 1,
      "logo": "text",
      "name": "text",
      "testnet": true,
      "type": "text"
    },
    "chainTokenEnabled": true,
    "contractAddress": "text",
    "enabledDex": true,
    "id": 1,
    "native": true,
    "token": {
      "decimals": 1,
      "enabled": true,
      "id": 1,
      "logo": "text",
      "name": "text",
      "stable": true,
      "symbol": "text"
    }
  }
}

GetTokens returns a list of tokens (enabled only by default, or all if all=true)

get

https://backend.pay.kiichain.iohttps://backend.pay.staging.kiichain.io

/blockchain/v1/tokens

Platform-wide list, not scoped to a chain or wallet

Query parameters

allbooleanOptional

all indicates whether to return all tokens including disabled ones If false or omitted, only enabled tokens are returned

Responses

200

A successful response.

application/json

default

An unexpected error response. details[0] is always an AppError, see #/components/schemas/AppError

application/json

get/blockchain/v1/tokens

HTTPcURLJavaScriptPython

GET /blockchain/v1/tokens HTTP/1.1
Host: backend.pay.kiichain.io
Accept: */*

{
  "tokens": [
    {
      "decimals": 1,
      "enabled": true,
      "id": 1,
      "logo": "text",
      "name": "text",
      "stable": true,
      "symbol": "text"
    }
  ]
}

GetTokenBySymbol returns a single token by symbol

get

https://backend.pay.kiichain.iohttps://backend.pay.staging.kiichain.io

/blockchain/v1/tokens/{symbol}

Returns the token's platform-wide metadata regardless of chain

Path parameters

symbolstringRequired

symbol is the ticker symbol of the token

Responses

200

A successful response.

application/json

default

An unexpected error response. details[0] is always an AppError, see #/components/schemas/AppError

application/json

get/blockchain/v1/tokens/{symbol}

HTTPcURLJavaScriptPython

GET /blockchain/v1/tokens/{symbol} HTTP/1.1
Host: backend.pay.kiichain.io
Accept: */*

{
  "token": {
    "decimals": 1,
    "enabled": true,
    "id": 1,
    "logo": "text",
    "name": "text",
    "stable": true,
    "symbol": "text"
  }
}

ExecuteTransaction signs and broadcasts a batch of transactions on behalf of the caller

post

https://backend.pay.kiichain.iohttps://backend.pay.staging.kiichain.io

/blockchain/v1/transactions/execute

Each transaction is signed using the caller's delegated wallet. Failed transactions are returned as "0x00" in the response and do not abort the rest of the batch

Required scopes

This endpoint requires the following scopes:

Authorizations

ApiKeyAuthBearerAuth

AuthorizationstringRequired

Send 'Authorization: APIKey ' to authenticate with a API key.

Body

application/json

ExecuteTransactionRequest contains the ordered list of transactions to execute.

Responses

200

A successful response.

application/json

ExecuteTransactionResponse contains the transaction hashes in the same order as the request. Failed transactions are represented as "0x00".

txHashesstring[]Optional

default

An unexpected error response. details[0] is always an AppError, see #/components/schemas/AppError

application/json

post/blockchain/v1/transactions/execute

HTTPcURLJavaScriptPython

POST /blockchain/v1/transactions/execute HTTP/1.1
Host: backend.pay.kiichain.io
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 160

{
  "transactions": [
    {
      "evm": {
        "chainId": "text",
        "data": "text",
        "from": "text",
        "metadata": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "to": "text",
        "type": "text",
        "value": "text"
      }
    }
  ]
}

{
  "txHashes": [
    "text"
  ]
}

GetInternalWallets returns the internal wallets owned by the caller

get

https://backend.pay.kiichain.iohttps://backend.pay.staging.kiichain.io

/blockchain/v1/wallets/internal

Lists the internal wallets tied to the authenticated user's account(s), across every chain family

Required scopes

This endpoint requires the following scopes:

Authorizations

ApiKeyAuthBearerAuth

AuthorizationstringRequired

Send 'Authorization: APIKey ' to authenticate with a API key.

Responses

200

A successful response.

application/json

GetInternalWalletsResponse contains the caller's internal wallets.

default

An unexpected error response. details[0] is always an AppError, see #/components/schemas/AppError

application/json

get/blockchain/v1/wallets/internal

HTTPcURLJavaScriptPython

GET /blockchain/v1/wallets/internal HTTP/1.1
Host: backend.pay.kiichain.io
Authorization: YOUR_API_KEY
Accept: */*

{
  "wallets": [
    {
      "address": "text",
      "chainType": "text",
      "id": "text"
    }
  ]
}

SendBalanceFromInternalWallet sends a balance out of the caller's internal wallet

post

https://backend.pay.kiichain.iohttps://backend.pay.staging.kiichain.io

/blockchain/v1/wallets/internal/send

Builds a native (gas token) or ERC20 transfer from the caller's internal wallet to the given address, then signs and broadcasts it using the caller's delegated wallet. The asset field selects the token to send; an empty or zero address sends the native gas token. Works on any supported chain given its chain_id

Required scopes

This endpoint requires the following scopes:

Authorizations

ApiKeyAuthBearerAuth

AuthorizationstringRequired

Send 'Authorization: APIKey ' to authenticate with a API key.

Body

application/json

SendBalanceFromInternalWalletRequest asks to send a balance out of the caller's internal wallet.

amountstringRequired

assetstringOptional

chainIdstringRequired

tostringRequired

Responses

200

A successful response.

application/json

SendBalanceFromInternalWalletResponse contains the broadcast transaction hash.

txHashstringOptional

default

An unexpected error response. details[0] is always an AppError, see #/components/schemas/AppError

application/json

post/blockchain/v1/wallets/internal/send

HTTPcURLJavaScriptPython

POST /blockchain/v1/wallets/internal/send HTTP/1.1
Host: backend.pay.kiichain.io
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "amount": "text",
  "asset": "text",
  "chainId": "text",
  "to": "text"
}

{
  "txHash": "text"
}