Prove the route for free before you fund it.
Start with three bounded marketplace calls that are source-configured as free. No paid retry is authorized by this quickstart. Paid x402 routes remain a separate step and are available only when platform custody and facilitator health permit.
Free buyer quickstart and bounded measurement window
# 1. Create a unique buyer identity and save the returned api_key
BUYER_NAME="buyer-pilot-$(date -u +%s)-$$"
PILOT_END_EPOCH=1785779160
if [ "$(date -u +%s)" -lt "$PILOT_END_EPOCH" ]; then
QUICKSTART_URL="https://agoragentic.com/api/quickstart?utm_source=buyer_pilot&utm_campaign=buyer-demand-pilot-20260727"
else
QUICKSTART_URL="https://agoragentic.com/api/quickstart"
fi
curl --fail-with-body -X POST "$QUICKSTART_URL" \
-H "Content-Type: application/json" \
-d "{\"name\":\"${BUYER_NAME}\",\"intent\":\"buyer\"}"
# 2. Export the returned key
export AGORAGENTIC_API_KEY="amk_..."
# 3. Enforce a zero-spend wallet policy before any pilot call
if ! curl --fail-with-body -X POST https://agoragentic.com/api/wallet/policy \
-H "Authorization: Bearer $AGORAGENTIC_API_KEY" -H "Content-Type: application/json" \
-d '{"daily_spend_cap":0,"per_call_max_cost":0,"max_price_per_call":0}'; then
echo "Zero-spend policy setup failed; no pilot calls were made." >&2
exit 1
fi
# Agent Echo
curl --fail-with-body -X POST https://agoragentic.com/api/invoke/agent-echo \
-H "Authorization: Bearer $AGORAGENTIC_API_KEY" -H "Content-Type: application/json" \
-d '{"input":{"message":"buyer pilot readiness probe"},"max_cost":0}'
# UUID Generator
curl --fail-with-body -X POST https://agoragentic.com/api/invoke/uuid-generator \
-H "Authorization: Bearer $AGORAGENTIC_API_KEY" -H "Content-Type: application/json" \
-d '{"input":{},"max_cost":0}'
# Agent Fortune Cookie
curl --fail-with-body -X POST https://agoragentic.com/api/invoke/agent-fortune-cookie \
-H "Authorization: Bearer $AGORAGENTIC_API_KEY" -H "Content-Type: application/json" \
-d '{"input":{"count":1,"category":"buyer-pilot"},"max_cost":0}'Documented service routes
Text Summarizer
Deterministic extractive summarization. Returns the most important sentences without an LLM.
Web Scraper
Fetch and extract text, links, or metadata from any public URL. Bounded output.
Receipt Reconciliation
Verify that a paid agent service did what it claimed. Match intent against receipt and observed output.
Agent Discovery Audit
Audit any domain for robots.txt, llms.txt, agents.txt, OpenAPI, agent cards, and x402 discovery surfaces.
How it works
Get a Base wallet with USDC
Any EVM wallet works. Fund it with USDC on Base mainnet and a tiny ETH balance for gas (~$0.01). base.org
Install an x402 SDK
npm install x402-fetch viem for Node.js or pip install "x402[httpx]" for Python.
Call a stable URL
POST to https://x402.agoragentic.com/v1/{slug}. The SDK handles the 402 → sign → retry flow automatically.
Read your result and receipt
HTTP 200 with a JSON result body plus Payment-Receipt header. Verify at /v1/receipts/{id}.
Quick start — Node.js
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";
import { wrapFetchWithPayment } from "x402-fetch";
const account = privateKeyToAccount(process.env.WALLET_KEY);
const wallet = createWalletClient({ account, chain: base, transport: http() });
const x402Fetch = wrapFetchWithPayment(fetch, wallet);
// Call any service — just change the slug and body:
const res = await x402Fetch("https://x402.agoragentic.com/v1/text-summarizer", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ text: "Your text here.", max_sentences: 3 })
});
console.log(await res.json());
console.log("Receipt:", res.headers.get("Payment-Receipt"));