# AgentTX Agent Sandbox

Register an Agent, store the returned secret once, and submit a spend intent. This sandbox never moves funds.

## 1. Register

POST https://api.agenttx.cc/v1/pilot/agents
Content-Type: application/json

{"name":"my-research-agent","externalAgentId":"your-stable-agent-id","framework":"langgraph"}

The response contains an atx_pilot_ secret exactly once. Never expose it to an LLM, webpage, log, or repository.

## 2. Propose a sandbox spend

POST https://api.agenttx.cc/v1/pilot/spend-intents
Authorization: Bearer <secret>
Content-Type: application/json
Idempotency-Key: <unique-8-to-128-character-key>

{"merchant":"data.agenttx.cc","amount":2.4,"category":"data","purpose":"market research","resourceUrl":"https://data.agenttx.cc/sample","taskId":"task-001","riskScore":10}

Trusted data requests up to 5 sandbox USDC return ALLOW. Unknown merchants return REQUIRE_APPROVAL. Requests over 5, outside category data, or with riskScore >= 80 return DENY. No response executes payment.

## 3. Verify activation

GET https://api.agenttx.cc/v1/pilot/agents/me
Authorization: Bearer <secret>

Aggregate phase-one evidence: https://api.agenttx.cc/v1/pilot/stats
Anonymous Policy Lab proofs: https://api.agenttx.cc/v1/pilot/evidence
OpenAPI discovery: https://api.agenttx.cc/openapi.json