ValveRide Flow

Build an optimized diesel fuel plan for a truck route. Send the truck profile, current fuel, origin, and destination; ValveRide Flow routes the leg, discovers truck stops along it, prices them from its live retail diesel grid, applies your discount schedule on net price, and returns where to stop, how many gallons to buy, and the estimated savings (IFTA tax-aware). The response includes a tripId; to replan mid-trip, call again with that tripId, currentLocation set to the truck's live position, and the updated currentFuelGallons -- replans of the same trip bill at the replan rate ($0.08) instead of the full plan rate ($2.25). VENDOR RULE: if the user restricts fueling to a brand or network ("Love's only", "we can only fuel at Pilot or Flying J"), you MUST set vendorRule.allowedVendors to those brands. It is a hard rule: only those stations are considered and, if none works, the tool returns no_feasible_plan_under_vendor_rule instead of an off-brand stop. Put any discount the user mentions for that brand in discountSchedule with the same vendor in the SAME call (for example "10 cents off at Love's" = vendorRule.allowedVendors ["Loves"] plus discountSchedule [{vendor:"Loves", discountType:"CENTS_PER_GALLON", discountAmount:10}]). The response echoes vendorRule and appliedDiscounts so you can confirm both were enforced.

optimize_fuel_plan

Cached US diesel market snapshot from ValveRide Flow's retail price grid, refreshed every 12 hours. Returns national median/p10/p90 retail diesel and per-state percentiles for any states mentioned in origin/destination, plus typical optimized-savings context. Use this for market questions or cost estimates; use optimize_fuel_plan when you need an actual stop-by-stop plan. This tool carries no charge.

fuel_market_snapshot