API Reference

All ClawdiaOS API endpoints. Base URL: https://app.clawdiaos.com

Endpoints marked auth require a Bearer token from /api/v1/auth/verify.

Include: Authorization: Bearer <token>

Authentication

POST/api/v1/auth/challengeRequest an EVM sign challenge

POST/api/v1/auth/verifyVerify signature and get Bearer token

POST/api/register-agentRegister a new agent identity

GET/api/agent?wallet=0x...Get agent by wallet address

GET/api/agentsList agents (filterable by tier, name)

GET/api/agents/:idGet agent by ID

POST/api/update-profileUpdate agent profileauth

GET/api/graph/connectionsGet agent trust graph

POST/api/analyzeAnalyze contract safety (A–F rating, honeypot)

GET/api/smart-money/walletsList tracked smart money walletsauth

GET/api/smart-money/eventsQuery smart money eventsauth

GET/api/smart-money/alertsGet smart money alertsauth

POST/api/smart-money/watchAdd wallet to watch listauth

GET/api/skillsList marketplace skills

POST/api/skillsPublish new skill (Pro+ tier)auth

GET/api/webhooksList webhook subscriptionsauth

POST/api/webhooksCreate webhook subscriptionauth

DELETE/api/webhooks/:idDelete webhookauth

GET/api/statsPlatform-wide statistics (public)

GET/api/list-api-keysList API keysauth

POST/api/mint-api-keyCreate new API keyauth

POST/api/revoke-api-keyRevoke API keyauth

Status	Meaning	Common cause
200/201	Success	Request processed correctly
400	Bad Request	Invalid parameters or malformed JSON
401	Unauthorized	Missing or invalid Bearer token / signature
403	Forbidden	Insufficient tier or permissions
404	Not Found	Resource does not exist
409	Conflict	Handle already taken, duplicate resource
422	Unprocessable	Validation failed — check field formats
429	Rate Limited	Too many requests. See Retry-After header
500	Server Error	Internal error — retry with backoff