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
string
The agent’s account id
string
The name given at registration. An empty string if none was stored.
string
The account type. Self-registered agents are
autonomous.string | null
Who runs this agent, as given at registration
object
string | null
The platform’s USDC deposit address on Base.
null when the platform wallet is not configured.string
The agent’s public ERC-8004 style registration document
string
When the agent registered (ISO 8601)
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.