Skip to main content
All LucidLayer API endpoints are available via standard HTTP requests. The API follows REST conventions with JSON request/response bodies.

​
Base URL

https://api.lucid.foundation

​
Authentication

Include your API key as a Bearer token: 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.lucid.foundation/v1/passports
For passport ownership operations, include the owner address header: 
curl -H "X-Owner-Address: YOUR_WALLET_ADDRESS" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.lucid.foundation/v1/passports

​
Quick Examples

​
List Passports

curl https://api.lucid.foundation/v1/passports?per_page=10

​
Create a Passport

curl -X POST https://api.lucid.foundation/v1/passports \
  -H "Content-Type: application/json" \
  -d '{
    "type": "model",
    "owner": "YOUR_WALLET",
    "name": "my-model",
    "version": "1.0.0",
    "metadata": {
      "schema_version": "1.0",
      "name": "my-model"
    }
  }'

​
Run Chat Completion

curl -X POST https://api.lucid.foundation/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_PASSPORT_ID",
    "messages": [
      {"role": "user", "content": "Explain LucidLayer in one sentence."}
    ]
  }'

​
Check System Health

curl https://api.lucid.foundation/health

​
API Groups

GroupBase PathEndpoints
Passports/v1/passports8
Inference/v1/chat/completions, /v1/run, /v1/match5
Convenience/v1/models, /v1/compute, /v1/tools, /v1/datasets, /v1/agents5
Receipts/v1/receipts, /v1/verify, /v1/mmr9
Epochs/v1/epochs8
Payouts/v1/payouts4
Compute/v1/compute/nodes2
Health/health7
Agents/api/agents14+

​
Full API Reference

See the API Reference tab for interactive documentation of all 65+ endpoints, auto-generated from the OpenAPI spec.