{"openapi":"3.1.0","info":{"title":"DYOR Knowledge Graph","description":"Crypto-native knowledge graph with 586K+ entities, 28 AI-generated signal types, and cross-domain convergence detection. Pay per request via x402 (USDC on Base) -- no API key required.","version":"1.0.0","contact":{"name":"ZWING Intelligence","url":"https://zwing.bot","email":"v@zwing.bot"},"x-guidance":"This API provides crypto intelligence via a knowledge graph covering 586K+ entities (tokens, protocols, chains, investors, people). Start with POST /api/search to find entities by name, then use POST /api/explore to see relationships (investors, team, DeFi pools, governance). Use POST /api/sparql for custom RDF queries and POST /api/timeseries for historical price/TVL/revenue data. For risk analysis, use GET /api/insights/signals/{signal_type} for specific signal types or GET /api/insights/entity/{entity_name} for a full entity deep-dive. Free endpoints: GET /api/schema (ontology), GET /api/signals/catalog (all 28 signal types), GET /api/insights/signals (recent signals overview)."},"servers":[{"url":"https://kg.dyor.network","description":"Production"}],"paths":{"/api/sparql":{"post":{"operationId":"sparql_query","summary":"SPARQL query","description":"Query the DYOR crypto knowledge graph using SPARQL. Covers 586K+ entities across 8,200+ protocols, tokens, chains, investors, governance, and DeFi data.","tags":["Query"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"SPARQL SELECT query","example":"PREFIX dk: <https://schema.dyor.bot/crypto-kg#> SELECT ?token ?name WHERE { ?token a dk:Token ; <http://schema.org/name> ?name } LIMIT 10"}}}}}},"responses":{"200":{"description":"Query results","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"variables":{"type":"array","items":{"type":"string"}},"data":{"type":"array","items":{"type":"object"}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/search":{"post":{"operationId":"semantic_search","summary":"Semantic entity search","description":"Semantic search over 586K+ crypto entities -- find tokens, protocols, chains, investors, and people by name or meaning.","tags":["Query"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Entity name or semantic search query","example":"Ethereum"},"limit":{"type":"integer","default":10},"entity_types":{"type":"array","items":{"type":"string"},"description":"Filter by type: Token, Protocol, Chain, Organization, Person, Exchange, Pool"}}}}}},"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"query":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"uri":{"type":"string"},"name":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}},"similarity":{"type":"number"}}}},"total_count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/explore":{"post":{"operationId":"explore_entity","summary":"Entity relationship explorer","description":"Explore a crypto entity's relationships across investors, team members, ecosystem chains, DeFi pools, GitHub repositories, governance, and financial metrics.","tags":["Query"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["entity_name"],"properties":{"entity_name":{"type":"string","description":"Entity name (use /api/search to find exact names)","example":"Aave"},"entity_type":{"type":"string"},"focus":{"type":"array","items":{"type":"string"},"description":"Categories: investment, team, lineage, ecosystem, market, defi, financial_metrics, insider_activity, vesting, github"}}}}}},"responses":{"200":{"description":"Entity relationships and data"},"402":{"description":"Payment Required"}}}},"/api/timeseries":{"post":{"operationId":"timeseries_query","summary":"Historical time-series data","description":"Query historical crypto time-series data: token prices, market caps, TVL, protocol revenue, fees, DeFi pool APY, lending rates, stablecoin supply, and treasury balances.","tags":["Query"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sql_query"],"properties":{"sql_query":{"type":"string","description":"Read-only PostgreSQL SELECT query over ts_* tables","example":"SELECT entity_id, \"currentPrice\", \"marketCap\" FROM ts_coingecko_token WHERE date = CURRENT_DATE ORDER BY \"marketCap\" DESC LIMIT 10"}}}}}},"responses":{"200":{"description":"Time-series query results"},"402":{"description":"Payment Required"}}}},"/api/changes":{"get":{"operationId":"query_changes","summary":"Knowledge graph changes","description":"Track real-time changes to the crypto knowledge graph -- new tokens listed, protocol metrics updated, investor relationships added, governance proposals created.","tags":["Query"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":100}},{"name":"entity_uri","in":"query","schema":{"type":"string"},"description":"Filter changes for a specific entity URI"},{"name":"operation","in":"query","schema":{"type":"string","enum":["CREATE","UPDATE"]}},{"name":"summary","in":"query","schema":{"type":"boolean","default":false},"description":"Return aggregate counts instead of individual changes"}],"responses":{"200":{"description":"List of changes"},"402":{"description":"Payment Required"}}}},"/api/insights/entity/{entity_name}":{"get":{"operationId":"entity_insights","summary":"Full entity risk analysis","description":"Comprehensive risk and opportunity analysis for any crypto entity. Returns all active signals with full evidence across 28 signal types plus AI-synthesized narratives with actionability ratings.","tags":["Insights"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.000000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"entity_name","in":"path","required":true,"schema":{"type":"string"},"description":"Entity name (e.g. Ethereum, Aave, Uniswap)"},{"name":"since_hours","in":"query","schema":{"type":"number","default":168},"description":"Look back window in hours (default 7 days)"}],"responses":{"200":{"description":"Full entity analysis with signals and narratives"},"402":{"description":"Payment Required"}}}},"/api/insights/batch":{"post":{"operationId":"batch_insights","summary":"Portfolio analysis (batch)","description":"Portfolio-level risk analysis: get comprehensive signals and narratives for up to 10 crypto entities in a single call.","tags":["Insights"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"5.000000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["entities"],"properties":{"entities":{"type":"array","items":{"type":"string"},"maxItems":10,"description":"Entity names to analyze (max 10)","example":["Aave","Uniswap","Ethereum"]},"since_hours":{"type":"number","default":168}}}}}},"responses":{"200":{"description":"Batch analysis results per entity"},"402":{"description":"Payment Required"}}}},"/api/schema":{"get":{"operationId":"get_schema","summary":"Full ontology schema (free)","description":"Returns all predicates, classes, and time-series tables in the knowledge graph. No parameters required.","tags":["Free"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.000000"},"protocols":[{"x402":{}}]},"parameters":[],"responses":{"200":{"description":"Schema definition"}}}},"/api/signals/catalog":{"get":{"operationId":"signals_catalog","summary":"Signal type catalog (free)","description":"All 28 signal type definitions with descriptions. No parameters required.","tags":["Free"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.000000"},"protocols":[{"x402":{}}]},"parameters":[],"responses":{"200":{"description":"Signal catalog"}}}},"/api/insights/signals":{"get":{"operationId":"signals_overview","summary":"Recent signals overview (free)","description":"Overview of recent signals across all types. Supports optional query parameters: limit, since_hours, signal_type, qualification, entity.","tags":["Free"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.000000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":50}},{"name":"since_hours","in":"query","schema":{"type":"number","default":72}},{"name":"signal_type","in":"query","schema":{"type":"string"},"description":"Filter by signal type slug"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"}}],"responses":{"200":{"description":"Signals overview"}}}},"/api/insights/signals/insider-accumulation":{"get":{"operationId":"signals_insider_accumulation","summary":"Insider Accumulation / Distribution signals","description":"Detects when protocol insiders — team members, early investors, and known affiliated wallets — are systematically buying or selling tokens over a rolling window.\n\nWhy this matters: Insiders possess asymmetric information about protocol health. Sustained insider buying often precedes positive catalysts, while coordinated selling can signal internal concerns.\n\nInterpretation:\n- High score: Large-scale directional flow (>$1M net) with strong buy/sell skew.\n- Moderate: Moderate insider activity with directional bias.\n- Low: Minor insider transactions detected.\n\nFrequency: Daily. Typically 10-30 signals per day.\nExample: Protocol X: insider accumulation of $2.4M (47 transactions, 89% buys).","tags":["Smart Money & Insider Activity"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Insider Accumulation / Distribution signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/whale-cross-protocol":{"get":{"operationId":"signals_whale_cross_protocol","summary":"Whale Cross-Protocol Activity signals","description":"Identifies wallets with significant activity across many distinct protocols simultaneously, revealing sector-level thesis bets.\n\nWhy this matters: Sophisticated actors diversify across protocols within a thesis. Tracking their cross-protocol footprint reveals emerging sector narratives.\n\nInterpretation:\n- High score: Wallet active across 15+ protocols.\n- Moderate: Wallet spanning 10-14 protocols.\n- Low: Wallet across 8-9 protocols.\n\nFrequency: Daily. Typically 5-15 whale profiles per scan.\nExample: Wallet active across 18 protocols spanning DeFi lending and liquid staking sectors.","tags":["Smart Money & Insider Activity"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Whale Cross-Protocol Activity signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/sector-rotation":{"get":{"operationId":"signals_sector_rotation","summary":"Sector Capital Rotation signals","description":"Aggregates insider capital flows by market sector to detect early rotation between sectors.\n\nWhy this matters: Sector rotation by informed participants is one of the strongest leading indicators in crypto markets.\n\nInterpretation:\n- High score: Sector net flow >$5M with strong imbalance.\n- Moderate: Sector showing $1-5M net flow.\n- Low: Modest sector-level imbalance detected.\n\nFrequency: Daily. Typically 3-8 sector signals per scan.\nExample: DeFi Lending: net insider inflow of $8.2M (+34% imbalance, 156 transactions).","tags":["Smart Money & Insider Activity"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Sector Capital Rotation signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/flow-anomaly":{"get":{"operationId":"signals_flow_anomaly","summary":"Daily Flow Anomaly signals","description":"Statistical outlier detection on daily aggregate insider capital flows using z-scores against a 30-day rolling baseline.\n\nWhy this matters: Most days are noise. This signal identifies genuinely anomalous capital movements using statistical methods.\n\nInterpretation:\n- High score: Z-score >3 — a 3-sigma event.\n- Moderate: Z-score 2-3 — notably elevated activity.\n- Low: Z-score 1.5-2 — above-average but within broader variance.\n\nFrequency: Daily. Typically 2-5 anomaly signals per scan.\nExample: April 15: anomalous net outflow of $47M (z-score=+3.2, 892 transactions).","tags":["Smart Money & Insider Activity"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Daily Flow Anomaly signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/smart-money-divergence":{"get":{"operationId":"signals_smart_money_divergence","summary":"Smart Money Divergence signals","description":"Tracks the largest token holders and detects when their 30-day balance change exceeds 20%.\n\nWhy this matters: Top holders are the most informed and impactful participants. Their positioning precedes major price movements.\n\nInterpretation:\n- High score: Top holder balance change >40%.\n- Moderate: Top holder change 20-40%.\n- Low: Notable but smaller holder movement detected.\n\nFrequency: Daily. Typically 15-40 signals per scan.\nExample: Token Y: top holder (rank #1, 12.3% ownership) increased balance +34% over 30d.","tags":["Smart Money & Insider Activity"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Smart Money Divergence signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/co-investment-network":{"get":{"operationId":"signals_co_investment_network","summary":"Co-Investment Network signals","description":"Maps the investment graph to discover token pairs that share three or more investors.\n\nWhy this matters: Shared investors create hidden correlations — common capital, common incentives, and common information flow.\n\nInterpretation:\n- High score: 5+ shared investors — deeply interconnected tokens.\n- Moderate: 3-4 shared investors.\n- Low: Connection detected but with limited overlap.\n\nFrequency: Daily. Typically 200-500 co-investment pairs per scan.\nExample: Token A and Token B share 5 investors: Fund Alpha, Fund Beta, Fund Gamma.","tags":["Investment Graph Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Co-Investment Network signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/cross-sector-cluster":{"get":{"operationId":"signals_cross_sector_cluster","summary":"Cross-Sector Cluster signals","description":"Identifies communities of tokens that span three or more market sectors, revealing thematic investment theses.\n\nWhy this matters: The most valuable investment theses often span sectors. These cross-sector connections are only visible through graph analysis.\n\nInterpretation:\n- High score: 5+ sectors represented — broad macro thesis.\n- Moderate: 3-4 sectors — meaningful cross-sector connection.\n- Low: Cluster detected with borderline sector diversity.\n\nFrequency: Daily. Typically 10-30 clusters per scan.\nExample: Cluster of 8 tokens spans 4 sectors: DeFi Lending (3), L1 (2), Liquid Staking (2), Oracle (1).","tags":["Investment Graph Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Cross-Sector Cluster signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/bridge-fund":{"get":{"operationId":"signals_bridge_fund","summary":"Bridge Fund Detection signals","description":"Computes network centrality metrics for every fund in the investment graph, identifying funds that connect otherwise separate clusters.\n\nWhy this matters: Bridge funds are kingmakers. Their investment in a new project instantly connects it to multiple existing clusters.\n\nInterpretation:\n- High score: Very high betweenness centrality — connects many separate communities.\n- Moderate: Notable bridging position in the graph.\n- Low: Moderate bridging detected.\n\nFrequency: Daily. Typically 5-15 bridge funds identified per scan.\nExample: Fund Z: PageRank=0.0082, Betweenness=0.034. Connects 4 isolated token clusters.","tags":["Investment Graph Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Bridge Fund Detection signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/developer-network":{"get":{"operationId":"signals_developer_network","summary":"Shared Developer Network signals","description":"Analyzes code repositories to find projects sharing the same developers and identifies bus factor risk.\n\nWhy this matters: Developer talent is the scarcest resource in crypto. Shared developers indicate code dependencies and correlated risk.\n\nInterpretation:\n- High score: 10+ shared developers — deep technical interdependence.\n- Moderate: 5-9 shared developers or 1-2 contributor concentration.\n- Low: Minor developer overlap or moderate concentration.\n\nFrequency: Daily. Typically 50-100 overlap pairs per scan.\nExample: Token A and Token B share 12 GitHub contributors. Token C has only 1 active contributor.","tags":["Investment Graph Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Shared Developer Network signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/yield-anomaly":{"get":{"operationId":"signals_yield_anomaly","summary":"Yield Anomaly signals","description":"Detects unusual APY spikes or collapses in DeFi pools, filtered to pools with >$500K TVL.\n\nWhy this matters: Sudden yield changes are early warnings of incentive programs, exploits, or smart money exits.\n\nInterpretation:\n- High score: APY change >500% — extreme event.\n- Moderate: APY change 200-500% — significant shift.\n- Low: APY change 100-200% — notable but may be within normal volatility.\n\nFrequency: Daily. Typically 5-20 yield anomalies per scan.\nExample: Pool XYZ: APY collapsed -340% in 7d (current: 2.1%, TVL: $4.2M).","tags":["DeFi Risk & Opportunity"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Yield Anomaly signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/yield-sustainability":{"get":{"operationId":"signals_yield_sustainability","summary":"Yield Sustainability signals","description":"Identifies pools where reward token emissions drive the majority of yield (reward APY > 5x base APY).\n\nWhy this matters: When reward APY is 10-20x the organic yield, the pool is a token distribution mechanism disguised as a yield opportunity.\n\nInterpretation:\n- High score: Reward/base ratio >15x — almost entirely emissions.\n- Moderate: Reward/base ratio 8-15x — emission-heavy.\n- Low: Reward/base ratio 5-8x — elevated emission dependence.\n\nFrequency: Daily. Typically 10-30 sustainability warnings per scan.\nExample: Pool ABC: reward APY (42.5%) is 17x base APY (2.5%). TVL: $2.8M.","tags":["DeFi Risk & Opportunity"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Yield Sustainability signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/utilization-stress":{"get":{"operationId":"signals_utilization_stress","summary":"Utilization Stress signals","description":"Monitors lending protocol utilization rates and flags when utilization exceeds 85%.\n\nWhy this matters: Utilization above 85% means lenders cannot withdraw and borrowing rates spike as the interest rate curve enters its steep zone.\n\nInterpretation:\n- High score: Utilization >95% — critical liquidity stress.\n- Moderate: Utilization 90-95% — danger zone.\n- Low: Utilization 85-90% — approaching stress threshold.\n\nFrequency: Daily. Typically 5-15 protocols flagged per scan.\nExample: Protocol X: utilization at 93.2% ($1.8B borrowed of $1.93B deposited).","tags":["DeFi Risk & Opportunity"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Utilization Stress signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/debt-ceiling-proximity":{"get":{"operationId":"signals_debt_ceiling_proximity","summary":"Debt Ceiling Proximity signals","description":"Detects DeFi lending pools where total borrowing is approaching the governance-set debt ceiling.\n\nWhy this matters: Debt ceilings are hard limits. When a pool is at 95% of its ceiling, rate spikes and failed transactions follow.\n\nInterpretation:\n- High score: Usage >95% of ceiling — borrowing nearly halted.\n- Moderate: Usage 90-95% — ceiling approaching.\n- Low: Usage 85-90% — governance action may be needed.\n\nFrequency: Daily. Typically 3-10 pools flagged per scan.\nExample: Pool USDC-ETH: borrowing $48.2M of $50M ceiling (96.4% used).","tags":["DeFi Risk & Opportunity"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Debt Ceiling Proximity signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/stablecoin-depeg":{"get":{"operationId":"signals_stablecoin_depeg","summary":"Stablecoin Peg Deviation signals","description":"Monitors stablecoin prices for deviations from their target peg, flagging >0.5% deviation with >$1M supply.\n\nWhy this matters: Stablecoin depegging is a systemic risk event that cascades through lending protocols, DEX pools, and payment systems.\n\nInterpretation:\n- High score: Deviation >2% — active depegging event.\n- Moderate: Deviation 1-2% — significant peg stress.\n- Low: Deviation 0.5-1% — elevated but may be transient.\n\nFrequency: Daily. Typically 2-8 depeg alerts per scan.\nExample: Stablecoin Z: trading at $0.9847 (1.53% below peg). Circulating: $340M.","tags":["DeFi Risk & Opportunity"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Stablecoin Peg Deviation signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/stablecoin-supply-shift":{"get":{"operationId":"signals_stablecoin_supply_shift","summary":"Stablecoin Supply Shift signals","description":"Detects large week-over-week changes in stablecoin circulating supply (>10% with >$1M circulation).\n\nWhy this matters: Stablecoin supply is a proxy for capital entering and exiting the crypto ecosystem, preceding market movements.\n\nInterpretation:\n- High score: Supply change >30% — massive capital flow.\n- Moderate: Supply change 15-30% — significant flow.\n- Low: Supply change 10-15% — notable.\n\nFrequency: Daily. Typically 5-15 supply shift signals per scan.\nExample: Stablecoin W: supply expanded +22% week-over-week ($180M increase).","tags":["DeFi Risk & Opportunity"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Stablecoin Supply Shift signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/revenue-momentum":{"get":{"operationId":"signals_revenue_momentum","summary":"Revenue Momentum signals","description":"Tracks protocol revenue acceleration by comparing 30-day and 90-day revenue change rates.\n\nWhy this matters: Revenue is the most honest metric in crypto. Unlike TVL or users, revenue represents real value extraction.\n\nInterpretation:\n- High score: Revenue accelerating >100% in 30d on strong 90d trend.\n- Moderate: 30d revenue growth >50% diverging from 90d.\n- Low: Modest momentum shift detected.\n\nFrequency: Daily. Typically 10-25 momentum signals per scan.\nExample: Protocol A: revenue accelerating — 30d +82% vs 90d +35%.","tags":["Protocol Fundamentals"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Revenue Momentum signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/earnings-health":{"get":{"operationId":"signals_earnings_health","summary":"Earnings Health signals","description":"Identifies protocols with deeply negative earnings (daily losses >$10K) that are worsening or improving.\n\nWhy this matters: Worsening losses with no revenue growth signals a death spiral. Improving losses signal a potential turnaround.\n\nInterpretation:\n- High score: Losses >$100K/day and worsening.\n- Moderate: Losses $10-100K/day.\n- Low: Modest loss improvement detected.\n\nFrequency: Daily. Typically 15-30 earnings signals per scan.\nExample: Protocol B: earnings deeply negative at -$82K/day and worsening (+15% losses in 30d).","tags":["Protocol Fundamentals"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Earnings Health signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/usage-price-mismatch":{"get":{"operationId":"signals_usage_price_mismatch","summary":"Usage-Price Mismatch signals","description":"Detects divergence between user growth and price movement.\n\nWhy this matters: Users growing while price falls suggests undervaluation. Price rising without users suggests fragile speculative premium.\n\nInterpretation:\n- High score: Users and price diverging >40%.\n- Moderate: Divergence 20-40%.\n- Low: Mild divergence detected.\n\nFrequency: Daily. Typically 10-20 mismatch signals per scan.\nExample: Protocol C: active users +28% but price -14% over 30d.","tags":["Protocol Fundamentals"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Usage-Price Mismatch signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/capital-efficiency":{"get":{"operationId":"signals_capital_efficiency","summary":"Capital Efficiency signals","description":"Compares fee/revenue growth against TVL growth to identify improving or deteriorating capital efficiency.\n\nWhy this matters: TVL alone is misleading. Capital efficiency reveals whether locked capital is actually productive.\n\nInterpretation:\n- High score: Fee growth outpacing TVL by >50%.\n- Moderate: Meaningful divergence between fee and TVL trends.\n- Low: Mild efficiency shift detected.\n\nFrequency: Daily. Typically 10-20 efficiency signals per scan.\nExample: Protocol D: fees +47% while TVL +8% over 30d.","tags":["Protocol Fundamentals"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Capital Efficiency signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/treasury-health":{"get":{"operationId":"signals_treasury_health","summary":"Treasury Health signals","description":"Analyzes protocol treasuries for concentration (>80% own tokens) and runway (non-own reserves vs operational costs).\n\nWhy this matters: A treasury dominated by own tokens provides only circular value. Selling to fund operations crashes the price.\n\nInterpretation:\n- High score: Own tokens >95% or runway <90 days.\n- Moderate: Own tokens 80-95% or runway 90-180 days.\n- Low: Treasury showing some concentration or limited runway.\n\nFrequency: Daily. Typically 10-25 signals per scan.\nExample: Protocol E: 94% of $180M treasury is own tokens. Non-own reserves: $10.8M.","tags":["Protocol Fundamentals"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Treasury Health signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/governance-apathy":{"get":{"operationId":"signals_governance_apathy","summary":"Governance Apathy signals","description":"Flags governance proposals with extremely low voter turnout.\n\nWhy this matters: Low participation means decisions affecting billions in TVL are made by a handful of voters, creating governance capture risk.\n\nInterpretation:\n- High score: Turnout <1% — governance is effectively unguarded.\n- Moderate: Turnout 1-3%.\n- Low: Turnout 3-5% — below healthy levels.\n\nFrequency: Daily. Typically 5-15 apathy signals per scan.\nExample: DAO X: proposal with only 23 voters. A $500M decision made by 23 people.","tags":["Governance Risk"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Governance Apathy signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/controversial-proposal":{"get":{"operationId":"signals_controversial_proposal","summary":"Controversial Proposal signals","description":"Detects governance proposals passing with razor-thin margins (<20% vote margin).\n\nWhy this matters: Narrow margins mean nearly half the community disagrees — creating fork risk, reversal proposals, or fragmentation.\n\nInterpretation:\n- High score: Margin <5% — extremely contentious, fork risk.\n- Moderate: Margin 5-12% — significant division.\n- Low: Margin 12-20% — contested but with a working majority.\n\nFrequency: Daily. Typically 3-10 controversial proposals per scan.\nExample: DAO Y: proposal passed with 52.3% margin (1.2M for vs 1.1M against).","tags":["Governance Risk"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Controversial Proposal signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/power-concentration":{"get":{"operationId":"signals_power_concentration","summary":"Power Concentration signals","description":"Measures governance power concentration through delegate and holder concentration metrics.\n\nWhy this matters: When 5 holders control 60% of tokens, governance is centralized in practice despite decentralized branding.\n\nInterpretation:\n- High score: Top 5 holders >70% of supply — extreme concentration.\n- Moderate: Top 5 holders 50-70%.\n- Low: Notable but less extreme concentration.\n\nFrequency: Daily. Typically 20-40 concentration signals per scan.\nExample: Protocol F: top 5 holders own 62.4% of supply (largest: 28.1%).","tags":["Governance Risk"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Power Concentration signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/unlock-pressure":{"get":{"operationId":"signals_unlock_pressure","summary":"Unlock Pressure signals","description":"Identifies tokens with upcoming unlock events releasing >5% of circulating supply.\n\nWhy this matters: Token unlocks are the most predictable supply shocks in crypto. Recipients (usually VCs/team) may sell.\n\nInterpretation:\n- High score: Unlock >15% of circulating — extreme supply shock.\n- Moderate: Unlock 8-15% — significant supply event.\n- Low: Unlock 5-8% — notable but manageable.\n\nFrequency: Daily. Typically 10-25 unlock alerts per scan.\nExample: Token G: next unlock = 45M tokens (12.3% of circulating, ~$18M) in 14 days.","tags":["Token Lifecycle Risk"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Unlock Pressure signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/cluster-unlock-risk":{"get":{"operationId":"signals_cluster_unlock_risk","summary":"Cluster Unlock Risk signals","description":"Detects when multiple tokens within the same investment cluster have simultaneous upcoming unlocks.\n\nWhy this matters: Correlated unlock timing creates compounding selling pressure that simple unlock calendars miss.\n\nInterpretation:\n- High score: Combined unlock >15% across a co-invested cluster.\n- Moderate: Combined unlock 8-15% across cluster.\n- Low: Modest coordinated unlock detected.\n\nFrequency: Daily. Typically 2-8 cluster unlock alerts per scan.\nExample: Cluster 7: 4 co-invested tokens with upcoming unlocks totaling 11.2% of circulating.","tags":["Token Lifecycle Risk"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Cluster Unlock Risk signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/exchange-liquidity-risk":{"get":{"operationId":"signals_exchange_liquidity_risk","summary":"Exchange Liquidity Risk signals","description":"Identifies tokens available on very few exchanges (1-2) or with wide bid-ask spreads (>2%).\n\nWhy this matters: Low exchange coverage means liquidity risk and deplatforming risk. Wide spreads tax every transaction.\n\nInterpretation:\n- High score: Single exchange with wide spread — severe risk.\n- Moderate: 2 exchanges or spread >3%.\n- Low: Moderate exchange concentration or elevated spreads.\n\nFrequency: Daily. Typically 15-40 liquidity risk signals per scan.\nExample: Token H: listed on only 1 exchange with $340K 24h volume. Spread 4.2%.","tags":["Token Lifecycle Risk"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Exchange Liquidity Risk signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/convergence-alert":{"get":{"operationId":"signals_convergence_alert","summary":"Convergence Alert signals","description":"Detects when an entity triggers 3+ independent signal types from different analytical domains simultaneously.\n\nWhy this matters: Individual signals can be noisy. Convergence from independent domains drops false positive probability dramatically.\n\nInterpretation:\n- High score: 5+ signal types converging.\n- Moderate: 4 signal types converging.\n- Low: 3 signal types converging.\n\nFrequency: Daily. Typically 30-60 convergence alerts per scan.\nExample: Protocol J: 4 signal types converge — insider_flow, utilization_risk, governance_apathy, yield_anomaly.","tags":["Cross-Domain Convergence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Convergence Alert signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/insights/signals/narrative-synthesis":{"get":{"operationId":"signals_narrative_synthesis","summary":"Narrative Synthesis signals","description":"AI-synthesized briefings connecting multiple signals into actionable context with explicit evidence chains.\n\nWhy this matters: Raw signals require interpretation. Narrative synthesis saves hours of manual analysis and surfaces connections analysts might miss.\n\nInterpretation:\n- High score: Urgent narratives — active depegs, large insider selling, governance closing within 48h.\n- Moderate: Watchlist narratives — developing situations.\n- Low: Informational narratives — context for portfolio review.\n\nFrequency: Daily. 15 AI-synthesized narratives per scan.\nExample: HEADLINE: Lending Protocol Under Multi-Dimensional Stress. Utilization 93.2%, insiders sold $3.2M, governance vote closes in 36h.","tags":["Cross-Domain Convergence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"since_hours","in":"query","schema":{"type":"number","default":72},"description":"Look back window in hours"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Maximum signals to return"},{"name":"qualification","in":"query","schema":{"type":"string","enum":["qualified","screened","pending","rejected","all"],"default":"qualified"},"description":"Filter by qualification status"}],"responses":{"200":{"description":"Narrative Synthesis signals with evidence","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"signal_id":{"type":"string"},"signal_type":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"evidence":{"type":"object"},"created_at":{"type":"string"},"qualification":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}}}}