{"uid":"cap_BKw5jOjHBXGENm6p8W3FA","slug":"friday-seller-tools-walmart-buy-box-margin-gap-plan-e9d013e5","name":"Friday Seller Tools – Walmart Buy Box Margin Gap Plan","description":"Instant, low-cost Amazon, Walmart, Shopify, and eBay listing, upload-preparation, advertising, and image-brief deliverables.","url":"https://friday-seller-tools-production.up.railway.app/v1/walmart/buy-box-margin-gap-plan","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","title":"WalmartBuyBoxGapRecord","required":["record_reference","sku","buy_box_status","seller_item_price","product_cost_per_unit","fulfillment_cost_per_unit","percentage_fee_percent","minimum_contribution_per_unit"],"properties":{"sku":{"type":"string","title":"Sku","pattern":"^[A-Za-z0-9][A-Za-z0-9 ._/\\-]{0,119}$"},"item_id":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Item Id","default":null},"item_name":{"anyOf":[{"type":"string","maxLength":500,"minLength":1},{"type":"null"}],"title":"Item Name","default":null},"buy_box_status":{"enum":["won","lost","no_buy_box"],"type":"string","title":"Buy Box Status"},"units_sold_30d":{"type":"integer","title":"Units Sold 30D","default":0,"maximum":10000000,"minimum":0},"record_reference":{"type":"string","title":"Record Reference","maxLength":120,"minLength":1},"seller_item_price":{"type":"number","title":"Seller Item Price","maximum":1000000,"exclusiveMinimum":0},"buy_box_item_price":{"anyOf":[{"type":"number","maximum":1000000,"exclusiveMinimum":0},{"type":"null"}],"title":"Buy Box Item Price","default":null},"fixed_fee_per_unit":{"type":"number","title":"Fixed Fee Per Unit","default":0,"maximum":100000,"minimum":0},"product_cost_per_unit":{"type":"number","title":"Product Cost Per Unit","maximum":1000000,"minimum":0},"seller_shipping_price":{"type":"number","title":"Seller Shipping Price","default":0,"maximum":1000000,"minimum":0},"buy_box_shipping_price":{"anyOf":[{"type":"number","maximum":1000000,"minimum":0},{"type":"null"}],"title":"Buy Box Shipping Price","default":null},"percentage_fee_percent":{"type":"number","title":"Percentage Fee Percent","maximum":90,"minimum":0},"fulfillment_cost_per_unit":{"type":"number","title":"Fulfillment Cost Per Unit","maximum":1000000,"minimum":0},"other_variable_cost_per_unit":{"type":"number","title":"Other Variable Cost Per Unit","default":0,"maximum":1000000,"minimum":0},"minimum_contribution_per_unit":{"type":"number","title":"Minimum Contribution Per Unit","maximum":1000000,"minimum":0}},"description":"One seller-normalized Walmart Buy Box Insights row plus unit economics.","additionalProperties":false},"title":"Records","maxItems":2000,"minItems":1},"as_of_date":{"type":"string","title":"As Of Date","format":"date"},"marketplace":{"type":"string","const":"walmart_us","title":"Marketplace","default":"walmart_us"},"report_label":{"type":"string","title":"Report Label","maxLength":120,"minLength":1},"currency_code":{"type":"string","const":"USD","title":"Currency Code","default":"USD"}}},"responseSchema":{"type":"json","example":{"job_id":"example","status":"queued"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oLUrLil7wE2iyKl-Wg-YT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates an actionable plan to close the margin gap and win the Walmart Buy Box by analyzing pricing, cost, and competitive positioning.","exampleAgentPrompt":"Generate a buy box margin gap plan for my Walmart listing — my current selling price is $24.99, my landed cost is $14.50, and the current buy box holder is priced at $21.95. I need to know exactly what pricing and margin adjustments will let me win the buy box profitably.","exampleUseCases":[{"title":"Winning buy box without sacrificing margin","prompt":"I'm losing the Walmart buy box on my best-selling product — my price is $29.99, cost is $17.00, and the buy box is held at $26.50. Can you run a buy box margin gap plan and tell me if I can profitably match or beat that price?"},{"title":"New product launch pricing strategy","prompt":"I'm about to launch a new product on Walmart at $34.99 with a landed cost of $19.00 — can you generate a buy box margin gap plan so I know what pricing range I need to stay in to be competitive and still hit my margin targets?"},{"title":"Repricing after supplier cost increase","prompt":"My supplier just raised my cost from $12.00 to $15.50 on an item I currently sell for $22.99 on Walmart and usually win the buy box — run a buy box margin gap plan so I can see whether I still have enough margin headroom or need to reprice."}],"resultDescription":"Returns a job_id and queued status immediately; the completed deliverable includes a structured buy box margin gap plan with the current gap between your price and the buy box price, margin calculations at various price points, a recommended target price to win the buy box, and an action plan outlining pricing and cost adjustments needed to compete profitably on Walmart.","failureModes":["Missing required pricing or cost inputs returns a validation error","Invalid product identifier or unrecognized Walmart listing data returns a 400 error","Insufficient margin headroom may return a plan indicating buy box is not achievable at profitable margins","Payment not received or insufficient USDC balance returns a 402 Payment Required","Service timeout may result in a queued job that needs status polling"],"whenToPreferThis":"Choose this endpoint when you specifically need a Walmart buy box margin gap analysis — it combines competitive pricing data with your cost basis to produce an actionable repricing plan. Prefer it over generic repricing tools when you need margin-aware recommendations rather than just price matching, and over Amazon or eBay equivalents when your target marketplace is Walmart.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:54:16.944Z","isFirstParty":false}