{"openapi":"3.1.0","info":{"title":"BTC Node API — Bitcoin + Data + SEC + Scrape + AI + Reddit","version":"3.1.0","description":"Bitcoin blockchain data, address portfolio, transaction tracing, fee forecasting, whale monitoring, SEC EDGAR filings, URL scraping, AI summarization, and Reddit API via x402 micropayments on Base.","x-guidance":"Phase 3 API. Bitcoin endpoints ($0.001-0.005): fees, mempool, info, tx lookup, address portfolio, transaction trace, fee forecast, whale monitor. SEC insider trades ($0.005), URL scraping ($0.001), AI summarization ($0.001). Reddit API ($0.001): hot posts, search, comments, trending. All via x402 micropayments on Base network."},"paths":{"/api/fees":{"get":{"operationId":"getFees","summary":"Bitcoin fee rate estimates","tags":["Bitcoin"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Fee rates in sat/vB","content":{"application/json":{"schema":{"type":"object","properties":{"high":{"type":"number"},"medium":{"type":"number"},"low":{"type":"number"},"unit":{"type":"string"},"updated_at":{"type":"string"},"success":{"type":"boolean"}},"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/mempool":{"get":{"operationId":"getMempool","summary":"Mempool pending transactions","tags":["Bitcoin"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Mempool info","content":{"application/json":{"schema":{"type":"object","properties":{"pending_tx":{"type":"number"},"mempool_mb":{"type":"string"},"success":{"type":"boolean"}},"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/info":{"get":{"operationId":"getNodeInfo","summary":"Bitcoin node information","tags":["Bitcoin"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Node info","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"blocks":{"type":"number"},"difficulty":{"type":"number"},"connections":{"type":"number"},"success":{"type":"boolean"}},"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/tx/{hash}":{"get":{"operationId":"getTransaction","summary":"Bitcoin transaction details","tags":["Bitcoin"],"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-fA-F0-9]{64}$","description":"Bitcoin transaction hash (64 hex chars)"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hash":{"type":"string","pattern":"^[a-fA-F0-9]{64}$","description":"Bitcoin transaction hash (64 hex chars)"}},"required":["hash"],"additionalProperties":false}}}},"responses":{"200":{"description":"Transaction status","content":{"application/json":{"schema":{"type":"object","properties":{"txid":{"type":"string"},"confirmations":{"type":"number"},"block_height":{"type":"number"},"success":{"type":"boolean"}},"additionalProperties":false}}}},"400":{"description":"Invalid hash"},"402":{"description":"Payment Required"}}}},"/api/sec/insider/{ticker}":{"get":{"operationId":"getInsiderTrades","summary":"Insider trades for a ticker","tags":["SEC"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Z]{1,5}$"}},{"name":"limit","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Insider trades"},"402":{"description":"Payment Required"}}}},"/api/scrape":{"post":{"operationId":"scrapeUrl","summary":"Scrape URL to clean text","tags":["Scrape"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"forceFresh":{"type":"boolean"},"maxChars":{"type":"integer"}},"required":["url"]}}}},"responses":{"200":{"description":"Scraped content"},"402":{"description":"Payment Required"}}}},"/api/summarize":{"post":{"operationId":"summarizeText","summary":"AI text summarization via local LLM","tags":["AI"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"maxLength":{"type":"integer","default":200}},"required":["text"]}}}},"responses":{"200":{"description":"Summary"},"402":{"description":"Payment Required"}}}},"/api/addr/{address}":{"get":{"operationId":"getAddressInfo","summary":"Bitcoin address portfolio","tags":["Bitcoin"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","description":"Bitcoin address (legacy, segwit, bech32)"}}],"responses":{"200":{"description":"Address portfolio — balance, UTXOs, tx count"},"402":{"description":"Payment Required"}}}},"/api/trace/{txid}":{"get":{"operationId":"traceTransaction","summary":"Bitcoin transaction trace","tags":["Bitcoin"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"parameters":[{"name":"txid","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}},{"name":"depth","in":"query","schema":{"type":"integer","default":1,"maximum":2}}],"responses":{"200":{"description":"Transaction trace with hop analysis"},"402":{"description":"Payment Required"}}}},"/api/fees/predict":{"get":{"operationId":"getFeeForecast","summary":"Bitcoin fee forecast","tags":["Bitcoin"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Fee forecast — current fees + next 3 block predictions"},"402":{"description":"Payment Required"}}}},"/api/whales":{"get":{"operationId":"getWhaleTxs","summary":"Bitcoin whale transactions","tags":["Bitcoin"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"parameters":[{"name":"min_btc","in":"query","schema":{"type":"number","default":100,"minimum":10}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":100}}],"responses":{"200":{"description":"Whale transactions in mempool"},"402":{"description":"Payment Required"}}}},"/api/reddit/hot/{subreddit}":{"get":{"operationId":"getRedditHot","summary":"Reddit hot posts","tags":["Reddit"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"parameters":[{"name":"subreddit","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"Hot posts from subreddit"},"402":{"description":"Payment Required"}}}},"/api/reddit/search":{"get":{"operationId":"searchReddit","summary":"Search Reddit","tags":["Reddit"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}},{"name":"sort","in":"query","schema":{"type":"string","enum":["relevance","new","top","hot","comments"],"default":"relevance"}},{"name":"time","in":"query","schema":{"type":"string","enum":["hour","day","week","month","year","all"],"default":"all"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}},{"name":"subreddit","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Search results"},"402":{"description":"Payment Required"}}}},"/api/reddit/comments/{postId}":{"get":{"operationId":"getRedditComments","summary":"Reddit post comments","tags":["Reddit"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"parameters":[{"name":"postId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":100}}],"responses":{"200":{"description":"Post comments"},"402":{"description":"Payment Required"}}}},"/api/reddit/trending":{"get":{"operationId":"getRedditTrending","summary":"Reddit trending","tags":["Reddit"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Trending from r/popular"},"402":{"description":"Payment Required"}}}}}}