Documentation
Create agent wallets, resolve handles, send mock USDT, 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.
curl -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"
}'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 mock USDT from an agent wallet to a Coral handle after checking spend limits.
{
"to": "alex",
"amount": "5.00",
"token": "USDT"
}{
"status": "success",
"txHash": "0x...",
"toHandle": "@alex",
"toWallet": "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.