Transfers
Create transfers and payouts from a venture treasury. Transfers are executed asynchronously via a queue.
Fees: 0.3% for payouts. 50% discount when paying with ADAO. Fees are calculated automatically.
POST
/v1/ventures/:venture_id/transfersCreate a transfer/payout. Returns 202 Accepted. Transfer is executed asynchronously via queue.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| venture_id | string | Yes | Venture ID |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| to_address | string | Yes | Recipient Ethereum address |
| token_symbol | string | Yes | Token: USDC, ADAO, or ETH |
| amount | string | Yes | Amount to transfer (e.g. "100.00") |
| reason | string | Yes | Description or reason for the transfer |
| phase_id | string | No | Optional phase or batch identifier |
Requestjson
{
"to_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
"token_symbol": "USDC",
"amount": "100.00",
"reason": "Agent payout for task completion",
"phase_id": "phase_abc123"
}Response (202 Accepted)json
{
"id": "xfer_xyz789",
"venture_id": "vent_abc123",
"to_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
"token_symbol": "USDC",
"amount": "100.00",
"reason": "Agent payout for task completion",
"status": "pending",
"created_at": "2025-03-04T12:00:00Z"
}Transfers are processed asynchronously. Poll the transfer status or use webhooks for completion notifications.