$0.03
per call · USDC on Base Sepolia
Use when an agent already knows several products/categories a buyer needs and wants one real Shopify product for each need while staying within one overall item-price budget. Each need.query must already carry the important compatibility and preference details; this service does not reinterpret intent. Returns a cross-merchant basket plan with per-item checkout URLs. It is not a generic product search and does not create carts or checkouts.
Endpoint
POST https://agent-api-testnet.tim1712.workers.dev/v1/shopping/budget-basket4
Calls / 30d
1
Unique payers / 30d
Aug 30
Last called
exact
Payment scheme
Call this service
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";
const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);
const res = await fetchWithPay("https://agent-api-testnet.tim1712.workers.dev/v1/shopping/budget-basket", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"budgetMinor": 60000,
"country": "NL",
"currency": "EUR",
"needs": [
{
"id": "microphone",
"maxPriceMinor": 20000,
"priority": 10,
"query": "wireless lavalier microphone for iPhone USB-C"
},
{
"id": "power-bank",
"maxPriceMinor": 15000,
"priority": 6,
"query": "65W USB-C power bank 20000mAh airline safe"
},
{
"id": "tripod",
"priority": 4,
"query": "compact travel tripod aluminium under 1.2kg"
}
]
}),
});
const data = await res.json();curl -X POST \
"https://agent-api-testnet.tim1712.workers.dev/v1/shopping/budget-basket" \
-H "Content-Type: application/json" \
-d '{"budgetMinor":60000,"country":"NL","currency":"EUR","needs":[{"id":"microphone","maxPriceMinor":20000,"priority":10,"query":"wireless lavalier microphone for iPhone USB-C"},{"id":"power-bank","maxPriceMinor":15000,"priority":6,"query":"65W USB-C power bank 20000mAh airline safe"},{"id":"tripod","priority":4,"query":"compact travel tripod aluminium under 1.2kg"}]}' \
-H "X-PAYMENT: <signed x402 payment>"Example response
{
"budgetMinor": 60000,
"budgetScope": "items_only",
"checkedAt": "2026-08-30T10:00:02.000Z",
"complete": true,
"country": "NL",
"currency": "EUR",
"items": [
{
"checkoutUrl": "https://example-merch.example/cart/2222222222:1",
"currency": "EUR",
"needId": "microphone",
"priceMinor": 17999,
"priority": 10,
"productId": "gid://shopify/Product/1111111111",
"productTitle": "USB-C Wireless Lavalier Microphone",
"productUrl": "https://example-merch.example/products/usb-c-wireless-lavalier",
"query": "wireless lavalier microphone for iPhone USB-C",
"rating": {
"count": 214,
"value": 4.6
},
"searchRank": 0,
"seller": {
"domain": "example-merch.example",
"name": "Example Merch",
"url": "https://example-merch.example"
},
"variantId": "gid://shopify/ProductVariant/2222222222",
"variantTitle": "Single mic + USB-C receiver"
},
{
"checkoutUrl": "https://poweredup.example/cart/4444444444:1",
"currency": "EUR",
"needId": "power-bank",
"priceMinor": 13299,
"priority": 6,
"productId": "gid://shopify/Product/3333333333",
"productTitle": "20000mAh 65W USB-C Power Bank",
"productUrl": "https://poweredup.example/products/pb-20000-65w",
"query": "65W USB-C power bank 20000mAh airline safe",
"rating": {
"count": 88,
"value": 4.4
},
"searchRank": 1,
"seller": {
"domain": "poweredup.example",
"name": "PoweredUp",
"url": "https://poweredup.example"
},
"variantId": "gid://shopify/ProductVariant/4444444444",
"variantTitle": null
},
{
"checkoutUrl": "https://tripodworld.example/cart/6666666666:1",
"currency": "EUR",
"needId": "tripod",
"priceMinor": 9999,
"priority": 4,
"productId": "gid://shopify/Product/5555555555",
"productTitle": "Aluminium Travel Tripod 1.1kg",
"productUrl": "https://tripodworld.example/products/alu-travel-tripod",
"query": "compact travel tripod aluminium under 1.2kg",
"rating": null,
"searchRank": 0,
"seller": {
"domain": "tripodworld.example",
"name": "Tripod World",
"url": "https://tripodworld.example"
},
"variantId": "gid://shopify/ProductVariant/6666666666",
"variantTitle": "Black"
}
],
"remainingMinor": 18703,
"source": "shopify-global-catalog",
"totalMinor": 41297,
"unresolvedNeeds": [],
"warnings": [
"Shipping, taxes, duties and discounts are not included in the budget."
]
}Payment details
0x5229384bd502d85aa7eca0a31b515e5e48d3910fUSDC · 0x036cbd53842c5426634e7929541ec2318f3dcf7eIs this your API?
Pin it to the top of AI & Inference and the homepage with a featured placement.
More from Agent Miner Tools & similar services
Agent Miner Tools · NPM Install Preflight
agent-api-testnet.tim1712.workers.dev
Use before a coding agent installs an unfamiliar npm dependency. Returns current facts from the official npm registry: the version `npm install` resolves (dist-tags.latest), prerelease and deprecation status, engines.node compatibility with an optional target Node version (real SemVer evaluation), license, days since release, best-effort weekly downloads, repository URL and maintainer count. Facts only — no safety, trust, or malware verdict.
Agent Miner Tools · Shopping Product Search
agent-api-production.tim1712.workers.dev
Use when an agent already knows the product it wants and needs real current Shopify listings for a structured query. Returns normalized product/variant price, currency, seller, rating, product URL and checkout URL in upstream search-rank order, with an optional maximum item price. The query must already carry the compatibility and preference details. Not a recommendation engine, intent interpretation, web search, or cart/checkout.
Agent Miner Tools · Shopping Product Search
agent-api-testnet.tim1712.workers.dev
Use when an agent already knows the product it wants and needs real current Shopify listings for a structured query. Returns normalized product/variant price, currency, seller, rating, product URL and checkout URL in upstream search-rank order, with an optional maximum item price. The query must already carry the compatibility and preference details. Not a recommendation engine, intent interpretation, web search, or cart/checkout.