# Agent Signals

> Pay-per-call crypto market-intelligence API for autonomous AI trading agents. Live funding-rate, BTC lead-lag, and trend/chop regime signals for any major crypto asset, settled in USDC over the x402 protocol. No account or API key required — agents pay per call.

Payment: x402 · USDC · base. Machine catalog: https://cryptojp.com/catalog · OpenAPI: https://cryptojp.com/openapi.json

## When to use which endpoint

### Cross-Exchange Funding Rate — `GET /v1/funding?symbol=...` ($0.01 USDC/call)
Real-time aggregated perpetual-futures funding rate for a crypto asset across Binance, Bybit and OKX, with crowding bias.
Input: {"symbol":"BTC"}. Returns: ok, base, venues, avgFundingRate8h, annualizedPct, crossVenueDispersion, bias, interpretation.
Use when: crypto, funding-rate, perpetuals, derivatives, trading-signal, defi, market-data.

### BTC Lead-Lag Signal — `GET /v1/leadlag?symbol=...` ($0.02 USDC/call)
Measures how strongly and with what time lag an altcoin follows Bitcoin, and the implied next directional bias.
Input: {"symbol":"SOL"}. Returns: ok, base, reference, bestLagMinutes, correlation, btcMomentumPctOverLag, impliedNextBias, confidence, note.
Use when: crypto, lead-lag, correlation, momentum, bitcoin, altcoins, trading-signal.

### Trend / Chop Regime — `GET /v1/regime?symbol=...` ($0.01 USDC/call)
Classifies whether an asset is trending or range-bound right now, with a 0–100 trend score and volatility.
Input: {"symbol":"ETH"}. Returns: ok, base, regime, trendScore, emaSpreadPct, ema20SlopePct, volatilityPctATR, interpretation.
Use when: crypto, market-regime, trend, volatility, atr, ema, trading-signal, market-data.

### Spot Price & 24h Stats — `GET /v1/price?symbol=...` ($0.005 USDC/call)
Live spot price for a crypto asset with 24h change, high/low, USD volume, range position, and cross-venue spread.
Input: {"symbol":"BTC"}. Returns: ok, base, price, change24hPct, high24h, low24h, volume24hUsd, rangePositionPct, venues, crossVenueSpreadPct.
Use when: crypto, price, spot, market-data, 24h, trading-signal.

### Perp-Spot Basis — `GET /v1/basis?symbol=...` ($0.01 USDC/call)
Perpetual-vs-spot basis (contango/backwardation) and annualized funding carry for a crypto asset.
Input: {"symbol":"ETH"}. Returns: ok, base, spotPrice, perpMarkPrice, basisPct, annualizedFundingPct, structure, interpretation.
Use when: crypto, basis, perpetuals, funding, carry, contango, derivatives, trading-signal.

### Open Interest & Leverage — `GET /v1/openinterest?symbol=...` ($0.01 USDC/call)
Open interest (USD notional) and funding context for a crypto asset — how much leveraged positioning is on.
Input: {"symbol":"SOL"}. Returns: ok, base, openInterestBase, openInterestUsd, price, annualizedFundingPct, interpretation.
Use when: crypto, open-interest, leverage, positioning, derivatives, squeeze, trading-signal.

### Japan Price (JPY) — `GET /v1/jp/price?symbol=...` ($0.005 USDC/call)
Live JPY price of a crypto asset from Japanese exchanges (bitFlyer, Coincheck), with USD equivalent and USD/JPY.
Input: {"symbol":"BTC"}. Returns: ok, base, priceJpy, priceUsdEquivalent, usdJpy, venues, jpVenueSpreadPct.
Use when: crypto, japan, jpy, bitflyer, coincheck, price, market-data, asia.

### Japan Premium (cross-border arb) — `GET /v1/jp/premium?symbol=...` ($0.01 USDC/call)
The premium/discount of Japanese-exchange price vs the global USD price — a live cross-border arbitrage signal.
Input: {"symbol":"BTC"}. Returns: ok, base, japanPriceUsd, globalPriceUsd, premiumPct, japanPriceJpy, usdJpy, interpretation.
Use when: crypto, japan, arbitrage, premium, cross-border, jpy, trading-signal, asia.

### Volatility Regime — `GET /v1/volatility?symbol=...` ($0.01 USDC/call)
Annualized realized volatility + ATR for a crypto asset, classified low / normal / high for position sizing.
Input: {"symbol":"BTC"}. Returns: ok, base, annualizedVolPct, atrPct1h, volRegime, interpretation.
Use when: crypto, volatility, realized-vol, atr, risk, position-sizing, trading-signal.

### Momentum & RSI — `GET /v1/momentum?symbol=...` ($0.01 USDC/call)
RSI(1h) with overbought/oversold signal plus 1h / 24h / 7d returns for a crypto asset.
Input: {"symbol":"SOL"}. Returns: ok, base, rsi1h, signal, return1hPct, return24hPct, return7dPct, interpretation.
Use when: crypto, momentum, rsi, overbought, oversold, returns, trading-signal.

### Crypto Fear & Greed — `GET /v1/feargreed?symbol=...` ($0.005 USDC/call)
The crypto Fear & Greed index (0-100) with classification and day-over-day trend.
Input: {}. Returns: ok, index, classification, previous, change, trend, interpretation.
Use when: crypto, sentiment, fear-and-greed, market-wide, contrarian, trading-signal.

### Global Market Cap & Dominance — `GET /v1/global?symbol=...` ($0.005 USDC/call)
Total crypto market cap, 24h change, and BTC / ETH / alt dominance.
Input: {}. Returns: ok, totalMarketCapUsd, marketCapChange24hPct, btcDominancePct, ethDominancePct, altDominancePct, interpretation.
Use when: crypto, market-cap, dominance, btc-dominance, macro, market-wide.

### Gas Prices (Base + Ethereum) — `GET /v1/gas?symbol=...` ($0.005 USDC/call)
Live gas price on Base and Ethereum (gwei) for on-chain action timing.
Input: {}. Returns: ok, baseGwei, ethereumGwei, interpretation.
Use when: crypto, gas, base, ethereum, onchain, infrastructure, market-wide.

### Stablecoin Peg Health — `GET /v1/stablecoin?symbol=...` ($0.005 USDC/call)
Peg deviation (bps from $1) for USDT, USDC, DAI, FDUSD — depeg early-warning.
Input: {}. Returns: ok, stablecoins, worstPeg, interpretation.
Use when: crypto, stablecoin, peg, depeg, usdt, usdc, dai, risk, market-wide.

### ENS Resolver — `GET /v1/ens?symbol=...` ($0.005 USDC/call)
Resolve an ENS name to an address, or reverse-resolve a 0x address to its primary ENS name.
Input: {"symbol":"vitalik.eth"}. Returns: ok, query, kind, resolved, found, interpretation.
Use when: crypto, ens, onchain, ethereum, identity, resolver, name-service.

## How to pay
1. Call the endpoint. 2. Receive HTTP 402 with payment requirements. 3. Pay in USDC and retry with the X-PAYMENT header (any x402 client / @x402/fetch / Coinbase AgentKit handles this automatically).