# AxonGate

Name: AxonGate
Basename: axongate.base.eth
Summary: x402-paid Clean Context Broker that converts public web pages into clean markdown for RAG, research, and autonomous agents.
Canonical base URL: https://api.axongate.one
Human docs: https://api.axongate.one/docs
Operator dashboard: https://api.axongate.one/operator
Quickstart: https://api.axongate.one/quickstart
Paid smoke test guide: https://api.axongate.one/paid-test
Quote API: https://api.axongate.one/v1/x402/quote
Quote page: https://api.axongate.one/quote
Proof Pack page: https://api.axongate.one/proof-pack
Proof Pack sample page: https://api.axongate.one/proof-pack/sample
Proof Pack sample API: https://api.axongate.one/v1/proof-pack/sample
Proof Pack quote API: https://api.axongate.one/v1/proof-pack/quote
Proof Pack x402 endpoint: https://api.axongate.one/v1/x402/proof-pack
Interactive demo: https://api.axongate.one/demo
OpenAPI JSON: https://api.axongate.one/openapi.json
Swagger UI: https://api.axongate.one/swagger
Manifest: https://api.axongate.one/manifest.json
Agent card: https://api.axongate.one/.well-known/agent.json
Agent card alias: https://api.axongate.one/.well-known/agent-card.json
x402 discovery: https://api.axongate.one/.well-known/x402
x402 JSON alias: https://api.axongate.one/.well-known/x402.json
Resource listing: https://api.axongate.one/discovery/resources
Sitemap: https://api.axongate.one/sitemap.xml
Python client example: https://github.com/sauliusbeconis/AxonGate/blob/main/examples/python_client.py
cURL examples: https://github.com/sauliusbeconis/AxonGate/blob/main/examples/curl.md
Paid buyer example: https://github.com/sauliusbeconis/AxonGate/blob/main/examples/paid_buyer.mjs
MCP server example: https://github.com/sauliusbeconis/AxonGate/blob/main/examples/axongate_mcp.mjs
MCP guide: https://github.com/sauliusbeconis/AxonGate/blob/main/examples/mcp.md

## Payment

Protocol: x402
Network: Base mainnet, eip155:8453
Accepted asset: USDC, 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Vault address: 0xcD11393c8505C5A44F8b998E0c96BcC5698d76A7
Preferred payment header: PAYMENT-SIGNATURE
Legacy transaction hash header: X-AxonGate-Payment-Hash
Retry credit header: X-AxonGate-Retry-Credit
Source attribution header: X-AxonGate-Source
Facilitator: https://facilitator.payai.network

## Paid Endpoint

POST https://api.axongate.one/v1/x402/access
Content-Type: application/json
Body example:
{
  "target_url": "https://example.com/source",
  "tier": "fresh",
  "force_refresh": true
}

Tiers:
- starter: 0.012 USDC, starter sample or cache-only; no upstream fetch on miss
- cached: 0.015 USDC, cache-only; no upstream fetch on miss
- basic: 0.02 USDC, standard cache, 3600 seconds
- fresh: 0.03 USDC, bypass cache
- deep: 0.05 USDC, short cache, 1800 seconds
Recommended tier for uncached public web context: fresh
Use GET /v1/x402/quote?target_url=<url> before payment to receive supplier-free tier guidance and a ready buyer command.

Successful response shape:
- status: success
- target_url: requested source URL
- tier: resolved price tier
- markdown: cleaned markdown returned from the upstream reader
- cache: cache hit metadata
- payment: network, vault, token, and amount metadata
- ueg_receipt: revenue, dynamic gas, supplier cost, and projected margin

## Retry Endpoint

POST https://api.axongate.one/v1/x402/retry
Use only when AxonGate returns a retryable 503 with X-AxonGate-Retry-Credit after payment was accepted but upstream delivery failed.

## Proof Packs

GET https://api.axongate.one/proof-pack
GET https://api.axongate.one/proof-pack/sample
GET https://api.axongate.one/v1/proof-pack/sample
GET https://api.axongate.one/v1/proof-pack/quote?target_url=<url>&question=<question>&pack=quick|standard|deep
POST https://api.axongate.one/v1/x402/proof-pack?pack=standard
Header: X-AxonGate-Pack: standard
Body example:
{
  "target_url": "https://example.com/source",
  "question": "What does this source establish?",
  "pack": "standard",
  "force_refresh": false
}

Proof Pack prices:
- quick: 0.10 USDC, cache-friendly source read with deterministic fallback
- standard: 0.25 USDC, cache-aware source read with LLM-assisted evidence synthesis when configured
- deep: 1.00 USDC, deep evidence pack with short-cache source material and fresh-by-default refresh

Successful Proof Pack response shape:
- status: success
- target_url, question, pack
- answer and executive_summary
- confidence_score
- key_claims with citation_ids
- citations with source excerpts
- risks
- source_profile with final_url and content_sha256
- cache, payment, and ueg_receipt metadata

## Safety And Supply Guards

AxonGate rejects private, loopback, multicast, and link-local target hosts; performs DNS and redirect preflight checks; enforces allowed target ports; caps supplier content size; rate-limits probes, unpaid requests, paid requests, retry credits, and target domains; and runs a dynamic Unit Economic Guardian before supplier work. Bad upstream supply should not be charged to AxonGate beyond the bounded retry credit policy.