get_collection_bids
Retrieve EIP-712 signed bids for CryptoPunks collections with summarized metadata including bidder, amount, and status to analyze market activity.
Instructions
Get collection bids from bids.cryptopunks.app — EIP-712 signed bids that cover sets of punks. Returns summarized bid metadata (UUID, bidder, amount, punk count, status) to avoid payload overflow. For full punk lists and proofs, use get_bid_proofs with a specific bid UUID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bidder | No | Filter by bidder Ethereum address | |
| status | No | Filter by status. Try 'pending' for active bids. | |
| limit | No | ||
| chain_id | No |
Implementation Reference
- src/handlers.ts:348-357 (handler)The handler logic for "get_collection_bids", which fetches bids via the API and applies summarization to avoid payload overflow.
case "get_collection_bids": { const raw = await api.getBids({ bidder: args.bidder, 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:174-183 (schema)The definition and input schema for the "get_collection_bids" tool.
get_collection_bids: { description: "Get collection bids from bids.cryptopunks.app — EIP-712 signed bids that cover sets of punks. Returns summarized bid metadata (UUID, bidder, amount, punk count, status) to avoid payload overflow. For full punk lists and proofs, use get_bid_proofs with a specific bid UUID.", inputSchema: z.object({ bidder: ethAddress.optional().describe("Filter by bidder Ethereum address"), 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), }), },