{"uid":"cap_cNzXZAhLzreA8X-vibZ_e","slug":"halowerk-laufwerk-energy-readiness-tour-optimizer-08792c80","name":"HALOWERK laufwerk — Energy Readiness Tour Optimizer","description":"HALOWERK laufwerk — bezahlte Endpunkte nach x402. Preise in USDC auf Base Mainnet.","url":"https://lauf.halowerk.com/v1/tours/energy-readiness?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","required":["id","point","demand","service_s","window"],"properties":{"id":{"type":"string","maxLength":80,"minLength":1},"point":{"type":"integer","maximum":20,"minimum":1},"demand":{"type":"number","maximum":100000,"minimum":0},"window":{"type":"array","items":{"type":"number","maximum":604800,"minimum":0},"maxItems":2,"minItems":2},"service_s":{"type":"number","maximum":604800,"minimum":0}},"additionalProperties":false},"maxItems":20,"minItems":1},"vehicles":{"type":"array","items":{"type":"object","required":["id","capacity","shift","available_energy_wh","reserve_energy_wh"],"properties":{"id":{"type":"string","maxLength":80,"minLength":1},"shift":{"type":"array","items":{"type":"number","maximum":604800,"minimum":0},"maxItems":2,"minItems":2},"capacity":{"type":"number","maximum":100000,"exclusiveMinimum":0},"reserve_energy_wh":{"type":"number","maximum":10000000,"minimum":0},"available_energy_wh":{"type":"number","maximum":10000000,"minimum":0}},"additionalProperties":false},"maxItems":4,"minItems":1},"energy_wh":{"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"number","maximum":10000000,"minimum":0},{"type":"null"}]},"maxItems":21,"minItems":2},"maxItems":21,"minItems":2},"durations_s":{"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"number","maximum":604800,"minimum":0},{"type":"null"}]},"maxItems":21,"minItems":2},"maxItems":21,"minItems":2},"matrix_source":{"type":"string","maxLength":200,"minLength":1}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","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.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rVA93NSmsfBi37dHLkQ54","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether electric vehicles have sufficient energy to complete a set of tours/jobs given travel durations, energy consumption estimates, and vehicle battery constraints","exampleAgentPrompt":"Check if our 2 electric vans — Van A with 45,000 Wh available and 5,000 Wh reserve, Van B with 38,000 Wh available and 4,000 Wh reserve, each with a shift from 0 to 28800 seconds — have enough energy to complete these 5 delivery jobs given the travel durations and energy consumption matrix I'll provide.","exampleUseCases":[{"title":"EV fleet pre-dispatch energy check","prompt":"Before we dispatch our 3 electric delivery trucks this morning, can you check if they all have enough battery to cover their assigned stops? Truck 1 has 50,000 Wh available with a 6,000 Wh reserve, Truck 2 has 42,000 Wh with 5,000 Wh reserve, Truck 3 has 38,000 Wh with 4,500 Wh reserve — their shifts run from second 0 to 32400 and we have 8 jobs with the energy and duration matrices ready."},{"title":"Time-windowed tour energy feasibility","prompt":"We have 10 service jobs spread across 15 map points, each with a specific time window and service duration, and 2 electric vehicles with different battery levels. Can you assess whether both vehicles have enough energy to complete their tours within the time windows without dropping below their reserve?"},{"title":"EV routing plan validation before commitment","prompt":"We're about to lock in a routing plan for our 4 electric vans covering 20 stops — can you run an energy readiness check first to make sure none of them will run out of charge mid-route? I have the energy consumption matrix and estimated travel times between all points."}],"resultDescription":"A JSON response indicating whether the vehicles have sufficient energy to complete the specified tours, likely including per-vehicle or per-job energy feasibility flags, energy balances, and any infeasibility details.","failureModes":["Invalid matrix dimensions — energy or duration matrix size must match number of jobs and vehicles","Job or vehicle count exceeds allowed limits (max 20 jobs, max 4 vehicles)","Time window or shift values out of range (must be 0–604800 seconds)","Energy values exceed maximum allowed (10,000,000 Wh)","Missing required fields (id, point, demand, service_s, window for jobs; id, capacity, shift, available_energy_wh, reserve_energy_wh for vehicles)","Payment failure via x402 — insufficient USDC balance on Base Mainnet","Null values in energy or duration matrix causing computation gaps"],"whenToPreferThis":"Use this endpoint when you need to validate battery/energy feasibility for a fleet of electric vehicles before committing to a routing plan. It is specifically designed for the energy dimension of EV tour planning — not general route optimization. Prefer this over generic routing APIs when energy constraints (available charge, reserve thresholds) are a critical dispatch concern. Best suited for fleets of up to 4 vehicles and 20 jobs where you already have a duration matrix and energy consumption estimates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:40:01.829Z","isFirstParty":false,"canonicalSlug":"halowerk-laufwerk-energy-readiness-tour-optimizer-08792c80"}