Takes an ordered list of positions with timestamps, optionally carrying the battery state
Takes an ordered list of positions with timestamps, optionally carrying the battery state of charge at each fix, and returns what a fleet operator asks of a trace: total distance over ground, how much of the elapsed time the vehicle was moving and how much it stood, each individual stop with its position and duration, the mean and maximum speed, and — where a battery capacity is supplied — the energy drawn and the consumption per kilometre.
5000 (raw units)
price
1
calls / 30d
1
unique payers
2026-08-20
updated
Provider
karte.halowerk.com · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "5000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"body": {
"battery_capacity_kwh": 58,
"points": [
{
"lat": 52.52,
"lon": 13.405,
"soc_percent": 82,
"time": "2026-08-19T08:00:00Z"
},
{
"lat": 52.515,
"lon": 13.39,
"soc_percent": 81.4,
"time": "2026-08-19T08:04:00Z"
},
{
"lat": 52.515,
"lon": 13.39,
"soc_percent": 81.3,
"time": "2026-08-19T08:12:00Z"
},
{
"lat": 52.51,
"lon": 13.37,
"soc_percent": 80.5,
"time": "2026-08-19T08:18:00Z"
}
],
"stop_min_s": 120,
"stop_speed_kmh": 2
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"battery_capacity_kwh": {
"description": "Usable battery capacity. Without it, energy is reported in percent of charge only, never in kWh.",
"maximum": 1000,
"minimum": 0.1,
"type": "number"
},
"max_speed_kmh": {
"default": 250,
"description": "Plausibility limit. A segment implying more than this is rejected instead of summed.",
"maximum": 400,
"minimum": 1,
"type": "number"
},
"points": {
"description": "The trace, in chronological order. At least two fixes.",
"items": {
"additionalProperties": false,
"properties": {
"lat": {
"description": "Latitude, WGS 84.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"lon": {
"description": "Longitude, WGS 84.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"soc_percent": {
"description": "Battery state of charge at this fix, in percent. Optional, and may be present on only some fixes.",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"time": {
"description": "ISO 8601 timestamp of the fix. Must not go backwards from one fix to the next.",
"maxLength": 40,
"minLength": 4,
"type": "string"
}
},
"required": [
"lat",
"lon",
"time"
],
"type": "object"
},
"maxItems": 5000,
"minItems": 2,
"type": "array"
},
"stop_min_s": {
"default": 120,
"description": "Minimum duration of standing time before it is reported as a stop.",
"maximum": 86400,
"minimum": 10,
"type": "integer"
},
"stop_speed_kmh": {
"default": 2,
"description": "At or below this speed a segment counts as standing.",
"maximum": 30,
"minimum": 0,
"type": "number"
}
},
"required": [
"points"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://karte.halowerk.com/v1/trip-metrics" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://karte.halowerk.com/v1/trip-metrics");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://karte.halowerk.com/v1/trip-metrics")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/15410.json, and this resource appears in /discovery/resources and /discovery/search.