Platform

Orinverse API (draft)

Orinverse is a coordinates-based data layer. This section outlines the minimal API required to create and read map points.

This section is a design draft. URLs, authentication, and response formats must be confirmed before implementation.

Point data model

Field	Type	Description
`id`	string	Unique identifier for the point.
`lat`	number	Latitude (required).
`lon`	number	Longitude (required).
`title`	string	Short point title.
`payload`	object	Custom data (message, metadata, links).
`tags`	string[]	Tags for filtering and grouping.
`anchorTx`	string	Optional ORIN transaction anchoring the data.
`createdAt`	string	ISO timestamp of creation.
`updatedAt`	string	ISO timestamp of last update.

Create a point

POST /api/v1/points

{
  "lat": 55.751244,
  "lon": 37.618423,
  "title": "Example point",
  "payload": {
    "text": "Sample Orinverse entry",
    "link": "https://orinverse.cash"
  },
  "tags": ["info", "community"]
}

Responses should return the new id and optional anchorTx.

Read and search points

GET /api/v1/points/{id} — fetch a single point.
GET /api/v1/points?bbox=lat1,lon1,lat2,lon2 — search by bounding box.
GET /api/v1/points?tags=community,news — tag filters.

Update and delete

PATCH /api/v1/points/{id} — partial update.
DELETE /api/v1/points/{id} — remove or unpublish.

ORIN anchoring

When publishing points, consider anchoring the payload hash in ORIN. Orinverse should return anchorTx and confirmation data when available.