Skip to main content

​
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

ChainChain IDStatus
Base Sepolia84532Active
Ethereum Sepolia11155111Active
Arbitrum One42161Active
Celo42220Active
Base8453Coming 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

NeedAPI
”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