Page cover

folder-magnifying-glassLookups

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