get_hip3_trades_recent
Read-onlyIdempotent
Retrieve the most recent HIP-3 trades for any supported coin symbol. Returns the latest trades without specifying a time range.
Instructions
Get most recent HIP-3 trades. Symbols are CASE-SENSITIVE (e.g. 'km:US500'). Returns the latest trades without needing a time range.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | Yes | HIP-3 coin symbol (CASE-SENSITIVE). 125+ markets across 6 builders: xyz, flx, hyna, km, vntl, cash. Examples: 'km:US500', 'xyz:GOLD', 'hyna:BTC', 'vntl:SPACEX', 'flx:TSLA', 'cash:NVDA'. Use get_hip3_instruments to list all. | |
| limit | No | Max records to return (default 100, max 1000) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| records | Yes | Array of result records | |
| count | Yes | Total number of records in the full result set | |
| nextCursor | No | Cursor for next page, if more results available |
Implementation Reference
- src/index.ts:683-698 (handler)The handler function for get_hip3_trades_recent. It takes 'coin' (CASE-SENSITIVE HIP-3 symbol) and optional 'limit', calls api().hyperliquid.hip3.trades.recent(), and formats the response. Registered via the generic registerTool helper.
registerTool( "get_hip3_trades_recent", "Get most recent HIP-3 trades. Symbols are CASE-SENSITIVE (e.g. 'km:US500'). Returns the latest trades without needing a time range.", { coin: Hip3CoinParam, limit: LimitParam, }, ListOutputSchema, async (params) => { const data = await api().hyperliquid.hip3.trades.recent( normalizeHip3Coin(params.coin), params.limit ); return formatResponse(data); } ); - src/index.ts:683-698 (registration)Registration of the 'get_hip3_trades_recent' tool using the generic registerTool helper with input schema { coin: Hip3CoinParam, limit: LimitParam } and output schema ListOutputSchema.
registerTool( "get_hip3_trades_recent", "Get most recent HIP-3 trades. Symbols are CASE-SENSITIVE (e.g. 'km:US500'). Returns the latest trades without needing a time range.", { coin: Hip3CoinParam, limit: LimitParam, }, ListOutputSchema, async (params) => { const data = await api().hyperliquid.hip3.trades.recent( normalizeHip3Coin(params.coin), params.limit ); return formatResponse(data); } ); - src/index.ts:57-61 (schema)The input schema for the 'coin' parameter, defined as a Zod string describing CASE-SENSITIVE HIP-3 coin symbols.
const Hip3CoinParam = z .string() .describe( "HIP-3 coin symbol (CASE-SENSITIVE). 125+ markets across 6 builders: xyz, flx, hyna, km, vntl, cash. Examples: 'km:US500', 'xyz:GOLD', 'hyna:BTC', 'vntl:SPACEX', 'flx:TSLA', 'cash:NVDA'. Use get_hip3_instruments to list all." ); - src/index.ts:88-91 (schema)The input schema for the optional 'limit' parameter.
const LimitParam = z .number() .optional() .describe("Max records to return (default 100, max 1000)"); - src/index.ts:300-302 (helper)Helper that normalizes HIP-3 coin symbols (returns as-is since they are case-sensitive).
function normalizeHip3Coin(coin: string): string { return coin; // Case-sensitive }