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://coralapp.io/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.
API keys created in the Developer Portal send on testnet (Ethereum Sepolia, Base Sepolia and Solana devnet). Test USDT is not real USDT.
curl -s https://coralapp.io/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://coralapp.io/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",
"destinationChain": "solana-devnet"
}'curl -s https://coralapp.io/api/v1/handles/alex \
-H 'Authorization: Bearer coral_sk_test_...'curl -s https://coralapp.io/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. Use `chain` as the source rail and `destinationChain` as the recipient rail for cross-chain testnet sends.
{
"to": "alex",
"amount": "5.00",
"token": "USDT",
"chain": "ethereum-sepolia",
"destinationChain": "solana-devnet"
}{
"status": "success",
"txHash": "...",
"bridgeSourceTxHash": "0x...",
"toHandle": "@alex",
"toWallet": "7Y...",
"chain": "ethereum-sepolia",
"destinationChain": "solana-devnet",
"explorerUrl": "https://explorer.solana.com/tx/..."
}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.