# 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.

<figure><img src="https://2446928659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsDSgqfb5mOU08vWHmBNM%2Fuploads%2FIPcagzXivLTrOy0mSjPC%2FChatGPT%20Image%2030%20d%C3%A9c.%202025%2C%2021_31_21.png?alt=media&#x26;token=a2f02eb8-80ef-4e07-a77b-40d565b8b89e" alt="" width="563"><figcaption></figcaption></figure>

### 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**.
