API Reference — Overview

The Opsion REST API gives you programmatic access to all resources in your account.

Base URL

https://api.opsion.xyz/v1

Versioning

The API is versioned via the URL path (/v1). Breaking changes are released under a new version. Old versions are supported for at least 12 months after a new version ships.

Response format

All responses are JSON. Successful responses include the resource directly at the top level:

{
  "id": "wal_01j9xmk4p8q3r7t2v5",
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "label": "Vitalik",
  "chains": ["ethereum", "base"],
  "created_at": "2025-01-15T09:41:00Z"
}

List endpoints return a data array with pagination metadata:

{
  "data": [ /* ... */ ],
  "pagination": {
    "total": 42,
    "page": 1,
    "per_page": 20,
    "next_cursor": "cur_01j9xmk4p8q3r7t2"
  }
}

Errors