{"base_url":"https://data-api.hyperx.trade","authentication":{"methods":[{"type":"cookie","description":"HyperX session cookie (login at hyperx.trade)"},{"type":"api_token","description":"API Token via X-API-Key header (get at hyperx.trade/api-token)"}]},"rate_limits":{"api_token_free":{"budget":30,"window":"1 minute","monthly":10000,"description":"Free API Token"},"api_token_pro":{"budget":300,"window":"1 minute","monthly":500000,"description":"Pro API Token ($99/mo)"},"api_token_ultra":{"budget":1200,"window":"1 minute","monthly":5000000,"description":"Ultra API Token ($399/mo)"}},"weight_tiers":{"0":"Free — no rate limit cost","1":"Light — simple queries","2":"Medium — moderate computation","3":"Heavy — write operations","5":"Very Heavy — complex analysis"},"categories":[{"name":"Wallet Analysis","description":"Deep wallet-level PnL, position, and trading analytics","endpoints":[{"method":"POST","path":"/wallet_analysis/{address}","description":"Full wallet PnL analysis with positions, trades, and risk metrics","weight":5,"auth":"optional"},{"method":"GET","path":"/wallet_metrics/{address}","description":"Pre-calculated wallet performance metrics (win rate, ROI, PnL)","weight":2,"auth":"none"},{"method":"POST","path":"/wallet_metrics_query","description":"Batch query wallet metrics with filters and sorting","weight":2,"auth":"optional"},{"method":"GET","path":"/fills/{address}","description":"Trading history (fills) for a wallet address","weight":5,"auth":"optional"},{"method":"WebSocket","path":"/fills/ws","description":"Real-time fills stream. 5 weight per message. Addr limits: free=1, pro=50, ultra=300","weight":5,"auth":"optional"}]},{"name":"V2 Discover","description":"Cohort discovery: keyset-paginated wallet list, count, and server-side aggregation. Same filter semantics and definition_hash across all endpoints","endpoints":[{"method":"POST","path":"/v2/discover/wallets","description":"Wallet list with keyset cursor pagination (no offset)","weight":2,"auth":"optional"},{"method":"GET","path":"/v2/famous-traders","description":"Curated famous traders (identity + avatar CDN). Metrics stay on /v2/discover/wallets","weight":1,"auth":"optional"},{"method":"POST","path":"/v2/discover/count","description":"Cohort member count. Empty body {} = all wallets (period defaults to 'all')","weight":2,"auth":"optional"},{"method":"POST","path":"/v2/discover/aggregate","description":"Server-side cohort aggregation: account value, PnL, long/short positioning, market/dex/asset-class breakdown, direction labels. No client-side pagination needed","weight":5,"auth":"optional"}]},{"name":"Market Analysis","description":"Real-time and aggregated market data across all assets","endpoints":[{"method":"GET","path":"/market/coins","description":"List of all tradable coins with metadata","weight":1,"auth":"none"},{"method":"GET","path":"/market/snapshots","description":"Market overview snapshots","weight":1,"auth":"none"},{"method":"GET","path":"/market/overview","description":"Aggregated market overview","weight":1,"auth":"none"},{"method":"GET","path":"/market/aggregate-positions","description":"Cross-asset aggregated position data","weight":1,"auth":"none"},{"method":"GET","path":"/market/top-positions/{asset_name}","description":"Top positions for a specific asset","weight":1,"auth":"none"},{"method":"GET","path":"/market/leverage-distribution/{asset_name}","description":"Leverage distribution for an asset","weight":1,"auth":"none"},{"method":"GET","path":"/market/pnl-distribution/{asset_name}","description":"PnL distribution for an asset","weight":1,"auth":"none"},{"method":"GET","path":"/market/concentration/{asset_name}","description":"Position concentration analysis","weight":1,"auth":"none"},{"method":"GET","path":"/market/whale-changes/{asset_name}","description":"Whale position changes tracking","weight":1,"auth":"none"},{"method":"GET","path":"/market/smart-money/flow","description":"Smart money (profit-verified wallets) net flow by coin over 1h/4h/24h windows","weight":1,"auth":"none"},{"method":"GET","path":"/market/entry-price/{asset_name}","description":"Entry price distribution for an asset","weight":1,"auth":"none"},{"method":"GET","path":"/market/high-leverage-whales/{asset_name}","description":"High-leverage whale positions","weight":1,"auth":"none"},{"method":"GET","path":"/market/top-losers/{asset_name}","description":"Top losing positions","weight":1,"auth":"none"},{"method":"GET","path":"/market/top-winners/{asset_name}","description":"Top winning positions","weight":1,"auth":"none"},{"method":"GET","path":"/market/liquidation-heatmap/{asset_name}","description":"Liquidation price heatmap","weight":1,"auth":"none"},{"method":"GET","path":"/market/liquidation-positions/{asset_name}","description":"Positions near liquidation","weight":1,"auth":"none"},{"method":"GET","path":"/market/cost-distribution/{asset_name}","description":"Cost distribution by price bucket","weight":1,"auth":"none"},{"method":"GET","path":"/market/order-wall/{asset_name}","description":"Order wall by price bucket with top large orders","weight":1,"auth":"none"},{"method":"GET","path":"/market/spot-holdings","description":"Spot token holdings summary across all tokens","weight":1,"auth":"none"},{"method":"GET","path":"/market/spot-holders/{token_name}","description":"Top 100 holders for a spot token","weight":1,"auth":"none"},{"method":"GET","path":"/market/account-overview","description":"Platform-wide account overview with net-value tier distribution","weight":1,"auth":"none"},{"method":"GET","path":"/market/dex-share","description":"Per-DEX share of accounts, margin, positions and orders","weight":1,"auth":"none"},{"method":"GET","path":"/market/history/overview/{asset_name}","description":"Hourly downsampled market overview history for an asset (days=1/7/30/90)","weight":1,"auth":"none"},{"method":"GET","path":"/market/history/account-overview","description":"Hourly downsampled platform-wide account overview history (tier=ALL)","weight":1,"auth":"none"},{"method":"GET","path":"/market/large-trades/{asset_name}","description":"Large trades tape (deduplicated by tid) with summary and hourly breakdown","weight":1,"auth":"none"},{"method":"GET","path":"/market/flow-pressure/{asset_name}","description":"Hourly directional open/close flow pressure for an asset","weight":1,"auth":"none"},{"method":"GET","path":"/market/trader-funding/{address}","description":"Trader funding settlement records with summary","weight":1,"auth":"none"},{"method":"GET","path":"/market/trader-margin-timeline/{address}","description":"Trader account margin timeline (last 7 days)","weight":1,"auth":"none"},{"method":"POST","path":"/market/wallet-tags","description":"Batch wallet tags from 30d metrics (rule engine, up to 200 addresses)","weight":2,"auth":"optional"}]},{"name":"Time Distribution","description":"Wallet trading activity patterns across time dimensions","endpoints":[{"method":"GET","path":"/wallet/time-distribution/{address}/hourly","description":"Hourly trading activity distribution","weight":1,"auth":"optional"},{"method":"GET","path":"/wallet/time-distribution/{address}/day-of-week","description":"Day of week trading patterns","weight":1,"auth":"optional"},{"method":"GET","path":"/wallet/time-distribution/{address}/heatmap","description":"Full activity heatmap (hour x day)","weight":1,"auth":"optional"},{"method":"GET","path":"/wallet/time-distribution/{address}/daily","description":"Daily trading volume distribution","weight":1,"auth":"optional"}]},{"name":"News","description":"Aggregated trading and crypto news from multiple sources","endpoints":[{"method":"GET","path":"/news","description":"Trading news aggregated from multiple sources","weight":1,"auth":"none"},{"method":"GET","path":"/news/channels","description":"Available news channel categories","weight":1,"auth":"none"}]},{"name":"BTC Mining","description":"Bitcoin mining economics and shutdown price analysis","endpoints":[{"method":"GET","path":"/btc-mining/shutdown-prices","description":"BTC mining shutdown prices by miner model","weight":1,"auth":"none"}]}]}