get_all_collection_bids
Retrieve up to 1000 CryptoPunks collection bids sorted by creation date with summarized metadata. Filter bids by status to monitor active offers.
Instructions
Get all collection bids ordered by creation date (most recent first). Returns summarized bid metadata. Higher limit than get_collection_bids — up to 1000.
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:369-376 (handler)The handler function in src/handlers.ts calls the API function getAllCollectionBids and processes the response through summarizeBidsResponse to prevent large payload issues.
case "get_all_collection_bids": { const raw = await api.getAllCollectionBids({ limit: args.limit ?? 100, status: args.status, chainId: args.chain_id ?? 1, }); return ok(summarizeBidsResponse(raw)); } - src/api.ts:218-228 (helper)The API function in src/api.ts performs the actual HTTP GET request to the CryptoPunks bids service.
export async function getAllCollectionBids(params?: { limit?: number; status?: string; chainId?: number; }) { const p: Record<string, string> = {}; if (params?.limit) p.limit = String(Math.min(params.limit ?? 100, 1000)); if (params?.status) p.status = params.status; if (params?.chainId) p.chainId = String(params.chainId); return get(BIDS_BASE, "/api/v1/bids/all", p); } - src/tools.ts:195-203 (registration)The tool definition and schema registration in src/tools.ts defines the parameters for the get_all_collection_bids tool.
get_all_collection_bids: { description: "Get all collection bids ordered by creation date (most recent first). Returns summarized bid metadata. Higher limit than get_collection_bids — up to 1000.", inputSchema: z.object({ limit: z.number().int().min(1).max(1000).optional().default(100), status: bidStatus.optional().describe("Filter by status. Try 'pending' for active bids."), chain_id: z.number().int().optional().default(1), }), },