LedgerCore
WelcomePortalsLedgerBrain AINewData CatalogAPI ReferenceLLMs.txtAIChangelog
Getting Started

Quick Start

Get up and running with LedgerLink API in under 5 minutes.

Prerequisites

  • API key (contact [email protected])
  • Basic understanding of REST APIs
  • Your favorite HTTP client (curl, Postman, or code)

Your First API Call

Using curl

curl -X GET "http://localhost:8090/api/v1/capabilities" \
  -H "Authorization: Bearer YOUR_API_KEY"

Using JavaScript

const response = await fetch('http://localhost:8090/api/v1/capabilities', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

Using Python

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.get(
    'http://localhost:8090/api/v1/capabilities',
    headers=headers
)

data = response.json()
print(data)

Common Endpoints

Get Market Data

curl -X GET "http://localhost:8090/api/v1/market-data/candles?symbol=BTC-USD&interval=1h&limit=24" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Unified Engine

curl -X POST "http://localhost:8090/api/v1/query" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "connector": "market-data",
    "dataType": "candles",
    "filters": {
      "symbol": "BTC-USD"
    },
    "limit": 100
  }'

Screen Transaction (KYT)

curl -X POST "http://localhost:8090/api/v1/kyt/transactions/screen" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "txHash": "0x1234...",
    "blockchain": "ethereum"
  }'

Response Format

All API responses follow a consistent format:

{
  "data": [...],
  "meta": {
    "total": 100,
    "page": 1,
    "limit": 50
  },
  "timestamp": "2026-01-20T12:00:00Z"
}

Error Handling

Errors return appropriate HTTP status codes with detailed messages:

{
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "Invalid symbol format",
    "details": {
      "parameter": "symbol",
      "expected": "BASE-QUOTE format (e.g., BTC-USD)"
    }
  }
}

Next Steps

Need Help?

Was this page helpful?