curl -X POST "https://api.danubeai.com/v1/agents" \
-H "Content-Type: application/json" \
-d '{"name": "research-bot", "operator_email": "ops@example.com"}'
{
"agent_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
"api_key": "nQ3vX8pK2mT7rW9jY5uB1cD4fH6gL0aZsEiOqUtMk7w",
"wallet_id": "w_8b1d…",
"balance_usdc": "0.000000",
"deposit_address": "0x1234…abcd",
"registration_url": "https://api.danubeai.com/v1/agents/2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10/registration.json",
"getting_started": {
"free_tier": {"calls_per_month": 5000, "note": "No credential and no funding needed for the tools below…"},
"endpoints": {
"mcp": "https://mcp.danubeai.com/mcp",
"search": "GET https://api.danubeai.com/v1/tools/search?query=...&ready_only=true",
"describe": "GET https://api.danubeai.com/v1/tools/{tool_id}/describe",
"execute": "POST https://api.danubeai.com/v1/tools/call/{tool_id}",
"auth_header": "danube-api-key: <your key>"
},
"try_first": [
{"tool_id": "8ca97ef7-acf5-4869-b043-a9960a9f8085", "name": "Hacker News - Get Top Stories With Content", "service": "Hacker News", "parameters": {"limit": {"type": "integer", "required": false}}, "execute": "POST https://api.danubeai.com/v1/tools/call/8ca97ef7-acf5-4869-b043-a9960a9f8085"}
],
"steps": ["Search with ready_only=true to see only tools you can call now.", "…"],
"read_next": ["https://danubeai.com/skill.md", "https://docs.danubeai.com/quickstart"]
}
}
Agents
Register Agent
Self-register an autonomous agent and receive an API key, a wallet, and a getting-started block
POST
/
v1
/
agents
curl -X POST "https://api.danubeai.com/v1/agents" \
-H "Content-Type: application/json" \
-d '{"name": "research-bot", "operator_email": "ops@example.com"}'
{
"agent_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
"api_key": "nQ3vX8pK2mT7rW9jY5uB1cD4fH6gL0aZsEiOqUtMk7w",
"wallet_id": "w_8b1d…",
"balance_usdc": "0.000000",
"deposit_address": "0x1234…abcd",
"registration_url": "https://api.danubeai.com/v1/agents/2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10/registration.json",
"getting_started": {
"free_tier": {"calls_per_month": 5000, "note": "No credential and no funding needed for the tools below…"},
"endpoints": {
"mcp": "https://mcp.danubeai.com/mcp",
"search": "GET https://api.danubeai.com/v1/tools/search?query=...&ready_only=true",
"describe": "GET https://api.danubeai.com/v1/tools/{tool_id}/describe",
"execute": "POST https://api.danubeai.com/v1/tools/call/{tool_id}",
"auth_header": "danube-api-key: <your key>"
},
"try_first": [
{"tool_id": "8ca97ef7-acf5-4869-b043-a9960a9f8085", "name": "Hacker News - Get Top Stories With Content", "service": "Hacker News", "parameters": {"limit": {"type": "integer", "required": false}}, "execute": "POST https://api.danubeai.com/v1/tools/call/8ca97ef7-acf5-4869-b043-a9960a9f8085"}
],
"steps": ["Search with ready_only=true to see only tools you can call now.", "…"],
"read_next": ["https://danubeai.com/skill.md", "https://docs.danubeai.com/quickstart"]
}
}
Overview
An agent with no human in the loop can register itself and make a successful call within a minute. Registration creates a free-tier account, an API key (shown once), and a USDC wallet, and returnsgetting_started: the endpoints to use, the free-tier limits, three credential-free tools to try first, and what to read next.
No funding is needed for the tools in try_first. Priced tools need wallet balance; tools marked needs_credential in search need a credential connected by the operator.
Auth: none. Rate limited to 5 registrations per minute per IP.
Body
string
required
A name for the agent. Shown in the dashboard and in audit entries.
string
required
Who runs this agent. Used for account notices; never shown publicly.
Response
string
The agent’s account id
string
The API key. Shown once; store it.
string
USDC wallet id
string
Starting balance, normally
0.000000string
Where to send USDC on Base to fund priced tools
string
A public ERC-8004 style registration document for this agent
object
Show Getting started block
Show Getting started block
object
calls_per_month and a note on what needs funding or credentials.object
mcp, search, describe, execute, auth_header.array
Up to three credential-free tools:
tool_id, name, service, description, parameters, execute.array
Four sentences on the shortest path to a first success.
array
The agent skill file and the quickstart.
GET /v1/agents/getting-started (no auth).
Example
curl -X POST "https://api.danubeai.com/v1/agents" \
-H "Content-Type: application/json" \
-d '{"name": "research-bot", "operator_email": "ops@example.com"}'
{
"agent_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
"api_key": "nQ3vX8pK2mT7rW9jY5uB1cD4fH6gL0aZsEiOqUtMk7w",
"wallet_id": "w_8b1d…",
"balance_usdc": "0.000000",
"deposit_address": "0x1234…abcd",
"registration_url": "https://api.danubeai.com/v1/agents/2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10/registration.json",
"getting_started": {
"free_tier": {"calls_per_month": 5000, "note": "No credential and no funding needed for the tools below…"},
"endpoints": {
"mcp": "https://mcp.danubeai.com/mcp",
"search": "GET https://api.danubeai.com/v1/tools/search?query=...&ready_only=true",
"describe": "GET https://api.danubeai.com/v1/tools/{tool_id}/describe",
"execute": "POST https://api.danubeai.com/v1/tools/call/{tool_id}",
"auth_header": "danube-api-key: <your key>"
},
"try_first": [
{"tool_id": "8ca97ef7-acf5-4869-b043-a9960a9f8085", "name": "Hacker News - Get Top Stories With Content", "service": "Hacker News", "parameters": {"limit": {"type": "integer", "required": false}}, "execute": "POST https://api.danubeai.com/v1/tools/call/8ca97ef7-acf5-4869-b043-a9960a9f8085"}
],
"steps": ["Search with ready_only=true to see only tools you can call now.", "…"],
"read_next": ["https://danubeai.com/skill.md", "https://docs.danubeai.com/quickstart"]
}
}