Lookups
Discover the most efficient Address Lookup Tables already live on Solana
Lookups is Circular’s discovery API for Solana Address Lookup Tables (ALTs). Instead of creating and funding new lookup tables, this API scans all existing ALTs on Solana and surfaces the most optimal ones for your specific set of addresses.
The insight: in many cases, the lookup you need already exists.
Lookups finds it for you... instantly.

Why Lookups exists
Creating and maintaining Address Lookup Tables comes with real costs:
SOL spent on creation and updates
Extra transactions in critical paths
Operational complexity for developers
Fragmentation across bots, wallets and infra
Yet Solana already contains thousands of live lookup tables, many of which:
Are well-packed
Frequently reused
Cover 99.99% of DeFi addresses
Lookups turns this fragmented state into a searchable optimization layer.
How it works
Input: Your Address Set
Provide a list of Solana addresses required by your transaction:
Programs
Token mints
AMM pools
Vaults
PDAs
Any account needed for execution
Global ALT Monitoring
Circular continuously:
Indexes all Address Lookup Tables on Solana
Tracks their contents and evolution
Maintains an up-to-date registry of live ALTs
Matching & Scoring
For your address set, ALT Search Engines:
Finds existing ALTs that already include your required addresses
Scores them by coverage, density and reuse efficiency
Ranks the most cost-effective options
Output: Ready-to-Use Lookups
You receive:
The best-matching ALT(s)
Coverage ratios (how much of your set is already included)
Deterministic ordering for direct transaction inclusion
No creation. No updates. Just reuse.
Key Benefits
💸 Zero Creation Cost
Reuse existing lookup tables and:
Avoid SOL spent on ALT creation
Avoid future update fees
Reduce transaction overhead immediately
⚡ Faster Execution Paths
Skip the entire ALT lifecycle:
No warm-up phase
No dependency on setup transactions
Ideal for bots, developers and time-sensitive flows
🧩 Simplified Developer Experience
Developers focus on:
Building transactions
Composing DeFi logic
Scaling strategies
Not on lookup table plumbing.
The Payoff
Lookups lets you:
Reuse instead of rebuild
Spend less SOL
Move faster
Execute more complex transactions with less friction
On solana, the best lookup table is the one that already exists.
Last updated
