Wallet API
Check your workspace wallet balance on Base. Each workspace has one CDP-managed wallet that holds USDC, ETH, and ADAO. This wallet receives incoming payments and sends outbound payouts.
How Workspace Wallets Work
One wallet per workspace, managed by PayDirect
Auto-Provisioned
A wallet is created automatically when you set up your workspace. No manual creation needed.
Multi-Token
Holds ETH (gas), USDC (stablecoin), and ADAO (utility token) on Base.
CDP-Managed
Secured by Coinbase Developer Platform. Private keys managed by CDP, not stored in your app.
Workspace Wallet (0xYour...) ├── ETH — Gas for on-chain transactions ├── USDC — Stablecoin for payments & payouts └── ADAO — AgentDAO utility token Used by: • Payments API → Receives incoming crypto (temporary receiving address → forwards here) • Payouts API → Sends outbound crypto from this wallet • Balance API → Check current balances (this endpoint)
GET
/api/v1/wallet/balance
Get current workspace wallet balances
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer pd_test_... or pd_live_... |
cURL Example
curl https://paydirect.com/api/v1/wallet/balance \
-H "Authorization: Bearer pd_live_abc123..."TypeScript SDK
const balance = await client.getWalletBalance();
console.log(balance.address); // "0xYourWorkspaceWallet..."
console.log(balance.usdc); // "1234.56"
console.log(balance.eth); // "0.05"
console.log(balance.adao); // "50000.00"Response (200 OK)
{
"address": "0xYourWorkspaceWallet...",
"eth": "0.05",
"usdc": "1234.56",
"adao": "50000.00",
"environment": "live"
}Response Fields
| Field | Type | Description |
|---|---|---|
address | string | Your workspace wallet address on Base (0x...) |
eth | string | ETH balance (18 decimals, used for gas) |
usdc | string | USDC balance (6 decimals) |
adao | string | ADAO balance (18 decimals) |
environment | string | "sandbox" (Base Sepolia) or "live" (Base Mainnet) |
Error Responses
Common wallet errors
No Workspace Wallet (400)
{
"error": "No workspace wallet found. Provision a wallet first."
}This means your workspace doesn't have a wallet yet. Go to the PayDirect dashboard to provision one, or contact support.
Unauthorized (401)
{
"error": "Invalid API key"
}Supported Tokens
Tokens held in your workspace wallet on Base
| Token | Type | Decimals | Contract (Mainnet) | Use |
|---|---|---|---|---|
| ETH | Native | 18 | — | Gas for transactions + payments |
| USDC | ERC-20 | 6 | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 | Stablecoin payments & payouts |
| ADAO | ERC-20 | 18 | 0x1ef7Be0aBff7d1490e952eC1C7476443A66d6b72 | AgentDAO utility token (0.25% fee) |
Best Practices
Tips for managing your workspace wallet
- Check balance before payouts. Call
GET /api/v1/wallet/balancebefore creating payouts to avoid insufficient balance errors. - Keep ETH funded for gas. On-chain transactions (forwarding payments, sending payouts) require ETH for gas. Monitor your ETH balance and top up as needed.
- Use sandbox for testing. Sandbox keys (
pd_test_) point to Base Sepolia where balances are test tokens. No real funds at risk. - Set up low balance alerts. Monitor your wallet balance and set up alerts when USDC or ADAO drops below a threshold to avoid failed payouts.
- Your wallet address is public. The
addressfield is your on-chain address. You can view transactions on BaseScan.