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

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

FieldTypeDescription
pubkeysarrayArray of base58 public keys you want to compress.
Max 64 keys per request.
no_jitobooleanFilter out ALTs that contain tip accounts for Jito.
no_heliusbooleanFilter out ALTs that contain tip accounts for Helius.
no_bloxroutebooleanFilter out ALTs that contain tip accounts for Bloxroute.
no_temporalbooleanFilter out ALTs that contain tip accounts for Temporal.
no_fastbooleanFilter out ALTs that contain tip accounts for Fast.
no_razorbooleanFilter out ALTs that contain tip accounts for Razor.
no_stelliumbooleanFilter out ALTs that contain tip accounts for Stellium.
no_node1booleanFilter out ALTs that contain tip accounts for Node1.
no_flashblockbooleanFilter out ALTs that contain tip accounts for Flashblock.
no_zero_slotbooleanFilter out ALTs that contain tip accounts for 0slot.
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"
    ],
    "no_zero_slot": true,
    "no_jito": true
  }'

Response Format

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