get_collection_bids_for_punk
Retrieve all collection bids covering a specific CryptoPunk to analyze market interest and potential sale opportunities. Filter bids by status to focus on active offers.
Instructions
Get all collection bids that cover a specific CryptoPunk. Returns summarized bid metadata. For Merkle proofs needed for on-chain settlement, use get_bid_proofs with the bid UUID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| punk_index | Yes | CryptoPunk index (0–9999) | |
| status | No | Filter by status. Try 'pending' for active bids. | |
| limit | No | ||
| chain_id | No |
Implementation Reference
- src/handlers.ts:384-392 (handler)The handler implementation for the get_collection_bids_for_punk tool, which calls api.getBidsForPunk and summarizes the result.
case "get_collection_bids_for_punk": { const raw = await api.getBidsForPunk(args.punk_index, { status: args.status, limit: args.limit ?? 50, chainId: args.chain_id ?? 1, }); // Bug 5 fix: summarize to avoid payload overflow return ok(summarizeBidsResponse(raw)); } - src/tools.ts:213-222 (schema)The MCP tool registration and input schema definition for get_collection_bids_for_punk.
get_collection_bids_for_punk: { description: "Get all collection bids that cover a specific CryptoPunk. Returns summarized bid metadata. For Merkle proofs needed for on-chain settlement, use get_bid_proofs with the bid UUID.", inputSchema: z.object({ punk_index: punkIndex, status: bidStatus.optional().describe("Filter by status. Try 'pending' for active bids."), limit: z.number().int().min(1).max(100).optional().default(50), chain_id: z.number().int().optional().default(1), }), },