{"uid":"cap_5dAG_2VhXLbLGmI32WhEx","slug":"graphadvocate-com-2b231a42","name":"Hyperliquid Recent Fill Stream (graphadvocate.com)","description":"Recent fill stream for a Hyperliquid perp coin. POST {coin, n}. Returns the last N fills (direction, side, price, size, notional, fee, trader address) plus an aggregate summary (buy/sell notional split, whale_fill_count for fills ≥ $10k, avg price). Distinct from hl-screen (top traders by lifetime volume) — this is recent trade events as they happen, for whale-watching + flow-following bots.","url":"https://graphadvocate.com/hyperliquid/fills","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"n":{"type":"integer","default":10,"maximum":10,"minimum":1},"coin":{"type":"string"}}},"responseSchema":{"type":"json","example":{"coin":"BTC","fills":[{"fee":0.048,"side":"ASK","size":0.00084,"user":"0x1738e6cb…","price":73430,"notional":61.68,"direction":"OPEN_SHORT","timestamp":"2026-05-28 17:22:28"}],"summary":{"buy_count":4,"sell_count":6,"unique_users":8,"notional_usdc":2342.15,"whale_fill_count":0},"fill_count":10}},"example":{"request":{"n":30,"coin":"ETH"},"response":{"coin":"ETH","fills":[{"dex":"perps","fee":0.00416,"coin":"ETH","side":"ASK","size":0.0061,"user":"0x60afb1c63bd240cfa36d4b367668bddedc5a465a","price":2005.8,"crossed":true,"twap_id":1869163,"notional":12.235380000000001,"order_id":447209405471,"block_num":1014622973,"direction":"OPEN_SHORT","fee_token":"USDC","timestamp":"2026-05-29 04:35:51","closed_pnl":0,"market_name":"ETH","start_position":"-0.671","transaction_id":797619894404165,"client_order_id":"","transaction_hash":"0x0000000000000000000000000000000000000000000000000000000000000000"},{"dex":"perps","fee":-0.000367,"coin":"ETH","side":"BID","size":0.0061,"user":"0x847bd1ef4fede0fe191129894d63044843f4d473","price":2005.8,"crossed":false,"twap_id":0,"notional":12.235380000000001,"order_id":447209236115,"block_num":1014622973,"direction":"OPEN_LONG","fee_token":"USDC","timestamp":"2026-05-29 04:35:51","closed_pnl":0,"market_name":"ETH","start_position":"19.124","transaction_id":797619894404165,"client_order_id":"0x00000000000000000000019e6798f877","transaction_hash":"0x0000000000000000000000000000000000000000000000000000000000000000"},{"dex":"perps","fee":-0.000116,"coin":"ETH","side":"ASK","size":0.0058,"user":"0x1c1c270b573d55b68b3d14722b5d5d401511bed0","price":2005.9,"crossed":false,"twap_id":0,"notional":11.63422,"order_id":447209240027,"block_num":1014622899,"direction":"OPEN_SHORT","fee_token":"USDC","timestamp":"2026-05-29 04:35:46","closed_pnl":0,"market_name":"ETH","start_position":"-113.554","transaction_id":9857736853761,"client_order_id":"0xf47b9f80567ad907658d2862d3d2991a","transaction_hash":"0x0000000000000000000000000000000000000000000000000000000000000000"},{"dex":"perps","fee":0.004523,"coin":"ETH","side":"BID","size":0.0058,"user":"0x3d7a23552dfddc40b5872cbd148f4f1b4f055c36","price":2005.9,"crossed":true,"twap_id":1869180,"notional":11.63422,"order_id":447209342311,"block_num":1014622899,"direction":"OPEN_LONG","fee_token":"USDC","timestamp":"2026-05-29 04:35:46","closed_pnl":0,"market_name":"ETH","start_position":"0.4872","transaction_id":9857736853761,"client_order_id":"","transaction_hash":"0x0000000000000000000000000000000000000000000000000000000000000000"},{"dex":"perps","fee":-0.005,"coin":"ETH","side":"ASK","size":0.2493,"user":"0x1c1c270b573d55b68b3d14722b5d5d401511bed0","price":2005.9,"crossed":false,"twap_id":0,"notional":500.07087,"order_id":447209240027,"block_num":1014622803,"direction":"OPEN_SHORT","fee_token":"USDC","timestamp":"2026-05-29 04:35:39","closed_pnl":0,"market_name":"ETH","start_position":"-113.3047","transaction_id":934561847078184,"client_order_id":"0xf47b9f80567ad907658d2862d3d2991a","transaction_hash":"0x1119e7ed759415df1293043c79ea5301ba00ffd3109734b1b4e293403497efc9"},{"dex":"perps","fee":0.225031,"coin":"ETH","side":"BID","size":0.2493,"user":"0x3ca32dd3666ed1b69e86b86b420b058caa8c1aaf","price":2005.9,"crossed":true,"twap_id":0,"notional":500.07087,"order_id":447209248786,"block_num":1014622803,"direction":"OPEN_LONG","fee_token":"USDC","timestamp":"2026-05-29 04:35:39","closed_pnl":0,"market_name":"ETH","start_position":"3.3904","transaction_id":934561847078184,"client_order_id":"","transaction_hash":"0x1119e7ed759415df1293043c79ea5301ba00ffd3109734b1b4e293403497efc9"},{"dex":"perps","fee":0.005906,"coin":"ETH","side":"ASK","size":0.0409,"user":"0xbc927e87d072dfac3693846a83fa6922cc6c5f2a","price":2005.6,"crossed":false,"twap_id":0,"notional":82.02904,"order_id":447209174968,"block_num":1014622760,"direction":"OPEN_SHORT","fee_token":"USDC","timestamp":"2026-05-29 04:35:36","closed_pnl":0,"market_name":"ETH","start_position":"-236.9642","transaction_id":720515654988842,"client_order_id":"0xac260f58cfa84e2a93f75bd78ad20226","transaction_hash":"0x42f48d0108e78c43446e043c79ea280202ce00e6a3eaab15e6bd3853c7eb662d"},{"dex":"perps","fee":0.011812,"coin":"ETH","side":"BID","size":0.0409,"user":"0xb8eb97eaed8367079894d2f1bed69bd220ec1dd5","price":2005.6,"crossed":true,"twap_id":0,"notional":82.02904,"order_id":447209224464,"block_num":1014622760,"direction":"CLOSE_SHORT","fee_token":"USDC","timestamp":"2026-05-29 04:35:36","closed_pnl":0.238856,"market_name":"ETH","start_position":"-5135.3967","transaction_id":720515654988842,"client_order_id":"0x000000000000000018b32c274b7ab14b","transaction_hash":"0x42f48d0108e78c43446e043c79ea280202ce00e6a3eaab15e6bd3853c7eb662d"},{"dex":"perps","fee":0.203155,"coin":"ETH","side":"ASK","size":0.2814,"user":"0xead5b7d86c681c036c59cd00a0390541061c69f2","price":2005.4,"crossed":true,"twap_id":1868522,"notional":564.31956,"order_id":447209205446,"block_num":1014622738,"direction":"OPEN_SHORT","fee_token":"USDC","timestamp":"2026-05-29 04:35:35","closed_pnl":0,"market_name":"ETH","start_position":"-249.2584","transaction_id":370286842732915,"client_order_id":"","transaction_hash":"0x0000000000000000000000000000000000000000000000000000000000000000"},{"dex":"perps","fee":-0.011286,"coin":"ETH","side":"BID","size":0.2814,"user":"0x703c65097b0caeeb6742bebd12b04b337d931b94","price":2005.4,"crossed":false,"twap_id":0,"notional":564.31956,"order_id":447209191126,"block_num":1014622738,"direction":"CLOSE_SHORT","fee_token":"USDC","timestamp":"2026-05-29 04:35:35","closed_pnl":1.060878,"market_name":"ETH","start_position":"-625.8845","transaction_id":370286842732915,"client_order_id":"0x00000000000000003c4a1e2d5241d6b8","transaction_hash":"0x0000000000000000000000000000000000000000000000000000000000000000"}],"summary":{"avg_price":2005.72,"buy_count":5,"fill_count":10,"sell_count":5,"unique_users":9,"notional_usdc":2340.58,"whale_fill_count":0,"avg_notional_usdc":234.06,"buy_notional_usdc":1170.29,"sell_notional_usdc":1170.29},"fill_count":10,"generated_at":"2026-05-29T04:36:05.639536+00:00"}},"exampleRequest":{"n":30,"coin":"ETH"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6NA6ZXIsZPHQ1h_k7q-DS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the last N fills for a Hyperliquid perpetual coin, including per-fill details and an aggregate summary with buy/sell notional split and whale fill count.","exampleAgentPrompt":"Pull the last 30 fills for ETH on Hyperliquid and tell me how much was bought vs sold, the average price, and whether any whale fills over $10k happened.","exampleUseCases":null,"resultDescription":"Returns a list of the last N fills for the specified Hyperliquid perp coin — each with direction, side, price, size, notional, fee, and trader address — plus an aggregate summary showing buy notional, sell notional, whale fill count (fills ≥ $10k), and average price.","failureModes":["Unknown or unsupported coin symbol returns an error or empty fill list","n exceeds allowed maximum causing a validation error","Hyperliquid API unavailability causes upstream timeout or empty response","Malformed request body (missing coin or n) returns a 400-level error","Rate limiting or payment failure for the $0.02 USDC per-call fee"],"whenToPreferThis":"Use this endpoint when you need recent trade event data for a specific Hyperliquid perpetual — especially for whale-watching, flow-following bots, or detecting buy/sell imbalances in real time. Prefer this over hl-screen (which ranks top traders by lifetime volume) when you want time-stamped fill events and aggregate pressure metrics, not historical trader rankings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:30.068Z","isFirstParty":false}