API Documentation

Developer API Reference

Integrate our high-performance Address Lookup Table (ALT) cache directly into your trading bot or dApp. Sub-millisecond responses, global coverage, and 99.99% uptime.

Authentication

API Keys
Rate Limits
Performance

Endpoints

Find ALTs

Authentication

All API requests require a valid API key. You can pass your API key in the request header x-api-key.

Header Example

curl -X POST https://api.dontlookup.lol/find_alts \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ ... }'

Rate Limits

Rate limits are enforced on a per-key basis depending on your subscription plan.
If you exceed your limit, the API will return a 429 Too Many Requests response.

Performance & Latency

Expected Latency

Our infrastructure is optimized for high-frequency trading. If your servers are located in Amsterdam, NL (or nearby), you can expect an average response time of 10-15ms on a warm connection.

Optimizing Connection Speed

The first request to the API establishes the TCP and SSL handshake, which can take 100ms+ depending on your RTT.

To achieve "blazingly fast" performance (~10ms), you MUST use a Keep-Alive connection (Persistent Connection) to reuse the established socket for subsequent requests.

Python (Fast)

import requests

# BAD: Creates a new connection every time (~100ms latency)
# requests.post(...) 

# GOOD: Reuse session (Keep-Alive) (~15ms latency)
session = requests.Session()
session.headers.update({
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY"
})

url = "https://api.dontlookup.lol/find_alts"

# First request (Handshake overhead)
resp1 = session.post(url, json={...}) 

# Subsequent requests (Instant)
resp2 = session.post(url, json={...})

Find ALTs

POST/find_alts

Find the best best Address Lookup Tables to cover a given set of Solana public keys. Optimized for transaction size reduction.

Request Body

Field	Type	Description
pubkeys	array	Array of base58 public keys you want to compress. Max 64 keys per request.
jito	boolean	Include ALTs that contain tip accounts for Jito. Default: false
helius	boolean	Include ALTs that contain tip accounts for Helius. Default: false
bloxroute	boolean	Include ALTs that contain tip accounts for Bloxroute. Default: false
temporal	boolean	Include ALTs that contain tip accounts for Temporal. Default: false
fast	boolean	Include ALTs that contain tip accounts for Fast. Default: false
razor	boolean	Include ALTs that contain tip accounts for Razor. Default: false
stellium	boolean	Include ALTs that contain tip accounts for Stellium. Default: false
node1	boolean	Include ALTs that contain tip accounts for Node1. Default: false
flashblock	boolean	Include ALTs that contain tip accounts for Flashblock. Default: false
soyas	boolean	Include ALTs that contain tip accounts for Soyas. Default: false
lightspeed	boolean	Include ALTs that contain tip accounts for LightSpeed. Default: false
aura	boolean	Include ALTs that contain tip accounts for Aura. Default: false
falcon	boolean	Include ALTs that contain tip accounts for Falcon. Default: false
lunar	boolean	Include ALTs that contain tip accounts for Lunar. Default: false
astra	boolean	Include ALTs that contain tip accounts for Astra. Default: false
blocksprint	boolean	Include ALTs that contain tip accounts for Blocksprint. Default: false
zero_slot	boolean	Include ALTs that contain tip accounts for 0slot. Default: false

cURL

curl -X POST https://api.dontlookup.lol/find_alts \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "pubkeys": [
        "So11111111111111111111111111111111111111112",
        "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
    ],
    "zero_slot": true,
    "jito": true,
    "soyas": true,
    "lightspeed": true,
    "aura": true,
    "falcon": true,
    "lunar": true,
    "astra": true,
    "blocksprint": true
  }'

Response Format

JSON Response

{
  "alts": [
    "2D4f...1a2b", 
    "9X3z...8c7d"
  ],
  "coverage_count": 5,
  "missing_count": 0,
  "coverage_ratio": 1.0
}