{"openapi":"3.1.0","info":{"title":"Agent Signals API","version":"1.0.0","description":"Crypto market-intelligence signals for AI trading agents, paid per call in USDC via the x402 protocol.","contact":{"name":"Agent Signals","email":"yokouchi@atomtokyo.jp","url":"https://cryptojp.com"}},"servers":[{"url":"https://cryptojp.com"}],"paths":{"/v1/funding":{"get":{"operationId":"funding","summary":"Cross-Exchange Funding Rate","description":"Real-time cross-exchange perpetual funding-rate intelligence for AI trading agents. Aggregates the live funding rate for any major crypto asset (BTC, ETH, SOL, …) across Binance, Bybit and OKX, annualizes it, measures cross-venue dispersion, and returns a machine-readable positioning bias (crowded_long / crowded_short / neutral) with a plain-English interpretation of squeeze risk. Built for autonomous agents that need a one-call read on derivatives positioning before sizing a trade. No API key required.","tags":["crypto","funding-rate","perpetuals","derivatives","trading-signal","defi","market-data"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Base asset symbol, e.g. BTC, ETH, SOL.","example":"BTC"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"base":"BTC","venues":{"binance":0.0001,"bybit":0.000095,"okx":0.00011},"avgFundingRate8h":0.000102,"annualizedPct":11.16,"crossVenueDispersion":0.000015,"bias":"crowded_long","interpretation":"Longs are paying shorts; positioning is crowded long — elevated long-squeeze risk."}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"Cross-Exchange Funding Rate","youWillGet":["per-venue funding","annualizedPct","crowding bias","interpretation"],"sample":{"base":"BTC","bias":"crowded_long","annualizedPct":"≈ paid"},"hint":"Pay the x402 price to receive live numbers for your requested symbol."}}}}},"x-x402":{"price":"$0.01","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/leadlag":{"get":{"operationId":"leadlag","summary":"BTC Lead-Lag Signal","description":"BTC→altcoin lead-lag signal for AI trading agents. Bitcoin frequently leads altcoins by a short, measurable delay; this endpoint computes the lag (in minutes) and correlation between an altcoin and BTC over recent 1-minute candles, reads BTC's most recent momentum over that lag window, and returns the implied next directional bias (up / down / none) with a 0–1 confidence score. One call gives an agent a short-horizon, BTC-driven directional prior for any major altcoin. Heuristic over free public data; not financial advice.","tags":["crypto","lead-lag","correlation","momentum","bitcoin","altcoins","trading-signal"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Altcoin base symbol (not BTC), e.g. SOL, ETH, DOGE.","example":"SOL"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"base":"SOL","reference":"BTC","bestLagMinutes":2,"correlation":0.61,"btcMomentumPctOverLag":0.18,"impliedNextBias":"up","confidence":0.61,"note":"SOL tends to follow BTC by ~2 min (corr 0.61)."}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"BTC Lead-Lag Signal","youWillGet":["bestLagMinutes","correlation","impliedNextBias","confidence"],"hint":"Pay the x402 price to receive the live lead-lag read for your altcoin."}}}}},"x-x402":{"price":"$0.02","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/regime":{"get":{"operationId":"regime","summary":"Trend / Chop Regime","description":"Market-regime classifier for AI trading agents. Determines whether a crypto asset is currently in a directional (trending_up / trending_down) or mean-reverting (ranging) regime using EMA structure, slope and ATR volatility on hourly candles, and returns a 0–100 trendScore plus a plain-English recommendation (momentum vs mean-reversion). Lets an agent pick the RIGHT strategy for current conditions instead of applying a trend model in a chop market. Heuristic over free public data; not financial advice.","tags":["crypto","market-regime","trend","volatility","atr","ema","trading-signal","market-data"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Base asset symbol, e.g. BTC, ETH, SOL.","example":"ETH"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"base":"ETH","regime":"trending_up","trendScore":72,"emaSpreadPct":1.84,"ema20SlopePct":0.92,"volatilityPctATR":1.21,"interpretation":"Directional regime (trending_up): momentum/trend-following favored over mean-reversion."}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"Trend / Chop Regime","youWillGet":["regime","trendScore","volatilityPctATR","interpretation"],"hint":"Pay the x402 price to receive the live regime read for your symbol."}}}}},"x-x402":{"price":"$0.01","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/price":{"get":{"operationId":"price","summary":"Spot Price & 24h Stats","description":"Real-time spot price intelligence for AI agents. Returns the live price of any major crypto asset with 24h change %, high/low, USD volume, where the price sits within its 24h range, and the cross-exchange spread (Binance vs Bybit). One cheap call to ground any agent decision in current market price. No API key required.","tags":["crypto","price","spot","market-data","24h","trading-signal"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Base asset symbol, e.g. BTC, ETH, SOL.","example":"BTC"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"base":"BTC","price":65500.2,"change24hPct":1.84,"high24h":66100,"low24h":64200,"volume24hUsd":18500000000,"rangePositionPct":68.4,"venues":{"binance":65500.2,"bybit":65498.9},"crossVenueSpreadPct":0.002}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"Spot Price & 24h Stats","youWillGet":["price","change24hPct","high/low","volume","rangePosition","crossVenueSpread"],"hint":"Pay the x402 price for the live numbers."}}}}},"x-x402":{"price":"$0.005","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/basis":{"get":{"operationId":"basis","summary":"Perp-Spot Basis","description":"Perp-spot basis intelligence for AI trading agents. Compares the perpetual mark price to spot, returns the basis %, classifies the structure (contango / backwardation / flat), and annualizes the funding carry. Lets an agent read leverage/carry positioning and funding cost before taking a perp position. Heuristic over free public data; not financial advice.","tags":["crypto","basis","perpetuals","funding","carry","contango","derivatives","trading-signal"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Base asset symbol, e.g. BTC, ETH, SOL.","example":"ETH"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"base":"ETH","spotPrice":3450.1,"perpMarkPrice":3452,"basisPct":0.055,"annualizedFundingPct":9.8,"structure":"contango","interpretation":"Perp above spot (contango) — longs pay to hold; leveraged-long / bullish carry."}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"Perp-Spot Basis","youWillGet":["basisPct","structure","annualizedFundingPct","interpretation"],"hint":"Pay the x402 price for the live read."}}}}},"x-x402":{"price":"$0.01","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/openinterest":{"get":{"operationId":"openinterest","summary":"Open Interest & Leverage","description":"Open-interest intelligence for AI trading agents. Returns live open interest in base units and USD notional (Binance USDⓈ-M) plus the annualized funding context, with a plain-English read of leveraged-long vs leveraged-short crowding and squeeze risk. Lets an agent size risk around how much leverage is in the market. Heuristic over free public data; not financial advice.","tags":["crypto","open-interest","leverage","positioning","derivatives","squeeze","trading-signal"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Base asset symbol, e.g. BTC, ETH, SOL.","example":"SOL"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"base":"SOL","openInterestBase":6850000,"openInterestUsd":1027500000,"price":150,"annualizedFundingPct":12.4,"interpretation":"~$1027.5M open interest (Binance USDⓈ-M). High OI + positive funding = crowded leveraged longs; long-squeeze risk."}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"Open Interest & Leverage","youWillGet":["openInterestUsd","annualizedFundingPct","interpretation"],"hint":"Pay the x402 price for the live read."}}}}},"x-x402":{"price":"$0.01","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/jp/price":{"get":{"operationId":"jp-price","summary":"Japan Price (JPY)","description":"Japanese crypto price intelligence for AI agents — the data English-language providers don't serve. Returns the live JPY price from Japan's top exchanges (bitFlyer, Coincheck), the cross-venue JP spread, the USD/JPY rate, and the USD-equivalent. Essential for any agent trading JPY pairs or covering the Japanese market. No API key required.","tags":["crypto","japan","jpy","bitflyer","coincheck","price","market-data","asia"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Base asset symbol (JPY-listed), e.g. BTC, ETH, XRP.","example":"BTC"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"base":"BTC","priceJpy":10318000,"priceUsdEquivalent":64350.1,"usdJpy":160.36,"venues":{"bitflyer":10317489,"coincheck":10318232},"jpVenueSpreadPct":0.0072}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"Japan Price (JPY)","youWillGet":["priceJpy","priceUsdEquivalent","usdJpy","per-venue JP prices","jpVenueSpread"],"hint":"Pay the x402 price for live Japanese-exchange numbers."}}}}},"x-x402":{"price":"$0.005","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/jp/premium":{"get":{"operationId":"jp-premium","summary":"Japan Premium (cross-border arb)","description":"Japan-premium intelligence for AI trading agents: compares the Japanese-exchange price (bitFlyer/Coincheck, JPY converted to USD at the live USD/JPY rate) against the global USD price, and returns the premium % plus a plain-English arbitrage read (buy-global-sell-Japan or vice-versa). A genuinely under-served cross-border edge that global agents want and few suppliers provide. Heuristic over free public data; not financial advice.","tags":["crypto","japan","arbitrage","premium","cross-border","jpy","trading-signal","asia"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Base asset symbol (JPY-listed), e.g. BTC, ETH, XRP.","example":"BTC"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"base":"BTC","japanPriceUsd":64350.1,"globalPriceUsd":64300,"premiumPct":0.078,"japanPriceJpy":10318000,"usdJpy":160.36,"interpretation":"Japan ≈ global; no meaningful premium right now."}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"Japan Premium (cross-border arb)","youWillGet":["premiumPct","japanPriceUsd","globalPriceUsd","arbitrage interpretation"],"hint":"Pay the x402 price for the live Japan-vs-global premium."}}}}},"x-x402":{"price":"$0.01","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/volatility":{"get":{"operationId":"volatility","summary":"Volatility Regime","description":"Volatility intelligence for AI trading agents. Computes annualized realized volatility (from 7 days of hourly returns) and ATR%, then classifies the regime (low / normal / high) with a sizing recommendation. Lets an agent size positions and set stops to current conditions. Heuristic over free public data; not financial advice.","tags":["crypto","volatility","realized-vol","atr","risk","position-sizing","trading-signal"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Base asset symbol, e.g. BTC, ETH, SOL.","example":"BTC"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"base":"BTC","annualizedVolPct":52.3,"atrPct1h":0.41,"volRegime":"normal","interpretation":"Annualized realized volatility ≈ 52% (normal). Normal volatility."}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"Volatility Regime","youWillGet":["annualizedVolPct","atrPct1h","volRegime","interpretation"],"hint":"Pay the x402 price for the live volatility read."}}}}},"x-x402":{"price":"$0.01","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/momentum":{"get":{"operationId":"momentum","summary":"Momentum & RSI","description":"Momentum intelligence for AI trading agents. Returns the hourly RSI(14) with an overbought / oversold / neutral signal and multi-timeframe returns (1h, 24h, 7d). One call for an agent to gauge short-term momentum and exhaustion. Heuristic over free public data; not financial advice.","tags":["crypto","momentum","rsi","overbought","oversold","returns","trading-signal"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Base asset symbol, e.g. BTC, ETH, SOL.","example":"SOL"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"base":"SOL","rsi1h":58.2,"signal":"neutral","return1hPct":0.34,"return24hPct":-1.2,"return7dPct":6.8,"interpretation":"RSI(1h) 58 = neutral. Returns: 24h -1.2%, 7d 6.8%."}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"Momentum & RSI","youWillGet":["rsi1h","signal","return1h/24h/7d","interpretation"],"hint":"Pay the x402 price for the live momentum read."}}}}},"x-x402":{"price":"$0.01","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/feargreed":{"get":{"operationId":"feargreed","summary":"Crypto Fear & Greed","description":"Market-sentiment intelligence for AI agents. Returns the crypto Fear & Greed index (0–100), its classification (Extreme Fear → Extreme Greed), and the day-over-day change/trend. A one-call read on aggregate market emotion for contrarian or confirmation signals. No symbol or API key required.","tags":["crypto","sentiment","fear-and-greed","market-wide","contrarian","trading-signal"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Asset symbol"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"index":22,"classification":"Extreme Fear","previous":23,"change":-1,"trend":"worsening","interpretation":"Crypto Fear & Greed = 22 (Extreme Fear), -1 vs yesterday. Extreme fear — contrarian-bullish zone."}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"Crypto Fear & Greed","youWillGet":["index","classification","trend","interpretation"],"hint":"Pay the x402 price for the live index."}}}}},"x-x402":{"price":"$0.005","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/global":{"get":{"operationId":"global","summary":"Global Market Cap & Dominance","description":"Market-structure intelligence for AI agents. Returns total crypto market capitalization, 24h change, and BTC / ETH / altcoin dominance. One call to read the macro crypto backdrop (risk-on vs BTC-dominant). No symbol or API key required.","tags":["crypto","market-cap","dominance","btc-dominance","macro","market-wide"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Asset symbol"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"totalMarketCapUsd":2296717144233,"marketCapChange24hPct":-1.99,"btcDominancePct":56.09,"ethDominancePct":9.14,"altDominancePct":34.77,"interpretation":"Total crypto market cap $2.30T (-2.0% 24h). BTC dominance 56.1%."}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"Global Market Cap & Dominance","youWillGet":["totalMarketCapUsd","marketCapChange24hPct","btc/eth/altDominance"],"hint":"Pay the x402 price for live macro numbers."}}}}},"x-x402":{"price":"$0.005","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/gas":{"get":{"operationId":"gas","summary":"Gas Prices (Base + Ethereum)","description":"On-chain gas intelligence for AI agents. Returns the live gas price (gwei) on Base and Ethereum so an agent can time or budget on-chain actions and route to the cheaper chain. No symbol or API key required.","tags":["crypto","gas","base","ethereum","onchain","infrastructure","market-wide"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Asset symbol"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"baseGwei":0.006,"ethereumGwei":4.2,"interpretation":"Base gas 0.006 gwei · Ethereum 4 gwei. Base extremely cheap — good for high-frequency on-chain actions."}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"Gas Prices (Base + Ethereum)","youWillGet":["baseGwei","ethereumGwei","interpretation"],"hint":"Pay the x402 price for live gas."}}}}},"x-x402":{"price":"$0.005","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/stablecoin":{"get":{"operationId":"stablecoin","summary":"Stablecoin Peg Health","description":"Stablecoin peg-health intelligence for AI agents. Returns the live price and peg deviation (basis points from $1) for USDT, USDC, DAI and FDUSD, flagging the largest deviation and depeg risk. A one-call safety check before an agent holds or routes through a stablecoin. No symbol or API key required.","tags":["crypto","stablecoin","peg","depeg","usdt","usdc","dai","risk","market-wide"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Asset symbol"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"stablecoins":[{"symbol":"USDT","price":0.99903,"pegDeviationBps":-9.7},{"symbol":"USDC","price":0.99979,"pegDeviationBps":-2.1},{"symbol":"DAI","price":0.99986,"pegDeviationBps":-1.4},{"symbol":"FDUSD","price":0.99781,"pegDeviationBps":-21.9}],"worstPeg":{"symbol":"FDUSD","price":0.99781,"pegDeviationBps":-21.9},"interpretation":"4 stablecoins checked. Largest deviation: FDUSD -21.9 bps from $1. Pegs healthy."}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"Stablecoin Peg Health","youWillGet":["per-stablecoin price","pegDeviationBps","worstPeg","depeg flag"],"hint":"Pay the x402 price for live peg health."}}}}},"x-x402":{"price":"$0.005","currency":"USDC","network":"base","scheme":"exact"}}},"/v1/ens":{"get":{"operationId":"ens","summary":"ENS Resolver","description":"ENS resolution for AI agents operating on-chain. Pass an ENS name (e.g. vitalik.eth) to get its Ethereum address, or a 0x address to get its primary ENS name. Lets an agent translate between human-readable names and addresses before acting. No API key required.","tags":["crypto","ens","onchain","ethereum","identity","resolver","name-service"],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"An ENS name (e.g. vitalik.eth) or a 0x… Ethereum address.","example":"vitalik.eth"}],"responses":{"200":{"description":"Signal payload","content":{"application/json":{"example":{"ok":true,"query":"vitalik.eth","kind":"name","resolved":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","found":true,"interpretation":"vitalik.eth resolves to 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}}}},"402":{"description":"Payment Required (x402). Pay in USDC and retry with the X-PAYMENT header.","content":{"application/json":{"example":{"preview":true,"service":"ENS Resolver","youWillGet":["resolved address or name","kind","found"],"hint":"Pay the x402 price to resolve your name/address."}}}}},"x-x402":{"price":"$0.005","currency":"USDC","network":"base","scheme":"exact"}}}}}