get_top_collection_bids
Retrieve the highest CryptoPunks collection bids sorted by amount, with filtering options for bid status and blockchain network.
Instructions
Get the highest collection bids ordered by bid amount descending. Returns summarized bid metadata. Tip: try status 'pending' if default returns empty results.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| status | No | Filter by status. Try 'pending' for active bids. | |
| chain_id | No |
Implementation Reference
- src/handlers.ts:359-367 (handler)The handler for `get_top_collection_bids` tool, which fetches top bids from the API using `api.getTopBids`.
case "get_top_collection_bids": { // Bug 6 fix: default to "pending" status since unfiltered may return empty const raw = await api.getTopBids({ limit: args.limit ?? 10, status: args.status ?? "pending", chainId: args.chain_id ?? 1, }); return ok(summarizeBidsResponse(raw)); } - src/tools.ts:185-193 (schema)The registration and input schema definition for `get_top_collection_bids`.
get_top_collection_bids: { description: "Get the highest collection bids ordered by bid amount descending. Returns summarized bid metadata. Tip: try status 'pending' if default returns empty results.", inputSchema: z.object({ limit: z.number().int().min(1).max(100).optional().default(10), status: bidStatus.optional().describe("Filter by status. Try 'pending' for active bids."), chain_id: z.number().int().optional().default(1), }), },