curl -X GET "https://api.danubeai.com/v1/agents/me" \
-H "danube-api-key: YOUR_API_KEY"
from danube import DanubeClient
with DanubeClient(api_key="YOUR_API_KEY") as client:
info = client.agents.get_info()
print(f"{info.name}: {info.balance_usdc} USDC")
import { DanubeClient } from 'danube';
const client = new DanubeClient({ apiKey: 'YOUR_API_KEY' });
const info = await client.agents.getInfo();
console.log(`${info.name}: ${info.wallet?.balance_usdc} USDC`);
{
"agent_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
"name": "research-bot",
"agent_type": "autonomous",
"operator_email": "ops@example.com",
"wallet": {
"id": "9d3e5b1a-0c2f-4a6b-8e7d-1f2a3b4c5d6e",
"balance_usdc": "12.500000",
"balance_atomic": 12500000
},
"deposit_address": "0x1234…abcd",
"registration_url": "https://api.danubeai.com/v1/agents/2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10/registration.json",
"created_at": "2026-09-01T10:00:00+00:00"
}
Agents
Get Agent Info
Get the calling agent profile, its USDC wallet balance and its deposit address
GET
/
v1
/
agents
/
me
curl -X GET "https://api.danubeai.com/v1/agents/me" \
-H "danube-api-key: YOUR_API_KEY"
from danube import DanubeClient
with DanubeClient(api_key="YOUR_API_KEY") as client:
info = client.agents.get_info()
print(f"{info.name}: {info.balance_usdc} USDC")
import { DanubeClient } from 'danube';
const client = new DanubeClient({ apiKey: 'YOUR_API_KEY' });
const info = await client.agents.getInfo();
console.log(`${info.name}: ${info.wallet?.balance_usdc} USDC`);
{
"agent_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
"name": "research-bot",
"agent_type": "autonomous",
"operator_email": "ops@example.com",
"wallet": {
"id": "9d3e5b1a-0c2f-4a6b-8e7d-1f2a3b4c5d6e",
"balance_usdc": "12.500000",
"balance_atomic": 12500000
},
"deposit_address": "0x1234…abcd",
"registration_url": "https://api.danubeai.com/v1/agents/2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10/registration.json",
"created_at": "2026-09-01T10:00:00+00:00"
}
Overview
Returns the profile behind the API key, the agent’s USDC wallet balance, the platform deposit address and the link to the agent’s public registration document. Use it to check funds before calling a priced tool, or to find the deposit address again after registration. Only agent accounts can call this endpoint. A key that belongs to a human account gets a 400; human accounts use/v1/users/me.
Auth: Requires API key (danube-api-key header). A JWT is not accepted here.
Response
The platform’s USDC deposit address on Base.
null when the platform wallet is not configured.Errors
| Code | Meaning |
|---|---|
| 400 | The key belongs to a human account |
| 401 | Missing or invalid API key |
| 404 | No profile found for this key |
Example
curl -X GET "https://api.danubeai.com/v1/agents/me" \
-H "danube-api-key: YOUR_API_KEY"
from danube import DanubeClient
with DanubeClient(api_key="YOUR_API_KEY") as client:
info = client.agents.get_info()
print(f"{info.name}: {info.balance_usdc} USDC")
import { DanubeClient } from 'danube';
const client = new DanubeClient({ apiKey: 'YOUR_API_KEY' });
const info = await client.agents.getInfo();
console.log(`${info.name}: ${info.wallet?.balance_usdc} USDC`);
{
"agent_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
"name": "research-bot",
"agent_type": "autonomous",
"operator_email": "ops@example.com",
"wallet": {
"id": "9d3e5b1a-0c2f-4a6b-8e7d-1f2a3b4c5d6e",
"balance_usdc": "12.500000",
"balance_atomic": 12500000
},
"deposit_address": "0x1234…abcd",
"registration_url": "https://api.danubeai.com/v1/agents/2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10/registration.json",
"created_at": "2026-09-01T10:00:00+00:00"
}
MCP Tool
This endpoint is also available as theget_agent_info MCP tool:
result = await mcp.call_tool("get_agent_info", {})
org_id, org_name, org_slug and org_role. They are null when no organization context can be resolved.