AGENT INTEGRATION / V0.1 SANDBOX

From question to structured evidence.

Stable English JSON fields. Automatically generated test credentials. Persistent receipts. No real payment in this release.

The API is in test mode. A simulated budget does not authorize any crypto debit. Commercial calls explicitly return unavailable until payment collection is enabled.

Start with Spend Proof

Your browser computes a free report without an account. The API and audit_agent_costs MCP tool require an active agent key but do not charge for the audit. Supply opaque identifiers, complete costs and your success criteria; exclude prompts, names, emails and secrets.

POST /api/v1/spend-proof
Authorization: Bearer YOUR_AGENT_KEY
Content-Type: application/json

{"runs":[
  {"task_id":"task-01","workflow":"research","variant":"baseline","cost_usd":0.04,"success":true},
  {"task_id":"task-01","workflow":"research","variant":"candidate","cost_usd":0.025,"success":true}
]}

Limits: 1,000 rows, 512,000 bytes. A comparison needs at least 30 distinct tasks per version with matching identifiers. Results depend on supplied data; no realized savings are claimed.

Open the free audit Python client and full contract

01 / Discover

The catalog and sample are public and free. Your private customer workspace requires sign-in.

GET /api/v1/catalog
GET /api/v1/sample
GET /openapi.json
POST /api/mcp

Open sample OpenAPI 3.1

02 / Authorize

Activate your agent key automatically on the enrollment page. Each signed-in account receives a simulated 1 USDC budget. The operator can also issue keys. Only key hashes are stored; revocation takes effect on the next request.

Activate my test access

03 / Test a purchase

Product

Sandbox agent key

Get a generated key from Activate my test access, then paste the complete key here. Do not enter a wallet address or invent a key. Get my test key

Retrying an identical purchase returns the same receipt without a second budget debit.

REST / request contract

NO PRIVATE WALLET KEY REQUIRED

GET /api/v1/snapshot
Authorization: Bearer YOUR_SANDBOX_AGENT_KEY
X-ALPNAI-Mode: sandbox
Idempotency-Key: purchase_20260914_001

# Change Set accepts ?since=YYYY-MM-DD
# All dates refer to a curated source collection, not exhaustive real-time coverage.

MCP / tools

Streamable HTTP endpoint: /api/mcp . Protocol version and capabilities are supplied by the installed official SDK. Free tools discover the collection; purchase tools use the same server-side agent authorization and budget checks as REST.

Spend Proof · POST /api/v1/spend-proof · audit_agent_costs · Free / Gratuit / Kostenlos

get_catalog — product schemas and prices
get_free_sample — dated evidence sample
purchase_snapshot — sandbox purchase
purchase_changes — events since a date
purchase_evidence — structured source dossier

Pass idempotency_key in purchase arguments and your agent key in the Authorization header. No OAuth buyer onboarding or production x402 settlement is enabled yet.

Failure states are part of the product.

400

Invalid input or idempotency key

401

Missing, unknown or revoked agent credential

403

Budget exhausted or forbidden origin

409

Same purchase ID, different parameters

503

Storage unavailable or real payments disabled

Evidence boundaries & license

The current collection includes two normalized facts from the 8 June 2026 issuer announcement. Unknown dates, ticker and offer price remain null. Change Set filters events in that collection after the requested date; it does not yet compare arbitrary historical snapshots. Evidence Pack adds methodology and limitations. Sources are linked, not republished in full. Internal use and factual synthesis with attribution are proposed; bulk redistribution is excluded.

Terms and contact