> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.walletstech.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.walletstech.com/_mcp/server.

# Send from the platform wallet

POST https://api-demo.walletstech.com/platform/send
Content-Type: application/json

Signs and broadcasts a transfer from **your platform's own wallet** — the twin of [`/send`](/api-reference/transfers/send-transfer), with two differences: there is no `userId`, and there is **no `password`** — the platform wallet's key is held and unlocked by the service, so the body is just `assetId`, `recipient` and `amount`.

Everything else is identical to `/send` and its description applies verbatim: native transfers deliver `amount` − fee while token transfers deliver the full `amount`, a `txHash` is not a confirmation, and **`X-Request-Id` is required** — it is the idempotency key, scoped to the platform wallet. Reuse the same id to retry a transfer safely; a duplicate never broadcasts twice.

Use this to pay out from the wallet you fund at [`/platform/addresses`](/api-reference/platform-wallet/get-platform-addresses) — for example to settle a completed trade with a user.

Do not send an `X-USER-ID` header here — a platform endpoint always acts as the platform wallet, and sending one is a `400`.

Reference: https://docs.walletstech.com/api-reference/platform-wallet/send-platform-transfer

## Authentication

- `Authorization` header (bearer token, required) — A 15-minute token from `/auth`. Required on every endpoint except `/auth`.

## Servers

- `https://api-demo.walletstech.com` (Sandbox. Develop and test here. Requires its own credentials., default)
- `https://api.walletstech.com` (Production — real funds, and transfers that cannot be reversed. Requires its own credentials.)

## Request

### Headers

- `X-Request-Id` (string, required) — **Required on `/send`, and client-supplied** — it is the idempotency key for the transfer. One id per logical transfer; **the same id on every retry of it**; a fresh id for a new transfer. 1–64 characters of `A-Za-z0-9._-`. Omitting it is a `400`.

### Body (application/json)

This endpoint expects an object.

- `assetId` (enum, required) — Primary asset selector. An all-digit string (`"21"`) is accepted and normalised to an integer. - `1` — BITCOIN BTC (native, 8 decimals) - `2` — ETHEREUM ETH (native, 18 decimals) - `21` — ETHEREUM USDT (ERC20, 6 decimals) - `22` — ETHEREUM USDC (ERC20, 6 decimals) - `3` — BSC BNB (native, 18 decimals) - `31` — BSC USDT (BEP20, 18 decimals) - `32` — BSC USDC (BEP20, 18 decimals) - `4` — TRON TRX (native, 6 decimals) - `41` — TRON USDT (TRC20, 6 decimals) - `42` — TRON USDC (TRC20, 6 decimals) — not on every endpoint - `5` — POLYGON POL (native, 18 decimals) - `51` — POLYGON USDT (ERC20, 6 decimals) — not on every endpoint - `52` — POLYGON USDC (ERC20, 6 decimals) - `6` — SOLANA SOL (native, 9 decimals) - `61` — SOLANA USDT (SPL, 6 decimals) — not on every endpoint - `62` — SOLANA USDC (SPL, 6 decimals)
  - Allowed values: `1`, `2`, `21`, `22`, `3`, `31`, `32`, `4`, `41`, `42`, `5`, `51`, `52`, `6`, `61`, `62`
- `recipient` (string, required) — Destination address on the asset's chain. Must differ from the platform wallet's own address.
- `amount` (string, required) — Human-decimal amount string. Same rules and minimums as `/send`.

## Response

### 200

OK

- `result` (object, required)
  - `txHash` (string, required) — Broadcast hash. **Not a confirmation** — poll `/platform/txid` for status.
- `requestId` (string, required) — Echo of the inbound `X-Request-Id`, or a generated one.

## Errors

### 400 Bad Request Error

Bad Request

- `message` (string, required) — Safe, client-facing message. Internal detail never leaks here.
- `error` (string, required) — The HTTP status code, as a string.
- `requestId` (string, required) — Echo of the inbound `X-Request-Id`, or a generated one.

### 401 Unauthorized Error

Unauthorized — no bearer token, or one that does not verify. Get a fresh access token from `/refresh` (or `/auth`) and replay the request.

- `message` (string, required) — Safe, client-facing message. Internal detail never leaks here.
- `error` (string, required) — The HTTP status code, as a string.
- `requestId` (string, required) — Echo of the inbound `X-Request-Id`, or a generated one.

### 402 Payment Required Error

Payment Required — the platform wallet cannot cover the amount plus the network fee. Fund it and retry with the same `X-Request-Id`.

- `message` (string, required) — Safe, client-facing message. Internal detail never leaks here.
- `error` (string, required) — The HTTP status code, as a string.
- `requestId` (string, required) — Echo of the inbound `X-Request-Id`, or a generated one.

### 403 Forbidden Error

Forbidden — that asset is not enabled for your api client. Permanent until your operator enables it: do not retry.

- `message` (string, required) — Safe, client-facing message. Internal detail never leaks here.
- `error` (string, required) — The HTTP status code, as a string.
- `requestId` (string, required) — Echo of the inbound `X-Request-Id`, or a generated one.

### 404 Not Found Error

Not Found — your api client has no platform wallet yet. It is provisioned by the service operator; ask for it, then retry.

