AxisDatum

DEVELOPER ACCESS

Evidence you can query.

The map has public read-only routes. The keyed USDA API adds per-key usage records and a monthly research quota. Responses carry source context and observation times where the providers supply them. There is no commercial service guarantee yet.

Open API dashboard ↗Download OpenAPI ↗Explore the map ↗

ON THIS PAGE

Quick startEndpointsMarket data contractsAgent integrationData and usage limits

Quick start

Requests use the deployment origin. Create a key in the API dashboard to use /v1/catalog, /v1/field, and /v1/history. Send the key in X-API-Key. The first 100 successful keyed requests per calendar month are included during this research phase. Public map routes remain available without a key.

curl -H 'X-API-Key: YOUR_KEY' 'https://axisdatum.com/v1/history?region=conus&lon=-93.6&lat=42.1'

That Iowa coordinate returns annual rows with year, status, crop code/name, resolution, and retrieval time. The same point classified as Corn in 2025, Soybeans in 2024, Corn in 2023, and Corn in 2022. These are pixel classes, not field-wide declarations.

Available endpoints

GET /api/catalog

Regions, years, classifications and crop legend.

GET /api/field?region=conus&lon=-93.6&lat=42.1

USDA CSB field geometry and majority crops for its 2015–2022 record window. Returns ok, nodata, or unsupported.

GET /api/history?region=conus&lon=-93.6&lat=42.1

Annual USDA CDL classifications sampled at one coordinate. Each year has its own status; a failed year is not silently filled.

GET /api/vessels?client=my-research-session&bbox=3.9,51.8,4.6,52.1

Recently received AIS positions for the requested view. client identifies a temporary collection lease. It is not a complete vessel census.

GET /api/vessels/history?mmsi=123456789&days=30

Available Open Waters observations for a selected vessel. days accepts 1, 7, 30, 90. Follow nextBefore with before and preserve requestedTo as end for the next page; gaps are not interpolated.

GET /api/aircraft?bbox=3.9,51.8,4.6,52.1

Observed aircraft in a bounded view from ADSB.lol. Read status, sourceTime, fetchedAt, and nextRefreshAfter before refreshing.

Full OpenAPI 3.1 contract ↗

Commerce, social and digital demand

These routes have working server-side adapters and normalized contracts. Customer access is currently disabled pending distribution rights and operating controls; calls return 503 market_data_not_enabled. The endpoint catalog remains queryable with a key. Product and social snapshots have variable collection latency.

GET /v1/market/catalog

Current availability of connected and integration-preview data families.

GET /v1/market/commerce/product?url=https://www.amazon.com/dp/{ASIN}

Product listing snapshot: productId, title, price, currency, availability, rating, reviewCount and any displayed recent-purchase indicator. Displayed indicators are not audited sales.

GET /v1/market/commerce/shop-product?url=...

TikTok Shop listing snapshot, using the same commerce schema.

GET /v1/market/social/x-post?url=...

A public X post with stable ID, author, text, publishedAt, collectedAt and engagement snapshot. Profile and TikTok post routes use the same observed-post contract.

GET /v1/market/domain-search?domain=example.com

Estimated monthly organic and paid search visits in US Google search, updated weekly. This is not measured total site traffic, commerce sales or company revenue.

POST /v1/market/social/analyze

Model-generated sentiment and possible asset exposure, with rationale, counterargument and uncertainty. Requires separate model configuration. Output always requires human review and never places trades.

Long collections return 202 and a jobToken; poll GET /v1/market/collections/{jobToken} using the same key. Respect Retry-After. See the social monitoring workflow and OpenAPI schemas.

Connect an Agent

Download the Agent kit containing the AxisDatum Skill and a local MCP server. The skill gives source-aware research instructions and market-data contracts; the MCP server currently exposes agriculture, vessel and aircraft tools over stdio. Unzip it, run npm ci inside integrations/mcp, then add this configuration to your MCP client:

{
  "mcpServers": {
    "axisdatum": {
      "command": "node",
      "args": ["/absolute/path/to/axisdatum/integrations/mcp/server.mjs"],
      "env": { "AXISDATUM_API_BASE": "https://axisdatum.com" }
    }
  }
}

The API base can also point at a local server, such as http://127.0.0.1:8787. The Agent skill explains crop, vessel, aircraft, commerce, social and search-demand schemas, including what is available today and what remains gated.

Interpretation and usage

  • CDL history is the currently served historical release, not a point-in-time archive of past publication states.
  • CSB boundaries are inferred crop fields, not surveyed property parcels; the connected hosted service's majority crop records end in 2022.
  • AIS and ADS-B are received observations. Empty or stale responses cannot prove that no ship or plane was present.
  • Historical vessel tracks may be sparse or paginated. A line between distant observations is not an inferred voyage.
  • Bound queries and respect 429 responses and nextRefreshAfter. The public API has no uptime, capacity or redistribution SLA.