Skip to main content
POST
/
v1
/
agents
curl -X POST https://xenarch.dev/v1/agents \
  -H "Content-Type: application/json" \
  -d '{"wallet_address": "0x1234...abcd", "name": "my-research-agent"}'

{
  "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
  "wallet_address": "0x1234...abcd",
  "name": "my-research-agent",
  "created_at": "2026-04-10T14:00:00Z"
}

curl -X POST https://xenarch.dev/v1/agents \
  -H "Content-Type: application/json" \
  -d '{"wallet_address": "0x1234...abcd", "name": "my-research-agent"}'

{
  "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
  "wallet_address": "0x1234...abcd",
  "name": "my-research-agent",
  "created_at": "2026-04-10T14:00:00Z"
}

​
Notes

  • Registration is optional — agents can pay without registering
  • Registering lets agents have a named profile and be discoverable
  • name is optional

Body

application/json
​
wallet_address
string
required
Pattern: ^0x[0-9a-fA-F]{40}$
​
name
string | null
Maximum string length: 100

Response

Successful Response

​
id
string<uuid>
required
​
wallet_address
string
required
​
name
string | null
required
​
created_at
string<date-time>
required