{"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":"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/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"}]},{"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"}]}]}