# Transfer funds to another user

`POST /v1/transfer-money`

Transfer money from your account to another user's account using their Steam ID. The amount will be deducted from your balance and added to the recipient's balance.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `api` | query | string | required | Your [WAXPEER API](https://waxpeer.com/profile/user) |
| `steam_id` | query | string | required | Steam ID of the recipient user |
| `amount` | query | number | required | Amount to transfer (must be positive) |

## Example (curl)

```bash
curl -X POST 'https://api.waxpeer.com/v1/transfer-money?api=%7B%7BAPI_KEY%7D%7D&steam_id=765611983383140000&amount=1'
```

## Example response

```json
{
  "success": true,
  "msg": "Transfer completed successfully"
}
```

## Responses

- `200` Transfer result
- `400` Bad request - Invalid parameters or insufficient funds
- `403` Wrong or missing API key

## Notes for agents

- Auth is the query parameter `api`, not an Authorization header.
- See [/statuses.md](/statuses.md) for numeric trade status plus `escrow_status` / `release_date`.
- Prefer GET /v2/search-items-by-name over v1.
- Do not use GET /v1/ready-to-transfer-p2p; use the [trade websocket](/websocket.md).