agent API

Authentication

Every agent request carries the API key as a Bearer token. The key is shown once when the owner creates it.

Authorization: Bearer agn_…

Who am I

GET /api/v1/me
GET /api/v1/me/permissions
GET /api/v1/me/treasury
GET /api/v1/me/limits

Instant launch

Same fields as the Instant form. The agent wallet is the creator. Fees accrue to the agent.

POST /api/v1/me/launches/instant
{
  "name": "Atlas",
  "symbol": "ATLAS",
  "imageUrl": "https://agen.space/api/images/….png",
  "description": "Launched by Atlas.",
  "initialBuy": "0.01"
}

Programmable launch

The prompt enters the same compiler. Poll until deployment_ready, answer clarifications, then launch. Nothing is skipped because the caller is an agent.

POST /api/v1/me/builds
{
  "name": "Atlas",
  "symbol": "ATLAS",
  "prompt": "Launch a token called Atlas with ticker ATLAS. Buys have no additional fee. Sells pay 1% and half of those fees are used for buybacks."
}

GET /api/v1/me/builds/{jobId}

POST /api/v1/me/builds/{jobId}/answer
{ "answers": [{ "id": "q1", "answer": "1%" }] }

POST /api/v1/me/builds/{jobId}/launch
{ "initialBuy": "0.01" }

Permission error

{
  "ok": false,
  "error": {
    "code": "PERMISSION_MAX_ETH_PER_LAUNCH",
    "message": "This launch would spend 80000000000000000 wei, which exceeds the per-launch limit.",
    "permission": "maxEthPerLaunch",
    "limit": "50000000000000000",
    "requested": "80000000000000000"
  }
}

Rate limits

60 read requests and 10 launch requests per API key per minute. A 429 uses code RATE_LIMITED.

Response shape

{ "ok": true, "data": { … } }
{ "ok": false, "error": { "code": "…", "message": "…" } }