- `message` (string, required) — Safe, client-facing message. Internal detail never leaks here.
- `error` (string, required) — The HTTP status code, as a string.
- `requestId` (string, required) — Echo of the inbound `X-Request-Id`, or a generated one.

### 409 Conflict Error

Conflict — the original attempt with this `X-Request-Id` is still in flight, the wallet is busy with another send, or the transfer is still being prepared. Back off and retry with the **same** id.

- `message` (string, required) — Safe, client-facing message. Internal detail never leaks here.
- `error` (string, required) — The HTTP status code, as a string.
- `requestId` (string, required) — Echo of the inbound `X-Request-Id`, or a generated one.

### 422 Unprocessable Entity Error

Unprocessable — this `X-Request-Id` is already committed to a different `assetId` / `recipient` / `amount`. Use a fresh id for a new transfer.

- `message` (string, required) — Safe, client-facing message. Internal detail never leaks here.
- `error` (string, required) — The HTTP status code, as a string.
- `requestId` (string, required) — Echo of the inbound `X-Request-Id`, or a generated one.

### 503 Service Unavailable Error

Service Unavailable — that asset is not available on your endpoint. Permanent, not a transient outage: do not retry, and contact your operator.

- `message` (string, required) — Safe, client-facing message. Internal detail never leaks here.
- `error` (string, required) — The HTTP status code, as a string.
- `requestId` (string, required) — Echo of the inbound `X-Request-Id`, or a generated one.

## Examples

**Request**

```json
{
  "assetId": 21,
  "recipient": "0x9d1e6a1c6ae4d55f4a3b28a8d5e93b1c7e2f0a4b",
  "amount": "250.5"
}
```

**Response**

```json
{
  "result": {
    "txHash": "0x2d3e4f5061728394a5b6c7d8e9f0a1b22d3e4f5061728394a5b6c7d8e9f0a1b2"
  },
  "requestId": "b7a1f0c2-3d4e-4a5b-9c6d-7e8f90a1b2c3"
}
```

**SDK Code**

```python ETHEREUM USDT (ERC20) — assetId 21 — Send
import requests

url = "https://api-demo.walletstech.com/platform/send"

payload = {
    "assetId": 21,
    "recipient": "0x9d1e6a1c6ae4d55f4a3b28a8d5e93b1c7e2f0a4b",
    "amount": "250.5"
}
headers = {
    "X-Request-Id": "X-Request-Id",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript ETHEREUM USDT (ERC20) — assetId 21 — Send
const url = 'https://api-demo.walletstech.com/platform/send';
const options = {
  method: 'POST',
  headers: {
    'X-Request-Id': 'X-Request-Id',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: '{"assetId":21,"recipient":"0x9d1e6a1c6ae4d55f4a3b28a8d5e93b1c7e2f0a4b","amount":"250.5"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go ETHEREUM USDT (ERC20) — assetId 21 — Send
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-demo.walletstech.com/platform/send"

	payload := strings.NewReader("{\n  \"assetId\": 21,\n  \"recipient\": \"0x9d1e6a1c6ae4d55f4a3b28a8d5e93b1c7e2f0a4b\",\n  \"amount\": \"250.5\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Request-Id", "X-Request-Id")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby ETHEREUM USDT (ERC20) — assetId 21 — Send
require 'uri'
require 'net/http'

url = URI("https://api-demo.walletstech.com/platform/send")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Request-Id"] = 'X-Request-Id'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"assetId\": 21,\n  \"recipient\": \"0x9d1e6a1c6ae4d55f4a3b28a8d5e93b1c7e2f0a4b\",\n  \"amount\": \"250.5\"\n}"

response = http.request(request)
puts response.read_body
```

```java ETHEREUM USDT (ERC20) — assetId 21 — Send
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api-demo.walletstech.com/platform/send")
  .header("X-Request-Id", "X-Request-Id")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"assetId\": 21,\n  \"recipient\": \"0x9d1e6a1c6ae4d55f4a3b28a8d5e93b1c7e2f0a4b\",\n  \"amount\": \"250.5\"\n}")
  .asString();
```

```php ETHEREUM USDT (ERC20) — assetId 21 — Send
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api-demo.walletstech.com/platform/send', [
  'body' => '{
  "assetId": 21,
  "recipient": "0x9d1e6a1c6ae4d55f4a3b28a8d5e93b1c7e2f0a4b",
  "amount": "250.5"
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
    'X-Request-Id' => 'X-Request-Id',
  ],
]);

echo $response->getBody();
```

```csharp ETHEREUM USDT (ERC20) — assetId 21 — Send
using RestSharp;

var client = new RestClient("https://api-demo.walletstech.com/platform/send");
var request = new RestRequest(Method.POST);
request.AddHeader("X-Request-Id", "X-Request-Id");
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"assetId\": 21,\n  \"recipient\": \"0x9d1e6a1c6ae4d55f4a3b28a8d5e93b1c7e2f0a4b\",\n  \"amount\": \"250.5\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift ETHEREUM USDT (ERC20) — assetId 21 — Send
import Foundation

let headers = [
  "X-Request-Id": "X-Request-Id",
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "assetId": 21,
  "recipient": "0x9d1e6a1c6ae4d55f4a3b28a8d5e93b1c7e2f0a4b",
  "amount": "250.5"
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api-demo.walletstech.com/platform/send")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```