# x402 Meta Gateway — AI Intelligence API

> AI-synthesized crypto trading intelligence for autonomous agents. Pay per query with USDC micropayments via x402 protocol. No API keys. No subscriptions. Endpoints include Twitter/X data when available.

## Endpoints (USDC micropayments via x402)

- [/alpha/token](https://x402.911fund.io/alpha/token): Token intelligence — DexScreener + CoinGecko + Twitter + Grok AI. $0.03 USDC.
- [/alpha/trending](https://x402.911fund.io/alpha/trending): Trending tokens with Twitter analysis + AI narrative detection. $0.03 USDC.
- [/alpha/sentiment](https://x402.911fund.io/alpha/sentiment): up to 99 tweets with full engagement metrics (likes, views, retweets, followers) + Grok bull/bear scoring. $0.05 USDC.
- [/alpha/search](https://x402.911fund.io/alpha/search): Neural web search + Twitter + AI synthesis (Exa + Grok). $0.03 USDC.
- [/alpha/deep](https://x402.911fund.io/alpha/deep): Deep multi-source research — Exa + Firecrawl + Claude + up to 99 tweets. Up to 60s. $0.10 USDC.
- [/alpha/prediction](https://x402.911fund.io/alpha/prediction): Prediction market intelligence (Polymarket + Kalshi + Twitter + Grok). $0.03 USDC.
- [/alpha/macro](https://x402.911fund.io/alpha/macro): Macro economic pulse (FRED + prediction markets + Twitter + Grok). $0.05 USDC.
- [/alpha/news](https://x402.911fund.io/alpha/news): AI-filtered crypto news from CoinTelegraph, Decrypt, CoinDesk, Blockworks + X. $0.02 USDC.

## MCP Server

- [MCP Endpoint](https://x402.911fund.io/mcp): POST, Streamable HTTP transport. All 8 tools available. Payment via X-PAYMENT header.

## Payment

- Protocol: x402 (HTTP 402 Payment Required)
- Token: USDC
- Chains: Base (EVM), Solana (SVM), Ethereum (EVM)
- SDK: [@x402/fetch](https://github.com/coinbase/x402) for TypeScript/EVM

## Agent Configuration

```json
{
  "mcpServers": {
    "x402-alpha": {
      "url": "https://x402.911fund.io/mcp",
      "transport": "streamable-http"
    }
  }
}
```

## Trust Semantics

- `400 invalid_params`: malformed or missing required input. No charge.
- `422 needs_clarification`: input too short/ambiguous for reliable routing. No charge.
- `402 Payment Required`: valid request shape, payment needed before execution.
- `preview=true` (REST) or `preview: true` (MCP args): estimate only, no charge.
- Payment authorizes a compute attempt, not guaranteed upstream availability.
- `/alpha/sentiment` requires Twitter and may return `503 upstream_failed` when Twitter is unavailable.
- Other endpoints may still return `200` with `warnings:["twitter_unavailable"]` if X/Twitter data is missing.

## Query Quality

Prefer specific requests with asset + topic + context/time window:
- `/alpha/search?query=Jupiter+DEX+Solana+fee+switch+timeline+2026`
- `/alpha/deep?query=Base+L2+sequencer+decentralization+roadmap+2026`
- `/alpha/prediction?query=fed+rate+cut+by+June+2026&category=economics`

Avoid low-signal prompts such as `hi`, `test`, or one-word ambiguous topics.

### Endpoint Playbook (Compact)
- `/alpha/token`: `?symbol=SOL` (or `?address=0x...`)
- `/alpha/trending`: no query required (optional `category`)
- `/alpha/sentiment`: `?query=JUP+unlock+impact`
- `/alpha/search`: `?query=Solana+DEX+fee+switch+timeline+2026`
- `/alpha/deep`: `?query=Base+L2+sequencer+decentralization+roadmap+2026`
- `/alpha/prediction`: `?query=fed+rate+cut+June+2026&category=economics`
- `/alpha/macro`: `?theme=inflation`
- `/alpha/news`: `?query=bitcoin+ETF+flows&category=coindesk`

## Optional

- [Full API Documentation](https://x402.911fund.io/llms-full.txt): Complete parameter docs, response schemas, and examples.
- [Machine-Readable Discovery](https://x402.911fund.io/.well-known/x402.json): x402 payment discovery JSON.
- [API Docs on GitHub](https://github.com/the911fund/x402-docs): README with payment flow details and code examples.
- [x402scan Listing](https://www.x402scan.com/server/6b9891e8-6939-4c9c-842f-9658f99cb6f3): Server listing on x402scan directory.

## Runtime Contract Updates (2026-02-18)

- Discovery (`/.well-known/x402.json`) resources now include: `resource`, `tags`, `serviceTags`, `inputSchema`, `outputSchema`, `examples`, and `accepts[]` payment metadata.
- `/stats` includes `paymentConversion` (paid execution/failure conversion metrics) and `latency` rolling quantiles (`p50_ms`, `p95_ms`, `p99_ms`, `max_ms`) overall and per endpoint.
- REST errors include top-level `request_id` and `error.action` for deterministic client handling.
- Missing required input should return `422 needs_clarification` before charge.