Get Started

Getting Started

Make your first authenticated request to the Label platform API in a few minutes.

Services & base URLs

The platform exposes three independently versioned services. Each uses URL path versioning (/api/v1/...) and is documented by its own OpenAPI 3.0.3 spec.

ServiceBase pathReference
Label Backend/api/v1Label Backend API
AEOS/api/v1/aeosAEOS API
Data Pipeline/api/v1/data-pipelineData Pipeline API

1. Get an API key

Sign in to the dashboard and create an API key under Settings → API Keys. Treat the key as a secret — it carries the permissions of your account. See Authentication for the full set of supported credentials.

2. Make your first request

Authenticate with a bearer token in the Authorization header. This call lists the wallets visible to your account:

curl https://api.example.com/api/v1/wallets \
  -H "Authorization: Bearer $LABEL_API_KEY" \
  -H "Accept: application/json"

3. Read the response

List endpoints return a paginated envelope. Collections live under data, with a pagination object describing how to fetch the next page:

{
  "data": [
    { "id": "wlt_01H...", "balance": 1250, "currency": "USD" }
  ],
  "pagination": { "limit": 20, "nextCursor": "eyJ..." }
}

See Pagination & Errors for the cursor contract and the standard error envelope.

Generating a typed client

Every spec can be downloaded from its API reference page and fed to openapi-typescript, oapi-codegen, or openapi-generator to produce a typed client in your language.

Next steps