List Open Listings
list_open_listingsFan listings on XP open to offers, filterable by event, performer and whole-listing amount -- 'what's open near me this weekend?'. Listings the caller muted are left out. Each listing's identifier is what get_open_listing and buy_listing_now take; buy_listing_now buys a listing outright at its asking price. Event inventory at listed prices is in get_ticket_listings. Requires sign-in and the read:bids scope.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_open_listings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Only include offers created within this many days. | |
| limit | No | Max offers to return after fetch. | |
| sort_by | No | Sort field: created_at, event_date, amount, state, updated_at. | created_at |
| performer | No | Filter by performer name substring. | |
| event_name | No | Filter by event title substring. | |
| max_amount | No | Deprecated, use max_amount_usd. Micro-USDC (50_000_000 = $50.00). | |
| min_amount | No | Deprecated, use min_amount_usd. Micro-USDC (50_000_000 = $50.00). | |
| sort_order | No | Sort direction. | desc |
| max_amount_usd | No | Maximum total for the whole listing in dollars (all its tickets together), not per ticket. | |
| min_amount_usd | No | Minimum total for the whole listing in dollars (all its tickets together), not per ticket. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||