Start a purchase
start_purchaseReserve a listing for the signed-in buyer and get a one-time NEAR Intents deposit address and the exact amount of pay_with to send. Nothing is charged by this call: the purchase completes only when the buyer's own wallet sends that exact amount to that address before the deadline. Returns a checkout_id, the deposit address, exact amount, asset, chain and the pay_before deadline. If the seller accepted the buyer's offer, the agreed price is used. Requires a Port66 session (Authorization: Bearer token from wallet sign-in). Then poll purchase_status until it is paid.
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": {
"id": "<id>",
"pay_with": "<pay_with>",
"refund_to": "<refund_to>",
"shipping_address": "<shipping_address>"
},
"name": "start_purchase"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The listing's id, exactly as returned in the `id` field of search_listings results (a slug such as 'kaws-x-sesame-street-water-parade-elmo-figure'). | |
| chain | No | Only needed when the asset exists on several chains: ETH and USDC on Ethereum, Arbitrum or Base, USDC also on NEAR. Omit it otherwise. | |
| pay_with | Yes | The crypto asset the buyer pays with. payment_options lists which chains each one is accepted on. | |
| refund_to | Yes | The buyer's own wallet address on the paying chain (for example a 0x address for Ethereum or Base, a Solana address for SOL). If the payment cannot complete, the funds are returned here. Never an exchange deposit address. | |
| shipping_address | Yes | Where the piece is shipped. |