{"components":{"securitySchemes":{"x402Payment":{"description":"x402 payment signature/authorization returned by the agent wallet after receiving HTTP 402.","in":"header","name":"PAYMENT-SIGNATURE","type":"apiKey"}}},"info":{"description":"Agent-native Smart Wallet and Smart Money aggregate intelligence. No raw trades/transfers; pay per successful request with USDC via x402.","title":"SQLBlock API","version":"0.2.0"},"openapi":"3.1.0","paths":{"/v1/copy/intents":{"get":{"description":"Execute-grade CopyIntents derived from elite leaders' 5m token flow: directional buy/sell per (leader, token, day), stables excluded. Feed this to a paper or live executor. Default lookback=24h.","operationId":"v1_copy_intents","parameters":[{"description":"Blockchain to query. Address format is chain-native: 0x hex for EVM chains (base, ethereum, bnb, polygon), base58 for solana.","in":"query","name":"chain","required":true,"schema":{"enum":["base","ethereum","bnb","polygon","solana"],"type":"string"}},{"description":"Elite activity gate window in hours.","in":"query","name":"window","required":false,"schema":{"default":168,"maximum":1000,"minimum":1,"type":"integer"}},{"description":"How far back to emit intents, in hours.","in":"query","name":"lookback","required":false,"schema":{"default":24,"maximum":1000,"minimum":1,"type":"integer"}},{"description":"Maximum intents to return.","in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":1000,"minimum":1,"type":"integer"}},{"description":"Return a free x402 cost estimate envelope without querying or charging.","in":"query","name":"estimate_cost","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Successful paid SQLBlock response or free estimate when estimate_cost=true."},"400":{"description":"Invalid or missing query parameter."},"402":{"description":"x402 payment challenge. Sign/pay locally, then retry the exact same request with PAYMENT-SIGNATURE."}},"security":[{"x402Payment":[]}],"summary":"Get copy-trade intents","x-x402":{"amount_atomic":"50000","amount_usdc":0.05,"asset":"USDC","billing_unit":"successful_request","network":"Base","tier":"exposure"}}},"/v1/copy/leaders":{"get":{"description":"Wallets that clear elite copy gates (copyable size, real track record, diversified, active). Same eligibility as the admin elite board — the leader pool for copy-trading. Default observation window=168h (1w).","operationId":"v1_copy_leaders","parameters":[{"description":"Blockchain to query. Address format is chain-native: 0x hex for EVM chains (base, ethereum, bnb, polygon), base58 for solana.","in":"query","name":"chain","required":true,"schema":{"enum":["base","ethereum","bnb","polygon","solana"],"type":"string"}},{"description":"Observation window in hours (activity + ROI trend). Common: 24, 72, 168, 336, 720.","in":"query","name":"window","required":false,"schema":{"default":168,"maximum":1000,"minimum":1,"type":"integer"}},{"description":"Maximum leaders to return.","in":"query","name":"limit","required":false,"schema":{"default":20,"maximum":1000,"minimum":1,"type":"integer"}},{"description":"Return a free x402 cost estimate envelope without querying or charging.","in":"query","name":"estimate_cost","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Successful paid SQLBlock response or free estimate when estimate_cost=true."},"400":{"description":"Invalid or missing query parameter."},"402":{"description":"x402 payment challenge. Sign/pay locally, then retry the exact same request with PAYMENT-SIGNATURE."}},"security":[{"x402Payment":[]}],"summary":"Get copy-trade leaders","x-x402":{"amount_atomic":"50000","amount_usdc":0.05,"asset":"USDC","billing_unit":"successful_request","network":"Base","tier":"exposure"}}},"/v1/copy/paper":{"get":{"description":"Simulate following one leader's buy signals over N days at a fixed notional: entry at signal-day guarded price, mark to latest later price. Returns per-trade fills + summary PnL. No orders placed.","operationId":"v1_copy_paper","parameters":[{"description":"Blockchain to query. Address format is chain-native: 0x hex for EVM chains (base, ethereum, bnb, polygon), base58 for solana.","in":"query","name":"chain","required":true,"schema":{"enum":["base","ethereum","bnb","polygon","solana"],"type":"string"}},{"description":"Leader wallet address to paper-copy.","in":"query","name":"leader","required":true,"schema":{"type":"string"}},{"description":"Lookback days for paper fills.","in":"query","name":"days","required":false,"schema":{"default":7,"maximum":1000,"minimum":1,"type":"integer"}},{"description":"Fixed paper notional USD per buy signal (default 100).","in":"query","name":"size_usd","required":false,"schema":{"type":"number"}},{"description":"Return a free x402 cost estimate envelope without querying or charging.","in":"query","name":"estimate_cost","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Successful paid SQLBlock response or free estimate when estimate_cost=true."},"400":{"description":"Invalid or missing query parameter."},"402":{"description":"x402 payment challenge. Sign/pay locally, then retry the exact same request with PAYMENT-SIGNATURE."}},"security":[{"x402Payment":[]}],"summary":"Paper-copy a leader","x-x402":{"amount_atomic":"50000","amount_usdc":0.05,"asset":"USDC","billing_unit":"successful_request","network":"Base","tier":"exposure"}}},"/v1/smart-money/activity":{"get":{"description":"Short-window activity feed: where smart wallets are suddenly active. Default window=15m.","operationId":"v1_smart_money_activity","parameters":[{"description":"Blockchain to query. Address format is chain-native: 0x hex for EVM chains (base, ethereum, bnb, polygon), base58 for solana.","in":"query","name":"chain","required":true,"schema":{"enum":["base","ethereum","bnb","polygon","solana"],"type":"string"}},{"description":"Short activity window.","in":"query","name":"window","required":false,"schema":{"default":"15m","enum":["5m","15m","1h"],"type":"string"}},{"description":"all_smart, Smart Trader, Early Accumulator, Whale, or High Conviction.","in":"query","name":"cohort","required":false,"schema":{"type":"string"}},{"description":"Maximum tokens to return.","in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":1000,"minimum":1,"type":"integer"}},{"description":"Return a free x402 cost estimate envelope without querying or charging.","in":"query","name":"estimate_cost","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Successful paid SQLBlock response or free estimate when estimate_cost=true."},"400":{"description":"Invalid or missing query parameter."},"402":{"description":"x402 payment challenge. Sign/pay locally, then retry the exact same request with PAYMENT-SIGNATURE."}},"security":[{"x402Payment":[]}],"summary":"Get smart money activity","x-x402":{"amount_atomic":"50000","amount_usdc":0.05,"asset":"USDC","billing_unit":"successful_request","network":"Base","tier":"flow"}}},"/v1/smart-money/backtest":{"get":{"description":"Track record transparency: the cohort's own realized P&L (median ROI, profitable share -- wallets that round-tripped inside the observation window) plus the forward-signal curve (if you copied the daily net-buy signal, median price move 1-3 days later). Two honestly-separated metrics with sample sizes and an explicit ~2-week-window disclaimer.","operationId":"v1_smart_money_backtest","parameters":[{"description":"Blockchain to query. Address format is chain-native: 0x hex for EVM chains (base, ethereum, bnb, polygon), base58 for solana.","in":"query","name":"chain","required":true,"schema":{"enum":["base","ethereum","bnb","polygon","solana"],"type":"string"}},{"description":"Return a free x402 cost estimate envelope without querying or charging.","in":"query","name":"estimate_cost","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Successful paid SQLBlock response or free estimate when estimate_cost=true."},"400":{"description":"Invalid or missing query parameter."},"402":{"description":"x402 payment challenge. Sign/pay locally, then retry the exact same request with PAYMENT-SIGNATURE."}},"security":[{"x402Payment":[]}],"summary":"Get smart money backtest","x-x402":{"amount_atomic":"50000","amount_usdc":0.05,"asset":"USDC","billing_unit":"successful_request","network":"Base","tier":"exposure"}}},"/v1/smart-money/netflow":{"get":{"description":"Smart-wallet cohort net buying/selling by token. Default window=1h.","operationId":"v1_smart_money_netflow","parameters":[{"description":"Blockchain to query. Address format is chain-native: 0x hex for EVM chains (base, ethereum, bnb, polygon), base58 for solana.","in":"query","name":"chain","required":true,"schema":{"enum":["base","ethereum","bnb","polygon","solana"],"type":"string"}},{"description":"Netflow window.","in":"query","name":"window","required":false,"schema":{"default":"1h","enum":["15m","1h","4h","24h"],"type":"string"}},{"description":"all_smart, Smart Trader, Early Accumulator, Whale, or High Conviction.","in":"query","name":"cohort","required":false,"schema":{"type":"string"}},{"description":"Maximum tokens to return.","in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":1000,"minimum":1,"type":"integer"}},{"description":"Return a free x402 cost estimate envelope without querying or charging.","in":"query","name":"estimate_cost","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Successful paid SQLBlock response or free estimate when estimate_cost=true."},"400":{"description":"Invalid or missing query parameter."},"402":{"description":"x402 payment challenge. Sign/pay locally, then retry the exact same request with PAYMENT-SIGNATURE."}},"security":[{"x402Payment":[]}],"summary":"Get smart money netflow","x-x402":{"amount_atomic":"50000","amount_usdc":0.05,"asset":"USDC","billing_unit":"successful_request","network":"Base","tier":"flow"}}},"/v1/smart-money/signals":{"get":{"description":"One-call copy-trade board: the tokens the smart cohort is net-buying right now (ranked by conviction, stablecoins excluded, with buyer/seller quality and acceleration), plus the chain-wide historical conviction -- how this cohort's net-buy signal has paid off 1/2/3 days forward. Answers 'what are they buying' and 'has following them worked' in a single response. Default window=1h.","operationId":"v1_smart_money_signals","parameters":[{"description":"Blockchain to query. Address format is chain-native: 0x hex for EVM chains (base, ethereum, bnb, polygon), base58 for solana.","in":"query","name":"chain","required":true,"schema":{"enum":["base","ethereum","bnb","polygon","solana"],"type":"string"}},{"description":"Signal window.","in":"query","name":"window","required":false,"schema":{"default":"1h","enum":["15m","1h","4h","24h"],"type":"string"}},{"description":"Maximum tokens to return.","in":"query","name":"limit","required":false,"schema":{"default":30,"maximum":1000,"minimum":1,"type":"integer"}},{"description":"Return a free x402 cost estimate envelope without querying or charging.","in":"query","name":"estimate_cost","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Successful paid SQLBlock response or free estimate when estimate_cost=true."},"400":{"description":"Invalid or missing query parameter."},"402":{"description":"x402 payment challenge. Sign/pay locally, then retry the exact same request with PAYMENT-SIGNATURE."}},"security":[{"x402Payment":[]}],"summary":"Get smart money signals (copy-trade board)","x-x402":{"amount_atomic":"50000","amount_usdc":0.05,"asset":"USDC","billing_unit":"successful_request","network":"Base","tier":"exposure"}}},"/v1/smart-wallets":{"get":{"description":"Rank behavior-derived smart wallets by six-dimensional DNA. Default profile window is 30d.","operationId":"v1_smart_wallets","parameters":[{"description":"Blockchain to query. Address format is chain-native: 0x hex for EVM chains (base, ethereum, bnb, polygon), base58 for solana.","in":"query","name":"chain","required":true,"schema":{"enum":["base","ethereum","bnb","polygon","solana"],"type":"string"}},{"description":"Minimum smart_score, default 50.","in":"query","name":"min_score","required":false,"schema":{"type":"number"}},{"description":"Optional behavior tag such as Smart Trader, Early Accumulator, Whale, High Conviction.","in":"query","name":"behavior","required":false,"schema":{"type":"string"}},{"description":"Maximum wallets to return.","in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":1000,"minimum":1,"type":"integer"}},{"description":"Return a free x402 cost estimate envelope without querying or charging.","in":"query","name":"estimate_cost","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Successful paid SQLBlock response or free estimate when estimate_cost=true."},"400":{"description":"Invalid or missing query parameter."},"402":{"description":"x402 payment challenge. Sign/pay locally, then retry the exact same request with PAYMENT-SIGNATURE."}},"security":[{"x402Payment":[]}],"summary":"Discover smart wallets","x-x402":{"amount_atomic":"30000","amount_usdc":0.03,"asset":"USDC","billing_unit":"successful_request","network":"Base","tier":"wallet"}}},"/v1/token/smart-exposure":{"get":{"description":"Single-token summary of smart holders, short-window smart flow, buyer/seller quality, state, and rule-generated signals.","operationId":"v1_token_smart_exposure","parameters":[{"description":"Blockchain to query. Address format is chain-native: 0x hex for EVM chains (base, ethereum, bnb, polygon), base58 for solana.","in":"query","name":"chain","required":true,"schema":{"enum":["base","ethereum","bnb","polygon","solana"],"type":"string"}},{"description":"Token address (0x contract for EVM chains, base58 mint for solana) or SQLBlock demo token id.","in":"query","name":"token_address","required":true,"schema":{"type":"string"}},{"description":"Return a free x402 cost estimate envelope without querying or charging.","in":"query","name":"estimate_cost","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Successful paid SQLBlock response or free estimate when estimate_cost=true."},"400":{"description":"Invalid or missing query parameter."},"402":{"description":"x402 payment challenge. Sign/pay locally, then retry the exact same request with PAYMENT-SIGNATURE."}},"security":[{"x402Payment":[]}],"summary":"Get token smart exposure","x-x402":{"amount_atomic":"50000","amount_usdc":0.05,"asset":"USDC","billing_unit":"successful_request","network":"Base","tier":"exposure"}}},"/v1/wallet/dna":{"get":{"description":"Six-dimensional behavior profile for one wallet, with evidence and recent aggregate activity. Pass trajectory=true to also get the wallet's daily smart_score history (score_trajectory, real retained series) and per-day trading activity (activity_trajectory, rebuilt from full flow history).","operationId":"v1_wallet_dna","parameters":[{"description":"Blockchain to query. Address format is chain-native: 0x hex for EVM chains (base, ethereum, bnb, polygon), base58 for solana.","in":"query","name":"chain","required":true,"schema":{"enum":["base","ethereum","bnb","polygon","solana"],"type":"string"}},{"description":"Wallet address (0x hex for EVM chains, base58 for solana) or SQLBlock demo wallet id.","in":"query","name":"wallet","required":true,"schema":{"type":"string"}},{"description":"Include daily smart_score and activity history for this wallet.","in":"query","name":"trajectory","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Return a free x402 cost estimate envelope without querying or charging.","in":"query","name":"estimate_cost","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Successful paid SQLBlock response or free estimate when estimate_cost=true."},"400":{"description":"Invalid or missing query parameter."},"402":{"description":"x402 payment challenge. Sign/pay locally, then retry the exact same request with PAYMENT-SIGNATURE."}},"security":[{"x402Payment":[]}],"summary":"Get wallet DNA","x-x402":{"amount_atomic":"30000","amount_usdc":0.03,"asset":"USDC","billing_unit":"successful_request","network":"Base","tier":"wallet"}}}},"servers":[{"url":"https://block0.xyz"}],"tags":[{"description":"Discover and profile behavior-derived smart wallets.","name":"Smart Wallets"},{"description":"Short-window aggregate activity and netflow from smart-wallet cohorts.","name":"Smart Money"},{"description":"Token-level exposure to smart wallets and smart-money flows.","name":"Token Exposure"}]}