{"components":{"securitySchemes":{"BearerAuth":{"bearerFormat":"swi_live_<keyid>_<secret>","scheme":"bearer","type":"http"}}},"info":{"contact":{"url":"https://btcwhalealerts.com"},"description":"Real-time Bitcoin on-chain intelligence: whale transactions, address metrics, sentiment. All endpoints require Bearer token. Rate limit 100k req/month for Research tier.","license":{"name":"Commercial"},"title":"Swiss Whale Intelligence API","version":"1.0.0"},"openapi":"3.0.3","paths":{"/address/{addr}":{"get":{"parameters":[{"in":"path","name":"addr","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Aggregated address metrics"}},"summary":"Address metrics"}},"/ping":{"get":{"responses":{"200":{"description":"ok"}},"security":[],"summary":"Health"}},"/sentiment":{"get":{"parameters":[{"in":"query","name":"hours","schema":{"default":24,"maximum":720,"type":"integer"}}],"responses":{"200":{"description":"Overall + per-platform sentiment"}},"summary":"Confidence-weighted community sentiment"}},"/stats":{"get":{"responses":{"200":{"description":"Stats"}},"summary":"Coverage + activity snapshot"}},"/whale/{txid}":{"get":{"parameters":[{"in":"path","name":"txid","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Transaction metadata"},"404":{"description":"Not found"}},"summary":"Single transaction detail"}},"/whales/export.csv":{"get":{"description":"Analyst-grade bulk export. Max 100k rows/request. Counts as 1 API call.","parameters":[{"in":"query","name":"days","schema":{"default":30,"maximum":365,"type":"integer"}},{"in":"query","name":"min_btc","schema":{"default":100,"type":"number"}},{"in":"query","name":"flow","schema":{"enum":["to_exchange","from_exchange","wallet_to_wallet","exchange_to_exchange"],"type":"string"}},{"in":"query","name":"limit","schema":{"default":100000,"maximum":100000,"type":"integer"}}],"responses":{"200":{"description":"text/csv stream (16 columns, UTF-8)"}},"summary":"Streaming CSV export (bulk data)"}},"/whales/recent":{"get":{"parameters":[{"in":"query","name":"limit","schema":{"default":50,"maximum":500,"type":"integer"}},{"in":"query","name":"min_btc","schema":{"default":100,"type":"number"}},{"in":"query","name":"flow","schema":{"enum":["to_exchange","from_exchange","wallet_to_wallet","exchange_to_exchange"],"type":"string"}},{"description":"Opaque cursor from previous page's next_cursor field (historical pagination).","in":"query","name":"before","schema":{"type":"string"}},{"description":"Legacy frontier streaming cursor \u2014 only works for rows since 2026-04 with populated id column.","in":"query","name":"since_id","schema":{"type":"integer"}},{"in":"query","name":"lang","schema":{"default":"en","enum":["en","de","es"],"type":"string"}}],"responses":{"200":{"description":"Array of whale objects with intent classification"}},"summary":"Recent whale transactions (paginated)"}}},"security":[{"BearerAuth":[]}],"servers":[{"url":"https://dashboard.btcwhalealerts.com/v1"}]}