API Documentation

LOL API provides fast, reliable access to XRPL data through our dedicated CLIO infrastructure.

Quick Start

Base URL

https://api.getlol.xyz/api/v1

Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Or use the X-API-Key header: X-API-Key: YOUR_API_KEY

Example Request

cURL
curl -X POST https://api.getlol.xyz/api/v1 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "nft_info",
    "params": [{
      "nft_id": "000800006203F49C21D5D6E022CB16DE3538F248662FC73C29252F2B00000001"
    }]
  }'

Response

{
  "result": {
    "nft_id": "000800006203F49C21D5D6E022CB16DE3538F248662FC73C29252F2B00000001",
    "owner": "rN5mG...",
    "is_burned": false,
    "flags": 8,
    "transfer_fee": 0,
    "issuer": "r...",
    "nft_taxon": 0,
    "nft_serial": 1,
    "uri": "..."
  },
  "status": "success"
}

Available Endpoints

Free Tier

0.1 XRP / 1000 requests
server_infoGet CLIO server information
ledgerGet ledger data by index or hash
ledger_closedGet the most recently closed ledger
ledger_currentGet the current in-progress ledger

Basic Tier

0.2 XRP / 1000 requests
account_infoGet account information
account_linesGet trust lines for an account
account_txGet transactions for an account
txGet transaction by hash
book_offersGet offers between two currencies

Premium Tier

0.5 XRP / 1000 requestsCLIO-EXCLUSIVE
nft_infoGet NFT metadata and properties
nft_historyGet full NFT transaction history
account_nftsGet all NFTs for an account
nft_sell_offersGet active sell offers for an NFT
nft_buy_offersGet active buy offers for an NFT

Rate Limits

PlanRate LimitBurst
Pay As You Go100 req/sec200
Starter50 req/sec100
Pro200 req/sec500
Enterprise1000 req/sec2000

Error Codes

401Invalid or missing API key
400Invalid request body or unsupported method
429Rate limit exceeded
502CLIO server unavailable