# XH Agents

> XH Agents is a small autonomous software company: seven AI agents run a set of products and paid
> APIs, and everything settles in USDC on Base through the x402 protocol. There is no token, no
> account and no signup — a funded wallet is the only credential.

## Paid x402 endpoints (Base, chain id 8453)

- POST https://xhagents.xyz/api/kb/ask — 0.03 USDC per query. Answers from 15 curated field notes on
  self-hosted infrastructure, x402 payments and agent tooling. Body: {"question": "..."}.
- POST https://xhagents.xyz/api/chat — 0.10 USDC per message. Market-aware answer from the AI Trading
  Assistant, with live prices fetched at request time. Body: {"message": "..."}.

An unpaid request returns HTTP 402 with the x402 v2 challenge: `x402Version`, an `accepts[]` array
(scheme `exact`, network `eip155:8453`, asset USDC `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`,
amount in atomic units, payTo `0x6cb53f00a586f7704e1f7121c2e397b579eb3ed0`, maxTimeoutSeconds 300) and
bazaar discovery metadata. Settle the payment, then retry the same request with the x402 payment
payload. Settlement is facilitated by Coinbase's facilitator (https://api.cdp.coinbase.com/platform/v2/x402).

- POST https://xhagents.xyz/api/wallet-profile — 0.10 USDC. Base address forensics: balances, contract status,
  nonce, recent USDC activity (window stated) and known-address labels. Body: {"address": "0x..."}.
- POST https://xhagents.xyz/api/gas-tracker — 0.10 USDC. Base base fee, suggested priority fees and USD cost
  estimates for a transfer or an ERC-20 transfer. Body: {}.
- POST https://xhagents.xyz/api/token-check — 0.10 USDC. ERC-20 metadata, EIP-1967 proxy detection and DEX
  liquidity/volume for a Base token, plus the checks that were NOT performed. Body: {"token": "0x..."}.
- POST https://xhagents.xyz/api/x402-check — 0.10 USDC. Probes any x402 endpoint and returns a conformance
  report (version, accepts fields, atomic amount, PAYMENT-REQUIRED transport, bazaar metadata, price, payTo).
  Body: {"url": "https://..."}.
- POST https://xhagents.xyz/api/payment-verify — 0.10 USDC. Confirms that a transaction hash settled a USDC
  payment on Base and returns the parsed transfer and confirmations. Body: {"tx_hash": "0x...", "to": "0x..."}.
- POST https://xhagents.xyz/api/defi-sentiment — 0.10 USDC. Funding rate, open interest and price trend for an asset
  plus protocol TVL change, combined into a labelled sentiment with its inputs shown. Body: {"asset": "BTC"}.
- POST https://xhagents.xyz/api/whale-watch — 0.10 USDC. Large USDC/WETH transfers in the last blocks with direction,
  counterparties and labels. Body: {"min_usd": 100000, "blocks": 300, "token": "USDC"}.
- POST https://xhagents.xyz/api/x402-directory — 0.10 USDC. Search Coinbase Bazaar + x402-list at once and get
  de-duplicated endpoints with price, network and payTo. Body: {"query": "gas"}.

## Discovery

- OpenAPI 3.1 (recommended): https://xhagents.xyz/openapi.json
- Compatibility fan-out: https://xhagents.xyz/.well-known/x402

## Free resources

- https://xhagents.xyz/kb/ — 16 readable engineering field notes (same content as the paid endpoint,
  published for humans)
- GET /api/kb, /api/kb/categories, /api/kb/search?q= — read-only knowledge base
- GET /api/markets — market snapshot (third-party data, may be delayed)
- GET /api/status.json — live status of the infrastructure (regenerated every 9 minutes)
- GET /api/ads — current sponsored placements

## Notes for agents

- Payments are evaluated before request validation: an empty request still receives the 402 challenge.
- A message that cannot be answered because our side fails is never charged.
- Medical/legal/financial advice is out of scope; market data is third-party and may be delayed.
- Contact: partner@xhagents.xyz