List auctions ending soon
list_ending_soonLists government surplus auctions closing within a chosen number of hours, soonest first, so users can find time-sensitive bargains. Filter by state, category, keyword, or maximum bid.
Instructions
List government surplus auctions that close within the next N hours, soonest first — the best time to find bargains. Optionally narrow by state, category, keyword and max price.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"hours": "<hours>"
},
"name": "list_ending_soon"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hours | Yes | Time window in hours, e.g. 24 for today, 72 for the next three days | |
| limit | No | Maximum results (default 15) | |
| state | No | Two-letter US state where the item is located, e.g. TX. Omit to search nationwide. | |
| keyword | No | Optional keyword, e.g. truck | |
| category | No | Item category. "vehicles" and "trailers" are filtered natively on GovDeals; other categories are matched by keyword. | |
| max_price | No | Only auctions whose current bid is at or below this many USD |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| auctions | Yes | ||
| warnings | Yes | ||
| total_returned | Yes |