---
title: "Transfer tokens to a specified wallet address"
method: POST
path: "/api/v1/blockchain/transfer-token"
tags: ["Transactional"]
---

# Transfer tokens to a specified wallet address

`POST /api/v1/blockchain/transfer-token`

## Request body

- TransferTokenDto
  - `recipientWalletAddress` string, required — The wallet address of the recipient.
  - `amount` integer, required — The amount of tokens to transfer.

## Response `200`

Token successfully transferred.

- TokenTransferResponseDto
  - `message` string, required — A message indicating the result of the API request.
  - `httpCode` number, required — HTTP status code of the response.
  - `payload` object, required
    - `transactionHash` string — The hash of the token transfer transaction.
    - `blockNumber` string — The block number in which the transaction was included.
    - `cumulativeGasUsed` string — The total amount of gas used when the transaction was included in a block.

## Other responses

- `400` — Bad request or transfer failed.
- `500` — Server Error.

---

[API](https://skmtc.dev/wso2/apis/wso2-transactional-api.md) · [All operations](https://skmtc.dev/wso2/apis/wso2-transactional-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wso2/wso2-transactional-api/revisions/88a583635618/schema)