Greenhead Labs

Public pay-per-call XRPL data and Grok AI. No accounts, JWT, or sessions. Pay XRP or RLUSD on XRPL mainnet (xrpl:0), then retry with X-Payment-Txid set to the validated Payment hash.

Free

• /.well-known/x402 — x402 service catalog: endpoint names, descriptions, XRP/RLUSD prices, and payTo.
• /docs — Human-readable API documentation with JSON-LD for crawlers.
• /docs.md — Markdown documentation for agents (llms.txt v2 alternate).
• /llms.txt — Curated agent index of discovery files and paid endpoints (llmstxt.org v2).
• /llms-full.txt — Full markdown catalog: payment flow, every endpoint, query/body fields, curl examples.
• /agents.txt — Agent capability announcement: Protocols: x402 (agents-txt.com).
• /agents.json — Structured agent catalog: x402 on xrpl:0, default pricing, no wallet addresses.
• /openapi.json — OpenAPI 3.0 of free discovery routes and paid XRPL/AI endpoints.
• /skills/x402/SKILL.md — Agent skill: how to discover, pay, and call this API.
• /status — Readiness JSON: network, XRPL RPC reachability, uptime, recent settle ok/fail counters, version.

Paid

• GET /v1/xrpl/settlement — 75000 drops. Paid XRPL Payment attestation by query txid. Distinct from free GET /v1/receipts/:txid. Fail-closed: invalid, missing, unvalidated, or non-Payment hashes return 4xx without redeeming X-Payment-Txid. 75,000 drops (0.075 XRP).
• GET /v1/xrpl/token — 10000 drops. Token info for an XRPL issued currency: issuer details, DEX/AMM price in XRP, holder metrics, and liquidity.
• GET /v1/xrpl/listings — 2000 drops. Recent XRPL token launches from GeckoTerminal / First Ledger, sorted by launch date descending.
• GET /v1/xrpl/orderbook — 10000 drops. XRPL DEX order book for a currency pair (bids and asks, plus mid price).
• GET /v1/xrpl/portfolio — 20000 drops. Wallet token holdings on XRPL, including XRP balance and estimated XRP values.
• POST /v1/ai/chat — 50000 drops. Grok chat completions (model grok-3-mini) via https://api.x.ai/v1/chat/completions. Requires GROK_API_KEY.
• POST /v1/xrpl/amm-score — 50000 drops. Fetch AMM pool data, then score pool quality 0-100 via Grok (grok-3-mini) for a sniper bot.
• GET /v1/xrpl/trending — 50000 drops. Top 10 XRPL tokens by 24h volume from xrpl.to.
• POST /v1/ai/trade-advice — 50000 drops. XRPL buy/skip/watch advice via Grok chat completions (grok-3-mini).
• POST /v1/ai/risk-score — 50000 drops. Fetch XRPL token data, then score risk 0-100 via Grok (grok-3-mini).
• POST /v1/ai/sentiment — 50000 drops. Sentiment as positive/neutral/negative with a 0-100 confidence score via Grok (grok-3-mini).
• POST /v1/ai/grok — 50000 drops. Grok text via the xAI Responses API (default model grok-4.6). Requires GROK_API_KEY.
• POST /v1/ai/image — 50000 drops. Generate an image with Grok Imagine. Requires GROK_API_KEY.
• POST /v1/ai/video — 50000 drops. Start a Grok Imagine video generation. Requires GROK_API_KEY.
• GET /v1/ai/video — 50000 drops. Poll a Grok Imagine video job by request_id. Requires GROK_API_KEY.
• POST /v1/ai/tts — 50000 drops. Grok text-to-speech. Returns audio. Requires GROK_API_KEY.
• POST /v1/xrpl/wallet-score — 2000 drops. Wallet trust/risk score 0-100 from XRPL age, tx count, trust lines, and balance via Grok. 2000 drops.
• POST /v1/xrpl/token-risk — 2000 drops. Rug-pull probability from AMM liquidity, holder concentration, and issuer trust lines via Grok. 2000 drops.
• POST /v1/grok/market-summary — 3000 drops. Plain-English XRPL daily market digest from the top 10 GeckoTerminal pools via Grok. 3000 drops. Body optional.
• GET /v1/base/ping — 2000 drops. Prove route for Base mainnet USDC x402 (eip155:8453). HTTP 200 after facilitator verify+settle. Priced as the cheapest SKU (0.002 face → 2000 USDC atomic when Base is enabled).