Records API Overview

Query location attestations across chains

Records API

The Records API provides read access to location attestations stored on EAS across multiple blockchains.

The Records API is part of the Astral API service.

Base URL

https://api.astral.global/api/v0

Purpose

While the Compute API performs geospatial operations, the Records API lets you:

• Query existing location attestations by chain, address, or time range
• Retrieve attestations by UID
• Filter by geographic bounding box
• Get statistics across chains

Authentication

No authentication required for read operations. Rate limiting applies by IP address.

Supported Chains

Chain	Chain ID	Status
Base Sepolia	84532	Active
Ethereum Sepolia	11155111	Active
Arbitrum One	42161	Active
Celo	42220	Active
Base	8453	Coming soon

Quick Example

# Get recent location records on Base Sepolia
curl "https://api.astral.global/api/v0/location-records?chain=base-sepolia&limit=10"

{
  "data": [
    {
      "uid": "0x1234...abcd",
      "chain": "base-sepolia",
      "prover": "0xabcd...1234",
      "timestamp": "2024-01-15T12:34:56Z",
      "location": "{\"type\":\"Point\",\"coordinates\":[2.2945,48.8584]}",
      "memo": "Eiffel Tower"
    }
  ],
  "count": 1,
  "limit": 10,
  "offset": 0
}

Available Endpoints

GET /location-records

List and filter location attestations

GET /location-records/:uid

Get a specific attestation by UID

GET /location-records/stats

Aggregated statistics

GET /config

API configuration and supported chains

Compute vs Records

Need	API
”Is this user within 500m of the landmark?”	Compute API
”Show me all attestations in San Francisco”	Records API
”Get a signed result for a smart contract”	Compute API
”List attestations by this address”	Records API