{"info":{"description":"Pay-per-call crypto market data and AI utility endpoints, priced in USDC on Base and metered per request via the x402 protocol \u2014 no signup, no API keys, the payment is the authentication. Free discovery: /catalog (JSON), /.well-known/x402 (x402 manifest), and /llms.txt (plain-text agent manifest).","title":"Stelar Digital Crypto & AI Signals API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/bundle/deep-signal":{"get":{"description":"Everything in /bundle/market-brief (regime, sentiment, price, risk) plus an AI-generated synthesis connecting the signals and naming the single biggest risk factor \u2014 grounded only in the real data returned, never fabricated. For agents wanting one $2.50 call instead of a market brief plus a manual read. Input: ?symbol=SOL. Output: {symbol, regime, sentiment, price, risk, generated_at, disclaimer, analysis: {synthesis, key_risk}}.","operationId":"get_bundle_deep-signal","parameters":[{"description":"Asset symbol, e.g. SOL","in":"query","name":"symbol","required":true,"schema":{"enum":["ADA","BTC","DOGE","ETH","LTC","SOL","XLM","XRP"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"analysis":{"key_risk":"A break of the 30-day volatility baseline could invalidate the range-bound read.","synthesis":"SOL is range-bound with mild bullish sentiment and calmer-than-usual volatility, consistent with a grid-friendly regime."},"disclaimer":"Educational, not financial advice.","generated_at":1720400000,"price":{"chg_24h":1.8,"chg_7d":4.2,"price":172.4,"signal":"bullish"},"regime":{"features":{"atr_pct":2.1,"atr_pct_p80_30d":3.4,"ema12_48_spread_pct":0.4},"grid_suitability":{"note":"Range-bound market: grids harvest oscillation \u2014 the ideal regime.","verdict":"excellent"},"regime":"chop"},"risk":{"atr_p80_30d":3.4,"drawdown_risk":"low","note":"Volatility below its typical range \u2014 calmer conditions.","volatility":2.1},"sentiment":{"label":"bullish","sentiment":0.42},"symbol":"SOL"},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $2.50 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Everything in /bundle/market-brief (regime, sentiment, price, risk) plus an AI-generated synthesis connecting the signal","tags":["crypto","trading","bundle","market-regime","sentiment","signal","ai"]}},"/bundle/market-brief":{"get":{"description":"Complete market brief for one crypto asset in a single $1 call \u2014 trend regime, AI sentiment, live price with 24h/7d change, and volatility risk, combined from Stelar Digital's production classifiers. For agents needing full context before a trade decision without stitching together 4 separate calls. Input: ?symbol=SOL. Output: {symbol, regime, sentiment, price, risk, generated_at, disclaimer}.","operationId":"get_bundle_market-brief","parameters":[{"description":"Asset symbol, e.g. SOL","in":"query","name":"symbol","required":true,"schema":{"enum":["ADA","BTC","DOGE","ETH","LTC","SOL","XLM","XRP"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"disclaimer":"Educational, not financial advice.","generated_at":1720400000,"price":{"chg_24h":1.8,"chg_7d":4.2,"price":172.4,"signal":"bullish"},"regime":{"features":{"atr_pct":2.1,"atr_pct_p80_30d":3.4,"ema12_48_spread_pct":0.4},"grid_suitability":{"note":"Range-bound market: grids harvest oscillation \u2014 the ideal regime.","verdict":"excellent"},"regime":"chop"},"risk":{"atr_p80_30d":3.4,"drawdown_risk":"low","note":"Volatility below its typical range \u2014 calmer conditions.","volatility":2.1},"sentiment":{"label":"bullish","sentiment":0.42},"symbol":"SOL"},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $1.00 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Complete market brief for one crypto asset in a single $1 call \u2014 trend regime, AI sentiment, live price with 24h/7d chan","tags":["crypto","trading","bundle","market-regime","sentiment","signal"]}},"/classify":{"get":{"description":"Zero-shot text classification into caller-supplied labels, via Claude Haiku. For agents routing, tagging, or triaging text without training or hosting their own classifier.","operationId":"get_classify","parameters":[{"description":"Text to classify","in":"query","name":"text","required":true,"schema":{"type":"string"}},{"description":"Comma-separated candidate labels (2 or more)","in":"query","name":"labels","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"confidence":0.87,"label":"shipping","text":"The order never arrived and support went silent."},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $0.01 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Zero-shot text classification into caller-supplied labels, via Claude Haiku","tags":["ai","classification","nlp"]}},"/domaincheck":{"get":{"description":"Phishing and scam risk score for a domain name \u2014 TLD reputation, brand-impersonation/typosquat detection, structural red flags, plus an AI judgment call, blended into a 0-100 score and verdict. For agents vetting a link before visiting, clicking through, or recommending it to a user.","operationId":"get_domaincheck","parameters":[{"description":"Domain name, e.g. example.com","in":"query","name":"domain","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"ai_reasoning":"No brand impersonation or suspicious structure detected.","domain":"example.com","flags":[],"risk_score":8,"verdict":"low risk"},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $0.01 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Phishing and scam risk score for a domain name \u2014 TLD reputation, brand-impersonation/typosquat detection, structural red","tags":["security","phishing","domain","verification"]}},"/extract":{"get":{"description":"Fetch a URL and extract structured data from its content via Claude Haiku, optionally shaped by a caller-supplied JSON schema. Returns title, summary, and key points by default, or fields matching your schema. For agents pulling structured facts out of unstructured web pages instead of parsing raw HTML themselves.","operationId":"get_extract","parameters":[{"description":"Page to extract structured data from","in":"query","name":"url","required":true,"schema":{"type":"string"}},{"description":"Optional JSON schema hint (as a JSON string) for the output shape","in":"query","name":"schema","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"key_points":["...","..."],"summary":"...","title":"Example Article"},"url":"https://example.com/article"},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $0.02 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Fetch a URL and extract structured data from its content via Claude Haiku, optionally shaped by a caller-supplied JSON s","tags":["ai","extraction","scraping"]}},"/factcheck":{"get":{"description":"Fact-check a written claim and get a true/false/uncertain verdict with a confidence score and reasoning, via Claude Haiku. For agents verifying statements, screening content, or double-checking a claim before acting on it. Answers 'uncertain' honestly for opinions or anything requiring live data it doesn't have.","operationId":"get_factcheck","parameters":[{"description":"A factual statement to verify","in":"query","name":"claim","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"claim":"The Eiffel Tower is in Paris.","confidence":0.99,"reasoning":"Well-established, verifiable fact.","verdict":"true"},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $0.03 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Fact-check a written claim and get a true/false/uncertain verdict with a confidence score and reasoning, via Claude Haik","tags":["ai","verification","fact-check"]}},"/gridparams":{"get":{"description":"Grid-trading parameter recommendation for a crypto pair and capital amount \u2014 grid count, spacing percent, price band, and per-grid USD allocation, derived from live 24h market structure using the same spacing bounds as a production grid engine. For agents configuring, sizing, or backtesting a grid bot before deployment.","operationId":"get_gridparams","parameters":[{"description":"Asset symbol, e.g. SOL","in":"query","name":"asset","required":true,"schema":{"enum":["ADA","BTC","DOGE","ETH","LTC","SOL","XLM","XRP"],"type":"string"}},{"description":"Capital to allocate in USD","in":"query","name":"capital","required":false,"schema":{"maximum":1000000,"minimum":100,"type":"number"}}],"responses":{"200":{"content":{"application/json":{"example":{"as_of":1720400000,"asset":"SOL","day_range_pct":4.8,"last_price":172.4,"recommendation":{"band_high":178.9,"band_low":165.1,"buy_side_bias":"contrarian \u2014 grids buy weakness, sell strength","grids":32,"per_grid_usd":31.25,"spacing_pct":0.5},"symbol":"SOLUSDT"},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $0.05 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Grid-trading parameter recommendation for a crypto pair and capital amount \u2014 grid count, spacing percent, price band, an","tags":["crypto","trading","grid-bot","strategy","parameters"]}},"/markdown":{"get":{"description":"Fetch a URL and return its main content as clean markdown, stripped of navigation, ads, and scripts. For agents that need readable page content without wading through raw HTML noise.","operationId":"get_markdown","parameters":[{"description":"Page to convert to clean markdown","in":"query","name":"url","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"markdown":"# Example Article\n\nBody text in clean markdown...","url":"https://example.com/article"},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $0.01 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Fetch a URL and return its main content as clean markdown, stripped of navigation, ads, and scripts","tags":["scraping","markdown","content"]}},"/pricecheck":{"get":{"description":"Current price, 24h and 7d percent change, and a bullish/bearish/neutral signal for a crypto asset (SOL, BTC, ETH, XRP, DOGE, LTC, ADA, XLM). For agents needing a fast price-and-momentum check before a trade decision.","operationId":"get_pricecheck","parameters":[{"description":"Asset symbol, e.g. SOL","in":"query","name":"asset","required":true,"schema":{"enum":["ADA","BTC","DOGE","ETH","LTC","SOL","XLM","XRP"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"as_of":1720400000,"asset":"SOL","chg_24h":1.8,"chg_7d":4.2,"price":172.4,"signal":"bullish"},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $0.005 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Current price, 24h and 7d percent change, and a bullish/bearish/neutral signal for a crypto asset (SOL, BTC, ETH, XRP, D","tags":["crypto","price","signal"]}},"/regime":{"get":{"description":"Crypto market regime classification (choppy / uptrend / downtrend / high-volatility) for SOL, BTC, ETH, XRP, DOGE, LTC, ADA, or XLM, plus a grid-trading suitability verdict. Computed from 1h klines, a 30-day volatility baseline, and EMA trend detection \u2014 the same classifier that steers a live production grid bot. For agents deciding whether a pair is grid-tradeable right now.","operationId":"get_regime","parameters":[{"description":"Asset symbol, e.g. SOL","in":"query","name":"asset","required":true,"schema":{"enum":["ADA","BTC","DOGE","ETH","LTC","SOL","XLM","XRP"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"as_of":1720400000,"asset":"SOL","features":{"atr_pct":2.1,"atr_pct_p80_30d":3.4,"ema12_48_spread_pct":0.4},"grid_suitability":{"note":"Range-bound market: grids harvest oscillation \u2014 the ideal regime.","verdict":"excellent"},"regime":"chop","symbol":"SOLUSDT"},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $0.03 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Crypto market regime classification (choppy / uptrend / downtrend / high-volatility) for SOL, BTC, ETH, XRP, DOGE, LTC, ","tags":["crypto","trading","market-regime","volatility","signal"]}},"/risk":{"get":{"description":"Volatility and drawdown risk regime for a crypto asset \u2014 current ATR percent versus its 30-day p80 baseline, labeled low/med/high, extending the same classifier behind /regime. For agents sizing positions or deciding whether to widen stops given current volatility.","operationId":"get_risk","parameters":[{"description":"Asset symbol, e.g. SOL","in":"query","name":"asset","required":true,"schema":{"enum":["ADA","BTC","DOGE","ETH","LTC","SOL","XLM","XRP"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"as_of":1720400000,"asset":"SOL","atr_p80_30d":3.4,"drawdown_risk":"low","note":"Volatility below its typical range \u2014 calmer conditions.","symbol":"SOLUSDT","volatility":2.1},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $0.02 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Volatility and drawdown risk regime for a crypto asset \u2014 current ATR percent versus its 30-day p80 baseline, labeled low","tags":["crypto","risk","volatility","signal"]}},"/sentiment":{"get":{"description":"Sentiment score (-1 bearish to +1 bullish) and label for arbitrary text, or for a crypto asset based on its recent price action, via Claude Haiku. For agents gauging market mood or scoring news, social posts, or free text.","operationId":"get_sentiment","parameters":[{"description":"Text to score (or use asset)","in":"query","name":"text","required":false,"schema":{"type":"string"}},{"description":"Asset symbol, e.g. SOL (or use text)","in":"query","name":"asset","required":false,"schema":{"enum":["ADA","BTC","DOGE","ETH","LTC","SOL","XLM","XRP"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"input":"SOL","label":"bullish","sentiment":0.42},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $0.005 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Sentiment score (-1 bearish to +1 bullish) and label for arbitrary text, or for a crypto asset based on its recent price","tags":["ai","sentiment","signal","crypto"]}},"/summarize":{"get":{"description":"Tight, information-dense summary (3-5 sentences) of a URL or raw text, via Claude Haiku. For agents that need the gist of an article, doc, or page before deciding whether to read the full thing.","operationId":"get_summarize","parameters":[{"description":"Page to summarize (or use text)","in":"query","name":"url","required":false,"schema":{"type":"string"}},{"description":"Raw text to summarize (or use url)","in":"query","name":"text","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"summary":"A tight 3-5 sentence summary of the source content.","word_count":42},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $0.01 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Tight, information-dense summary (3-5 sentences) of a URL or raw text, via Claude Haiku","tags":["ai","summarization","content"]}},"/telemetry":{"get":{"description":"Live profit-and-loss telemetry for a real production crypto grid-trading bot \u2014 exchange-ledger reconciled, fee-inclusive, updated continuously. Returns total P&L in USD plus a per-bot breakdown. For agents monitoring live automated-trading performance or benchmarking a strategy against real fills. Real money, not a simulation.","operationId":"get_telemetry","responses":{"200":{"content":{"application/json":{"example":{"bots":{"BTC":261.67,"SOL":340.12,"XLM":210.55},"source":"Stelar Digital production grid bot \u2014 exchange-ledger reconciled, fee-inclusive","total_pnl_usd":812.34,"updated_at":1720400000},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $0.005 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"Live profit-and-loss telemetry for a real production crypto grid-trading bot \u2014 exchange-ledger reconciled, fee-inclusive","tags":["crypto","trading","telemetry","grid-bot","pnl"]}},"/tokencheck":{"get":{"description":"EVM token and contract risk check \u2014 liquidity, pair age, and 24h trading volume pulled from DexScreener, scored into a 0-100 risk score with flags (low liquidity, brand-new pair, no volume) and a plain-language verdict. For agents screening tokens before trading, or vetting a new listing or airdrop contract.","operationId":"get_tokencheck","parameters":[{"description":"EVM contract/token address","in":"query","name":"address","required":true,"schema":{"type":"string"}},{"description":"Chain slug, e.g. base, ethereum, bsc (default base)","in":"query","name":"chain","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"address":"0x1234567890abcdef1234567890abcdef12345678","chain":"base","dex":"uniswap","liquidity_usd":48210.55,"pair_age_days":12.3,"pair_url":"https://dexscreener.com/base/...","risk_flags":[],"risk_score":10,"verdict":"low risk","volume_24h_usd":91234.0},"schema":{"type":"object"}}},"description":"Successful response."},"402":{"description":"Payment required \u2014 pay $0.02 in USDC on eip155:8453 via the x402 protocol. See /.well-known/x402."}},"summary":"EVM token and contract risk check \u2014 liquidity, pair age, and 24h trading volume pulled from DexScreener, scored into a 0","tags":["crypto","risk","token","verification"]}}},"servers":[{"url":"https://api.stelardigital.com"}]}