Get Balance
Returns your current ACN balance and lifetime transaction summary.
Example
curl https://api.acn.exchange/v1/wallet/balance \
-H "Authorization: Bearer acn_sk_your_api_key"
Response
{
"balance_usdc": "10.50",
"pending_settlements_usdc": "0.00",
"total_deposited_usdc": "25.00",
"total_spent_usdc": "14.50"
}
| Field | Type | Description |
|---|
balance_usdc | string | Current available balance |
pending_settlements_usdc | string | Amount pending in settlement |
total_deposited_usdc | string | Lifetime deposits |
total_spent_usdc | string | Lifetime spend on calls |
Deposit Funds
Submit a deposit transaction hash for verification. After sending USDC to the ACN platform wallet on Base, call this endpoint so ACN can verify the transaction and credit your balance.
Request Body
| Field | Type | Required | Description |
|---|
tx_hash | string | Yes | The on-chain transaction hash of your USDC transfer |
Example
curl -X POST https://api.acn.exchange/v1/wallet/deposit \
-H "Authorization: Bearer acn_sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"tx_hash": "0xabc123..."
}'
Response
{
"deposit_id": "dep_abc123",
"amount_usdc": "10.00",
"status": "confirmed",
"new_balance_usdc": "20.50"
}
Deposit Flow
- Send USDC on Base to the ACN platform wallet address
- Wait for the transaction to be confirmed on-chain
- Call
POST /v1/wallet/deposit with the transaction hash
- ACN verifies the transfer event and credits your balance
Minimum deposit: $5 USDC. The platform wallet address is available in your dashboard.
Transaction History
Returns your recent transactions (calls, deposits, refunds).
Query Parameters
| Parameter | Type | Default | Description |
|---|
limit | number | 20 | Number of transactions to return (max 100) |
cursor | string | — | Pagination cursor |
type | string | — | Filter by type: call, deposit, refund, settlement |
Example
curl "https://api.acn.exchange/v1/wallet/history?limit=5&type=call" \
-H "Authorization: Bearer acn_sk_your_api_key"
Response
{
"data": [
{
"id": "txn_abc123",
"type": "call",
"amount_usdc": "-0.002",
"call_id": "call_7f8a9b2c",
"provider_id": "resend",
"endpoint": "send-email",
"timestamp": "2026-03-08T12:00:00Z"
},
{
"id": "txn_def456",
"type": "deposit",
"amount_usdc": "+10.00",
"tx_hash": "0xabc123...",
"timestamp": "2026-03-08T11:00:00Z"
}
],
"pagination": {
"has_more": true,
"next_cursor": "cursor_xyz"
}
}
Error Codes
| Code | Description |
|---|
ACN-PAY-001 | Insufficient balance (for execution, not deposit) |
ACN-PAY-002 | Invalid transaction hash — not found on-chain |
ACN-PAY-003 | Transaction already processed — duplicate deposit |
ACN-PAY-004 | Below minimum deposit amount ($5 USDC) |
ACN-PAY-005 | Transaction recipient is not the ACN platform wallet |
ACN-AUTH-001 | Missing or invalid authentication |
