How do AI agents pay for APIs on Proxagora?

Agents pay per call using x402 micropayments (USDC on Base blockchain) or Stripe Micropayment Protocol (MPP). No signup or API key required — the payment header is the authentication.

x402 is the HTTP 402 'Payment Required' status code repurposed for machine-to-machine micropayments. An agent receives a 402 response, constructs a USDC payment on Base, and retries with an X-Payment header.

How do I publish an API on Proxagora?

Developers can publish APIs at proxagora.com/dashboard/publish. Proxagora handles payment collection and takes a 22% platform fee, with weekly payouts via Stripe Connect Express.

docs/quick-start

Quick Start

Get started with Proxagora in minutes. No signup required — just discover, call, and pay.

⚡

Three primitives

Discover the API catalog → Call an endpoint (get 402 back) → Pay via x402 or Stripe MPP header

Discover the API catalog

Fetch the full catalog to see available APIs, their descriptions, categories, and per-call costs in USDC.

bash

curl https://proxagora.com/api/discover

Response — an array of API listings:

json

{
  "apis": [
    {
      "id": "ip-geo",
      "name": "IP Geolocation",
      "category": "Network",
      "cost_usdc": 0.001,
      "endpoint": "/api/ip-geo",
      "description": "Resolve an IP address to city, country, ASN."
    },
    ...
  ],
  "total": 22
}

Call an API endpoint

POST to the endpoint with your parameters. Without payment, you'll receive an HTTP 402 Payment Required response with payment instructions.

bash

curl -X POST https://proxagora.com/api/ip-geo \
  -H "Content-Type: application/json" \
  -d '{"ip": "8.8.8.8"}'

The 402 response tells you what payment is needed:

json

{
  "error": "Payment required",
  "x402": {
    "amount": "0.001",
    "currency": "USDC",
    "network": "base",
    "payTo": "0xProxagoraVault..."
  }
}

Attach payment and retry

Include a signed payment proof in the X-Payment header (x402 on Base) or X-MPP-Payment (Stripe MPP). The API validates on-chain or via Stripe and returns the data.

bash

# x402 (USDC on Base) — for autonomous agents
curl -X POST https://proxagora.com/api/ip-geo \
  -H "Content-Type: application/json" \
  -H "X-Payment: <base64-encoded-eip712-signature>" \
  -d '{"ip": "8.8.8.8"}'

# Stripe MPP — for developer testing
curl -X POST https://proxagora.com/api/ip-geo \
  -H "Content-Type: application/json" \
  -H "X-MPP-Payment: <stripe-payment-token>" \
  -d '{"ip": "8.8.8.8"}'

Successful response:

json

{
  "ip": "8.8.8.8",
  "city": "Mountain View",
  "country": "United States",
  "country_code": "US",
  "latitude": 37.4056,
  "longitude": -122.0775,
  "asn": "AS15169",
  "org": "Google LLC"
}