Status: Available Now

Endpoint: POST /api/v1/market-data

Purpose: Retrieve market data for charging infrastructure within a defined geographical area

Overview

The geo-spatial search endpoint enables location-based analysis of electric vehicle charging infrastructure. You can search within a circular area defined by center coordinates and radius to get detailed market insights including utilization patterns, consumption data, and operational metrics.

Key Capabilities

• Circular area search with up to 3km radius
• GeoJSON-compliant coordinate system (longitude, latitude)
• Historical data spanning 12 months
• Weekly usage patterns analysis spanning 3 months
• Statistical confidence intervals for consumption estimates
• Paginated results for optimal performance

Request Format

HTTP Method

POST /api/v1/market-data

Headers

Content-Type: application/json
x-api-key: your-api-key-here

Request Body Schema

{
  "meta": {
    "<keys as defined in contract>": "<values as defined in contract>"
  },
  "area": {
    "type": "RADIUS",                    // Required: Must be "RADIUS"
    "centerPoint": [longitude, latitude], // Required: [float, float] - GeoJSON format
    "radiusInMeter": integer             // Required: 1-3000 (max 3km)
  },
  "skip": integer,  // Optional: Number of results to skip (default: 0)
  "limit": integer  // Optional: Results per page, 1-50 (default: 25)
}