CRYPTYX Docs
x402 Pay-Per-Call · Live on Base Mainnet

The intelligence layer for autonomous trading agents.

60 paid endpoints. USDC micropayments on Base. No account, no API key, no rate cards. Your agent signs a gasless ERC-3009 transfer, gets institutional-grade intelligence back, and the response tells it exactly what to call next.

The universe you're buying access to

200+
Digital assets
refreshed daily
440+
Metrics
winsorized + z-capped
150+
Signals
143 atomic + 9 IC-weighted
8
Factor classes
CORR / EFF / FLOW / FUT / OB / OPT / TR / VOL
8
Horizons
1d → 365d
5
Signal geometry types
threshold / ratio / deviation / …
5+ yr
Backtested history
walk-forward IS/OOS on every signal
3
Execution venues
OKX · Kraken · Coinbase

Walk-forward validated. Macro-regime aware. Complementary to exchange execution toolkits — CRYPTYX is the brain, exchanges are the rails.

The 5-step agent workflow

This is the recommended flow every response of /api/signals/catalog hints at via its meta.next block. Every step is $0.01–$0.10 — an agent can complete the full loop for under $0.20.

1
Browse the catalog$0.01
GET /api/signals/catalog

Full registry (143 atomic + 9 composite signals) with strategy-family breakdown, walk-forward IS/OOS metrics, and per-signal action URLs pre-substituted.

2
Rank by IC$0.01
GET /api/signals/top

Top 10 highest-IC signals right now. A/B health grades only, walk-forward validated, ranked by 7-day cross-sectional IC.

3
Understand any trigger$0.01
GET /api/signals/explain?signal_id={id}&day={YYYY-MM-DD}&asset={SYMBOL}

Factor-t-score breakdown behind any signal fire — see WHY it triggered on this asset on this day.

4
Validate against history$0.05
POST /api/signals/backtest

Backtest any signal over up to 365 days at 4 horizons with bootstrap CI + statistical significance + walk-forward IS/OOS.

5
Ship a starter pack$0.10
GET /api/v1/ai/trade-ideas

Top-N composite-ranked assets bundled with signal counts, regime, derivatives stress, top-3 atomic setups, and top-3 per-asset predictors.

Signal strategy families

143 atomic signals grouped by factor class. Every catalog response returns this breakdown in meta.by_class so agents pick a strategy family instead of scanning 143 rows.

TRTrend + momentum signals

Directional bets on price continuation or reversal.

OBOrder book depth + imbalance

Pre-trade liquidity checks + short-horizon flow bias.

CORRCross-asset correlation regimes

Basket construction, hedge selection, risk-parity gating.

OPTOptions implied vol + skew

Vol structuring, tail-risk positioning, sentiment reads.

FUTFutures funding + open interest

Carry-trade filters, crowding detection, squeeze setups.

EFFPrice efficiency + reversal setups

Mean-reversion entries, exhaustion detection.

VOLVolatility regime + compression setups

Breakout timing, position sizing, vol-of-vol trades.

FLOWOrder flow + taker aggression

Directional flow bias, buy/sell pressure reads.

How the 402 flow works

1
RequestAgent hits any x402-priced endpoint without a payment header.
2
402 ResponseServer returns HTTP 402 with price, USDC contract, payTo wallet, and payment requirements in the payment-required header.
3
SignAgent signs a gasless ERC-3009 USDC authorization using its EVM wallet.
4
RetryAgent retries the request with the signed payment in the payment-signature header.
5
Verify + SettleServer forwards the payment to the Coinbase CDP facilitator for verification and on-chain settlement on Base mainnet.
6
DataAgent receives the full API response. Settlement receipt in payment-response header. Response includes a _next block pointing at the natural follow-up endpoints.

Pricing

60 endpoints across 4 tiers. All prices in USD, settled in USDC on Base. Machine-readable at /.well-known/x402.

Standard$0.01

Market data, signal catalog, live triggered signals, factor scores, macro regime, agent grounding bundles (agent-context, ai/signals, ai/metrics).

Premium$0.05

Backtest any signal or metric, fork custom signal variants, per-asset conviction thesis, cross-class positioning, historical top setups, peer clusters.

Trade Ideas$0.10

GET /api/v1/ai/trade-ideas — top-N composite-ranked assets bundled with signal + regime + derivatives overlay in one call.

Enterprise$0.25

POST /api/signals/composite/custom — re-rank the 200+ asset universe under your own 8-class composite weights. POST /api/intelligence/query — natural-language over the full CRYPTYX stack.

Quick start

The fastest path is Coinbase's Agentic Wallet CLI (awal). If you're building from scratch, the raw SDK snippet at the bottom shows the full 402-handshake explicitly.

Option A · Agentic Wallet (recommended for agents)

bash
# Install + sign in (one-time)
npx skills add coinbase/agentic-wallet-skills
npx awal auth login <your-email>

# Fund your wallet with USDC on Base
npx awal show

# Pay + query CRYPTYX in one command
npx awal x402 pay https://cryptyx.ai/api/signals/catalog

Option B · Raw @x402/axios (Node / TypeScript)

typescript
import { privateKeyToAccount } from 'viem/accounts';
import axios from 'axios';
import { wrapAxiosWithPaymentFromConfig } from '@x402/axios';
import { ExactEvmScheme } from '@x402/evm';

const account = privateKeyToAccount(process.env.WALLET_KEY as `0x${string}`);
const api = wrapAxiosWithPaymentFromConfig(
  axios.create(),
  { schemes: [{ network: 'eip155:*', client: new ExactEvmScheme(account) }] },
);

