Buy Listing at the Ask
buy_listing_nowBuys a fan listing on XP outright at the seller's asking price, without an offer -- 'buy it now', 'take it at the ask'. Only listings with an asking price can be bought this way, and the purchase is refused if the ask changed since the preview. confirm=false returns a preview of the total; confirm=true completes the sale at once, paid from the caller's XP USDC balance, and commits the seller. The x402 rail is for buy_tickets and does not apply here. identifier comes from list_open_listings or get_open_listing. Requires sign-in.
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": {
"identifier": "<identifier>"
},
"name": "buy_listing_now"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rail | No | How to pay. 'usdc' spends the caller's XP USDC balance. | usdc |
| confirm | No | False (default) previews. True buys at ask_per_ticket_usd, the price the preview showed. | |
| identifier | Yes | Listing identifier from list_open_listings or get_open_listing. | |
| ask_per_ticket_usd | No | The per-ticket price the preview showed (its ask_per_ticket_usd). Required with confirm=true: the purchase is refused if the seller has changed the ask since, so the buyer never pays a price they did not see. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||