转账

在钱包之间转移资产

URL

需要授权

POST

https://api.fps.pro/balances/transfer

请求格式application/json

from

required

string

发送资产的商户 ID。使用 "Personal" ID 可从个人余额转出

to

required

string

接收资产的商户 ID。使用 "Personal" ID 可转入个人余额

token

required

string

代币 ID（见加密货币列表）

network

required

string

网络 ID（见网络列表）

amount

required

string

发送的资产数量

请求示例

curl --request POST 'https://api.fps.pro/balances/transfer' \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Id: YOUR_CLIENT_ID' \
  --header 'X-Timestamp: 1720000000' \
  --header 'X-Signature: YOUR_HMAC_SHA256_SIGNATURE' \
  --data '{
  "from": "42",
  "to": "personal",
  "token": "tether",
  "network": "tron",
  "amount": "25.5"
}'

成功响应

{
  "status": 200,
  "message": "transfer success"
}

错误

详细的授权错误列表位于 授权 - 错误

{
  "status": 422,
  "message": "Validation Error",
  "errors": [
    {
      "field": "amount",
      "message": "amount is required"
    }
  ]
}
{
  "status": 400,
  "message": "Bad balance"
}
{
  "status": 400,
  "message": "Amount exceeds available balance"
}
{
  "status": 500,
  "message": "Internal Server Error"
}