// Handshake + settle + fetch happens under the hood
const { data } = await api.get('https://cryptyx.ai/api/signals/catalog');

console.log(data.meta.service.tagline);   // "The intelligence layer for autonomous trading agents"
console.log(data.meta.by_class);          // { TR: 33, OB: 33, CORR: 21, ... }
console.log(data.meta.next.recommended_flow); // 5-step agent workflow
console.log(data.signals[0]._actions);    // { explain: "...", backtest: "...", fork_variant: "...", simulate_threshold: "..." }

Option C · Just curl the 402 response (no payment, no data)

bash
curl -i https://cryptyx.ai/api/signals/catalog
# → HTTP 402 with payment-required header (base64-decode to see the full payload schema)

What you get back

Every response is structured so an agent can act without external docs. Here's the shape of GET /api/signals/catalog — the entry point.

json
{
  "ok": true,
  "count": 143,
  "meta": {
    "ic_context": "cross_sectional",
    "service": {
      "name": "CRYPTYX",
      "tagline": "The intelligence layer for autonomous trading agents",
      "universe": { "assets": 200, "metrics": 442, "signals_atomic": 143, "signals_composite": 9, "factor_classes": 8, "horizons": 8, "history_years": 5 },
      "walk_forward_validated": true,
      "macro_regime_aware": true,
      "execution_venues": ["OKX", "Kraken", "Coinbase"]
    },
    "by_class": {
      "TR":   { "count": 33, "one_liner": "Trend + momentum signals" },
      "OB":   { "count": 33, "one_liner": "Order book depth + imbalance" },
      "CORR": { "count": 21, "one_liner": "Cross-asset correlation regimes" },
      "OPT":  { "count": 17, "one_liner": "Options implied vol + skew" },
      "FUT":  { "count": 16, "one_liner": "Futures funding + open interest" },
      "EFF":  { "count": 16, "one_liner": "Price efficiency + reversal setups" },
      "VOL":  { "count": 13, "one_liner": "Volatility regime + compression" },
      "FLOW": { "count": 11, "one_liner": "Order flow + taker aggression" }
    },
    "next": {
      "recommended_flow": [
        "1) Pick 1-3 signals whose class + horizon match your hypothesis.",
        "2) GET /api/signals/top — the 10 highest-IC signals right now.",
        "3) GET /api/signals/explain?signal_id={id}&day={YYYY-MM-DD}&asset={SYMBOL}.",
        "4) POST /api/signals/backtest — validate over 5+ years.",
        "5) GET /api/v1/ai/trade-ideas — bundled starter pack for autonomous execution."
      ]
    }
  },
  "signals": [
    {
      "signal_id": "TR_MOMO_CONT_14D",
      "name": "Trend Momentum Continuation 14D",
      "class": "TR",
      "horizon": "14D",
      "health_grade": "A",
      "walk_forward": { "is_ic": 0.10, "oos_ic": 0.07, "reliability_grade": "green" },
      "_actions": {
        "explain": "GET /api/signals/explain?signal_id=TR_MOMO_CONT_14D&day={YYYY-MM-DD}&asset={SYMBOL}  ($0.01)",
        "backtest": "POST /api/signals/backtest  body={signal_id:'TR_MOMO_CONT_14D', from:'YYYY-MM-DD', to:'YYYY-MM-DD'}  ($0.05)"
      }
    }
    // ... 142 more
  ],
  "durationMs": 842
}

Every paid endpoint (55 of 56) returns a canonical _next.hints block with 3–5 targeted follow-up endpoints, each labelled with price and one-line reasoning. Every response is envelope-shaped — { ok, ..., _next } — so agents can rely on one contract across the entire surface.

Requirements

USDC on Base — any amount. A wallet with $1 USDC can make 100 Standard-tier calls or the full 5-step workflow ~5 times over.

An EVM wallet — Coinbase Agentic Wallet (recommended for autonomous agents), or any EVM wallet with a private key you can sign ERC-3009 authorisations from. No account creation, no KYC, no rate cards.

Zero gas fees — payments use ERC-3009 (gasless USDC transfers). The Coinbase CDP facilitator handles verification and on-chain settlement.

Execution — meet your agent where it lives

x402 is protocol-neutral. CRYPTYX is venue-neutral. Your agent pays for conviction on Base, then executes wherever it makes sense — the exchange with the best liquidity, the tightest spreads, the right regulatory posture, or the deepest agent-native rails. We ship five reference handshakes to make this concrete. Each shows the same three-step pattern: pay CRYPTYX → apply institutional gate → execute on the venue's API. Fork any of them.

Each file is a self-contained ~150-line reference implementation. The CRYPTYX side is identical across all five (SDK call + institutional gate); only the final placeOrder(...) differs. Adding a sixth venue is trivial — same pattern, swap the exchange adapter. If you're on a venue we haven't covered, use one of these as a template.

For exchange product teams

CRYPTYX-graded triggers are the missing conviction primitive between your smart-order-router and your clients' strategies — the same rigor a quant desk demands, exposed as one endpoint call. Any of the reference handshakes above shows exactly what an integration looks like: the client pays for the evidence packet in USDC on Base, your venue never touches the payment flow, and your existing execution API becomes measurably smarter.

We're actively interested in deeper integration paths: native tool inclusion in your agent SDK, exclusive marketplace listing, white-label the intelligence layer under your brand. Because x402 is neutral and CRYPTYX is neutral, none of this creates a competitive-exclusivity conflict with your existing infrastructure. gc@cryptyx.ai to talk.

Resources