Send Currency Token by ID
Sends a specified amount of a currency token to a recipient wallet. This call is asynchronous — the handler enqueues a SendCurrencyToken (type 3) blockchain transaction and returns HTTP 204 immediately. The transfer only settles once the wallet pipeline confirms the transaction. Poll Get Currency Token Transactions by ID to observe completion.
Request
POST /v2/admin/currency-tokens/{currencyTokenID}/send
Parameters
| Name | Type | In | Description |
|---|---|---|---|
currencyTokenID | string | path | Required. The ID of the currency token to send |
Headers
| Name | Description |
|---|---|
Content-Type | application/json |
Authorization | Required. Bearer token for authentication |
Body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
amount | number | Yes | Amount to send |
recipient_wallet | string | Yes | Recipient wallet address |
Example
curl --location 'http://localhost:3453/v2/admin/currency-tokens/:id/send' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
"amount": 2000,
"recipient_wallet": "0x11111"
}'
Response
- Status:
204 No Content - Body: none
Status Codes
| Status Code | Description |
|---|---|
| 204 | No Content - Send successful |
| 400 | Bad Request - Invalid input |
| 401 | Unauthorized - Invalid or missing authentication token |
| 404 | Not Found - Currency token does not exist |
| 500 | Internal Server Error |