Documentation
Create agent wallets, resolve handles, send test USDT on Ethereum Sepolia, Base Sepolia, or Solana devnet, and inspect transaction state through server-side API keys.
curl -s https://coral.buildinpublic.fun/api/v1/agents \
-H 'Authorization: Bearer coral_sk_test_...'Use the Developer Portal. The raw key is shown once.
Assign a handle, wallet, and daily/per-transaction limits.
Existing handles receive a transaction; missing handles produce a claim link.
API v1 endpoints use a server-side bearer token. Create keys from `/developer`, store the raw key in your server environment, and send it on every request.
Coral defaults to mock ledger mode. To broadcast testnet transfers, set `MOCK_PAYMENTS=false`, create or configure test USDT contracts/mints, and fund EVM sender wallets with gas. On Solana devnet, an optional gas bank can pay network fees and recipient token-account rent.
MOCK_PAYMENTS=false
BASE_SEPOLIA_RPC_URL=https://sepolia.base.org
BASE_SEPOLIA_USDT_ADDRESS=0x_your_base_sepolia_erc20
BASE_SEPOLIA_USDT_DECIMALS=6
ETHEREUM_SEPOLIA_RPC_URL=https://ethereum-sepolia-rpc.publicnode.com
ETHEREUM_SEPOLIA_USDT_ADDRESS=0x_your_ethereum_sepolia_erc20
ETHEREUM_SEPOLIA_USDT_DECIMALS=6
ETHEREUM_SEPOLIA_GAS_BANK_PRIVATE_KEY_PATH=/secure/path/ethereum-sepolia-gas-bank.json
ETHEREUM_SEPOLIA_GAS_BANK_MIN_ETH=0.001
ETHEREUM_SEPOLIA_GAS_BANK_TOP_UP_ETH=0.005
SOLANA_DEVNET_RPC_URL=https://api.devnet.solana.com
SOLANA_DEVNET_USDT_MINT=your_devnet_spl_mint
SOLANA_DEVNET_USDT_DECIMALS=6
SOLANA_DEVNET_GAS_BANK_SECRET_KEY_PATH=/secure/path/solana-gas-bank.jsoncurl -s https://coral.buildinpublic.fun/api/v1/agents \
-H 'Authorization: Bearer coral_sk_test_...' \
-H 'Content-Type: application/json' \
-d '{
"name": "Research Agent",
"handle": "research_agent",
"dailySpendLimit": "100",
"perTransactionLimit": "25"
}'curl -s https://coral.buildinpublic.fun/api/v1/agents/agent_123/send \
-H 'Authorization: Bearer coral_sk_test_...' \
-H 'Content-Type: application/json' \
-d '{
"to": "alex",
"amount": "5.00",
"token": "USDT",
"chain": "ethereum-sepolia"
}'curl -s https://coral.buildinpublic.fun/api/v1/handles/alex \
-H 'Authorization: Bearer coral_sk_test_...'curl -s https://coral.buildinpublic.fun/api/v1/transactions \
-H 'Authorization: Bearer coral_sk_test_...'Returns the agent wallets owned by the API key account.
{
"agents": [
{
"id": "agent_123",
"name": "Research Agent",
"handle": "@research_agent",
"walletAddress": "0x...",
"solanaAddress": "7Y...",
"dailySpendLimit": "100",
"perTransactionLimit": "25",
"status": "ACTIVE"
}
]
}Creates an encrypted wallet, handle reservation, and spend policy for an agent.
{
"name": "Research Agent",
"handle": "research_agent",
"dailySpendLimit": "100",
"perTransactionLimit": "25"
}{
"agent": {
"id": "agent_123",
"handle": "@research_agent",
"walletAddress": "0x...",
"solanaAddress": "7Y...",
"status": "ACTIVE"
}
}Sends USDT from an agent wallet to a Coral handle after checking spend limits. Uses mock ledger mode by default, or broadcasts on Ethereum Sepolia, Base Sepolia, or Solana devnet when live testnet mode is enabled.
{
"to": "alex",
"amount": "5.00",
"token": "USDT",
"chain": "ethereum-sepolia"
}{
"status": "success",
"txHash": "0x...",
"toHandle": "@alex",
"toWallet": "0x...",
"chain": "ethereum-sepolia",
"explorerUrl": "https://sepolia.etherscan.io/tx/0x..."
}Resolves a user or agent handle to Base and Solana receive addresses.
{
"handle": "@alex",
"walletAddress": "0x...",
"solanaAddress": "7Y...",
"ownerType": "USER"
}Returns the latest user and agent-originated payment records for the API key owner.
{
"transactions": [
{
"id": "txn_123",
"type": "AGENT_SEND",
"status": "CLAIM_CREATED",
"claimId": "claim_123"
}
]
}When `POST /api/v1/agents/:agentId/send` targets a handle that does not exist, Coral creates a secure claim URL. The recipient signs up, claims the intended handle, and redeems the pending funds from the claim page.