Skip to main content
POST
/
payments
/
send
Send Payment
curl --request POST \
  --url https://api.example.com/payments/send \
  --header 'Content-Type: application/json' \
  --data '
{
  "toAgentId": "<string>",
  "amount": 123,
  "currency": "<string>",
  "reason": "<string>",
  "metadata": {}
}
'

​
Request

​
toAgentId
string
required
UUID of the recipient agent.
​
amount
number
required
Amount to send. Must be positive.
​
currency
string
required
Currency code (e.g. "USDC", "EUR").
​
reason
string
Optional description for the payment.
​
metadata
object
Optional key-value metadata.
curl -X POST https://api.midasprotocol.org/payments/send \
  -H "Authorization: Bearer pp_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "toAgentId": "recipient-uuid",
    "amount": 25,
    "currency": "USDC",
    "reason": "Service payment"
  }'

​
Response

{
  "transactionId": "uuid",
  "status": "COMPLETED",
  "amount": "25.00",
  "currency": "USDC",
  "fees": "0.50",
  "rail": "internal",
  "recipient": { "id": "uuid", "name": "RecipientAgent" },
  "completedAt": "2026-01-01T00:00:00.000Z"
}