# Xenarch

## Docs

- [Access Tokens](https://docs.xenarch.com/api-reference/access-tokens.md): Verify x402 access tokens issued after USDC payment — bearer token validation, expiration, and gate-scoped authorization for AI agents.
- [Get Agent Profile](https://docs.xenarch.com/api-reference/agents/get-profile.md): Get the authenticated AI agent profile by wallet address — returns registration details, USDC balance, and x402 payment history summary.
- [Register Agent](https://docs.xenarch.com/api-reference/agents/register.md): Register an AI agent with Xenarch by wallet address — one-time registration for agents making USDC micropayments via the x402 protocol.
- [Authentication](https://docs.xenarch.com/api-reference/authentication.md): Xenarch API authentication — API key, site token, and wallet address auth methods for publishers and AI agents on the x402 payment API.
- [Create Gate](https://docs.xenarch.com/api-reference/gates/create.md): Create an x402 payment gate session — returns HTTP 402 with payment instructions. The core API call for charging AI agents for content access.
- [Get Domain Gate](https://docs.xenarch.com/api-reference/gates/get-domain.md): Get active x402 gate configuration for a domain — returns pay-per-crawl pricing rules, payment gate settings, and publisher access controls.
- [Get Gate Status](https://docs.xenarch.com/api-reference/gates/get-status.md): Check the status of an x402 payment gate — verify if payment required, received, or an access token has already been issued for this gate.
- [Verify Payment](https://docs.xenarch.com/api-reference/gates/verify-payment.md): Submit an on-chain transaction hash to verify x402 USDC payment on Base and receive a time-limited bearer access token for gated content.
- [API Overview](https://docs.xenarch.com/api-reference/overview.md): x402 REST API reference — payment gates, USDC micropayments on Base, publisher registration, and AI agent management. Complete x402 API docs.
- [Payment History](https://docs.xenarch.com/api-reference/payments/history.md): Get x402 payment history for a wallet address — paginated USDC transactions on Base with gate URLs, amounts, and timestamps per payment.
- [Get Profile](https://docs.xenarch.com/api-reference/publishers/get-profile.md): Get the authenticated Xenarch publisher profile — returns publisher details, payout wallet, registered sites, and x402 pay-per-crawl configuration.
- [Login](https://docs.xenarch.com/api-reference/publishers/login.md): Authenticate as a Xenarch publisher and rotate API key — receive a new key that invalidates the previous one. Rate-limited 5 requests per minute per IP.
- [Register Publisher](https://docs.xenarch.com/api-reference/publishers/register.md): Create a new Xenarch publisher account — the entry point for charging AI bots with x402 USDC micropayments and setting pay-per-crawl pricing.
- [Update Payout Wallet](https://docs.xenarch.com/api-reference/publishers/update-payout.md): Update the publisher's USDC payout wallet address — all future x402 pay-per-crawl payments for this publisher will route to the new wallet on Base.
- [Create Service](https://docs.xenarch.com/api-reference/services/create.md): Register a discoverable x402 service on Xenarch — make your API or data accessible to AI agents with machine-readable pricing and USDC gates.
- [List Services](https://docs.xenarch.com/api-reference/services/list.md): List all active x402 services on Xenarch — a discovery endpoint for AI agents looking for paid APIs, data feeds, and content services.
- [Search Services](https://docs.xenarch.com/api-reference/services/search.md): Search x402 services by category, keyword, or price range — agent-facing discovery endpoint for finding paid APIs and gated content.
- [Create Site](https://docs.xenarch.com/api-reference/sites/create.md): Register a new site (domain) under the publisher account — first step to enable x402 pay-per-crawl with USDC micropayments for AI agents.
- [Get Stats](https://docs.xenarch.com/api-reference/sites/get-stats.md): Revenue analytics for a Xenarch publisher site — top pages, top paying agents, and time-bucketed USDC earnings from x402 pay-per-crawl.
- [Get Transactions](https://docs.xenarch.com/api-reference/sites/get-transactions.md): Paginated x402 USDC transaction history for a publisher site — agent wallet, amount, timestamp, and gate URL per on-chain transaction.
- [List Sites](https://docs.xenarch.com/api-reference/sites/list.md): List all sites belonging to the authenticated Xenarch publisher — returns domain, pay-per-crawl pricing rules, and revenue summary per site.
- [Update Pricing](https://docs.xenarch.com/api-reference/sites/update-pricing.md): Update x402 pay-per-crawl pricing for a site — set the default USDC price and path-specific pricing rules for AI agent content access.
- [Smart Contract](https://docs.xenarch.com/contract/overview.md): XenarchSplitter smart contract — non-custodial USDC payment splitter on Base L2 for x402 micropayments. Verifiable on Basescan, 0% fee.
- [Contract Reference](https://docs.xenarch.com/contract/reference.md): XenarchSplitter Solidity interface — functions, events, and constants for the non-custodial x402 USDC payment splitter contract on Base L2.
- [CrewAI Agent](https://docs.xenarch.com/examples/crewai-agent.md): CrewAI agent example — a research crew that pays for x402-gated content with USDC micropayments on Base using Xenarch payment tools.
- [FastAPI Publisher](https://docs.xenarch.com/examples/fastapi-publisher.md): FastAPI publisher example — gate AI agents behind x402 USDC payments in a FastAPI app with pay-per-crawl middleware and bot detection.
- [LangChain Agent](https://docs.xenarch.com/examples/langchain-agent.md): Autonomous LangChain agent example — uses Xenarch payment tools to pay for x402-gated content with USDC micropayments on Base.
- [MCP (Claude Desktop & Code)](https://docs.xenarch.com/examples/mcp-claude.md): Claude Desktop MCP example — add Xenarch x402 payment tools to Claude with zero code. Auto-checks payment gates and pays in USDC on Base.
- [Examples](https://docs.xenarch.com/examples/overview.md): Working x402 code examples — Python agents, LangChain, CrewAI, MCP with Claude Desktop, FastAPI publishers. Copy-paste ready for USDC micropayments.
- [Python Agent](https://docs.xenarch.com/examples/python-agent.md): Minimal Python x402 agent example — check the payment gate, pay a USDC micropayment on Base, and fetch gated content. Copy-paste ready.
- [How It Works](https://docs.xenarch.com/how-it-works.md): How x402 resolves HTTP 402 — complete AI agent payment flow from 402 status code detection to USDC settlement on Base L2. x402 protocol guide.
- [CrewAI](https://docs.xenarch.com/integrations/crewai.md): CrewAI payment tools — let CrewAI crews pay for x402-gated content with USDC micropayments on Base. MCP-compatible drop-in tools.
- [FastAPI Middleware](https://docs.xenarch.com/integrations/fastapi-middleware.md): FastAPI payment middleware — gate AI agents behind x402 USDC micropayments on Base. ASGI-compatible, drop-in pay-per-crawl for Python APIs.
- [Joomla](https://docs.xenarch.com/integrations/joomla.md): Joomla pay-per-crawl extension with AI bot detection — charge AI crawlers with USDC micropayments on Base. Full admin dashboard, non-custodial.
- [LangChain](https://docs.xenarch.com/integrations/langchain.md): LangChain payment tools — let LangChain agents pay for x402-gated content with USDC micropayments. MCP-compatible. Drop-in tool integration.
- [Integrations](https://docs.xenarch.com/integrations/overview.md): Connect Xenarch to your stack — pay-per-crawl plugins (WordPress, Joomla), agent frameworks (LangChain, CrewAI), web frameworks (FastAPI), and standards.
- [pay.json](https://docs.xenarch.com/integrations/pay-json.md): pay.json — open machine-readable pricing standard for AI agents. Served at /.well-known/pay.json. Like robots.txt but for x402 payments.
- [WordPress](https://docs.xenarch.com/integrations/wordpress.md): WordPress pay-per-crawl plugin with AI bot detection — charge AI crawlers with USDC micropayments. Non-custodial Cloudflare pay-per-crawl alternative.
- [Introduction](https://docs.xenarch.com/introduction.md): x402 payment infrastructure for AI agents — route USDC micropayments between AI bots and publishers on Base L2. Non-custodial, 0% fee, pay-per-crawl.
- [Install MCP Server (Claude Desktop & Code)](https://docs.xenarch.com/mcp/installation.md): Install the Xenarch MCP server for Claude Desktop, Claude Code, Cursor, or any Model Context Protocol client. One-command npx setup in under 2 minutes.
- [MCP Server](https://docs.xenarch.com/mcp/overview.md): Xenarch MCP server — Model Context Protocol server for Claude, Anthropic & MCP clients. Let AI agents check x402 payment gates and pay in USDC on Base.
- [MCP Tools Reference](https://docs.xenarch.com/mcp/tools.md): Reference for the three Xenarch MCP server tools — check x402 payment gates, pay USDC micropayments on Base, and query agent payment history.
- [Agent Quickstart](https://docs.xenarch.com/quickstart-agent.md): AI agent payments quickstart — pay for x402-gated content with USDC micropayments in 5 minutes using the Xenarch MCP server or Python SDK.
- [Publisher Quickstart](https://docs.xenarch.com/quickstart-publisher.md): Start charging AI bots for content access — pay-per-crawl setup with USDC micropayments in 5 minutes. Non-custodial Cloudflare pay-per-crawl alternative.
- [CLI](https://docs.xenarch.com/sdks/cli.md): xenarch CLI — command-line tool for AI agents and publishers to manage x402 payment gates, USDC payments on Base, and pay-per-crawl pricing.
- [Python SDK](https://docs.xenarch.com/sdks/python.md): xenarch Python package — x402 agent payments, FastAPI publisher middleware, and AI bot detection. Pip install xenarch[agent] or xenarch[fastapi].
- [TypeScript SDK](https://docs.xenarch.com/sdks/typescript.md): @xenarch/core — TypeScript & Node.js SDK for x402 payments, AI agent integration, and publisher middleware. USDC micropayments on Base.

## OpenAPI Specs

- [openapi](https://docs.xenarch.com/openapi.json)