Buy paid placement for a directory listing (paid, x402)
listing_promotePAID: promote a directory listing you own above free rows for the plan term; paying again extends. Unpaid, it returns the price; pay with x402 (USDC on Base, Solana, Polygon, Arbitrum, Avalanche, Sei or X Layer) in _meta['x402/payment'] and call again. Feedback: POST /feedback (free). Read daily; no individual reply. Price: from $0.0667 USDC.
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": "listing_promote"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The listing to promote. It must already exist and be owned by the paying wallet -- create it free with POST /listings. | |
| dryRun | No | Optional. true: a dry run -- nothing is sent or changed, and the 200 answer (served:true, dryRun:true) says what this call would do with the rest of your body, or which fields are missing. A dry run is a paid call at this price. false or absent: the call runs. | |
| duration | No | Which placement plan to buy; it sets both the placement window and the price. See GET /pricing or the service_card tool for the live table. |