Where to buy a gift
where_to_buyUse this when the user wants to buy: the cheapest stored active listings of a collection, model, backdrop or one numbered gift, each with marketplace, price in Stars, TON and USD and the link that opens it, plus the stored Portals ask floor. It reads stored listings, not a live marketplace, and never places an order. Do not use it for what a gift is worth (get_gift) or for past sales (recent_sales).
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": "where_to_buy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | Gift slug such as "plushpepe-9998", to look up one gift. | |
| limit | No | Listings, default 5. | |
| model | No | Optional model name. | |
| number | No | Gift number, to look up one gift. | |
| backdrop | No | Optional backdrop name. | |
| collection | No | Collection name in English or Russian, for example "Plush Pepe". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| note | Yes | ||
| model | No | ||
| message | No | ||
| backdrop | No | ||
| listings | Yes | ||
| collection | Yes | ||
| other_marketplaces | No |