# Empire Builder Docs

- [Introduction](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/introduction.md)
- [Overview](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/overview.md)
- [Founders & Vision](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/founders-and-vision.md)
- [How Empires Work](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/how-empires-work.md)
- [Leaderboards](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/how-empires-work/leaderboards.md)
- [Boosters](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/how-empires-work/boosters.md)
- [Treasury](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/how-empires-work/treasury.md)
- [Integration Patterns](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/how-empires-work/integration-patterns.md)
- [Example - BizarreBeasts ($BB)](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/how-empires-work/example-bizarrebeasts-usdbb.md)
- [Use Cases](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/use-cases.md)
- [Ecosystem Participation](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/ecosystem-participation.md)
- [API](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api.md): Empire Builder exposes HTTPS JSON endpoints for listing empires, leaderboards, boosters, rewards, treasury operations, deploy flows, and more.
- [Public](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/public.md)
- [Get Top Empires](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/public/get-top-empires.md): Retrieves a paginated list of top Empire tokens.
- [Get Boosters By Empire](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/public/get-boosters-by-empire.md): Retrieves the list of boosters configured for a specific Empire.
- [Get Distribution Records](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/public/get-distribution-records.md): Retrieves cumulative distribution totals per recipient for an empire
- [Get Empire Rewards](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/public/get-empire-rewards.md): Retrieves reward history (distributions, burns, airdrops) for an empire.
- [Get Empires](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/public/get-empires.md): Retrieves a paginated list of Empires with different filtering options.
- [Get Leaderboard By Empire](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/public/get-leaderboard-by-empire.md): Retrieves all addresses on a specific Empire leaderboard
- [Get Leaderboard Stats for Single Address within Empire](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/public/get-leaderboard-stats-for-single-address-within-empire.md): Retrieve the leaderboard score, boosters, and ranking for a single address within a specific Empire.
- [Get Top Empires](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/public/get-top-empires-1.md): Retrieves a paginated list of top empires by their ranking
- [Authenticated](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated.md)
- [Add Booster](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/add-booster.md): Adds a new score multiplier booster to an empire.
- [Remove Booster](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/remove-booster.md): Removes a booster from an empire.
- [Add Staking Booster](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/add-staking-booster.md): Adds a staking booster to an empire.
- [Remove Staking Booster](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/remove-staking-booster.md): Removes a Staking booster from an empire.
- [Activate Staking](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/activate-staking.md): Turns on staking for an empire.
- [Create Leaderboard](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/create-leaderboard.md): Creates a new leaderboard for an empire.
- [Delete Leaderboard](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/delete-leaderboard.md): Deletes a leaderboard from an empire.
- [Deploy Empire for Existing Token](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/deploy-empire-for-existing-token.md): Deploy an Empire for an existing token.
- [Deploy Tokenless Empire](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/deploy-tokenless-empire.md): Deploy an Empire for a Farcaster profile or custom hub
- [Deploy New Token with Empire](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/deploy-new-token-with-empire.md): Deploy a new Clanker token with an attached Empire in a single flow.
- [Refresh Leaderboard By Empire](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/refresh-leaderboard-by-empire.md): Updates and overwrites the scores for a specific Empire leaderboard and returns the updated rankings.
- [Store Clanker Airdrop](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/store-clanker-airdrop.md): Registers a Clanker launch airdrop recipient list and claim records after the airdrop contract has been deployed on-chain.
- [Store Burn](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/store-burn.md): Records a completed on-chain token burn to an Empire
- [Store Distribution](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/store-distribution.md): Records a completed on-chain distribution and updates per-recipient USD totals.
- [Prepare Distribute](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/authenticated/prepare-distribute.md): Prepare a treasury distribution
- [Get Leaderboard By Empire](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/get-leaderboard-by-empire.md): Retrieves all addresses on a specific Empire leaderboard with their initial token balances, applied boosts, final score, and ranking.
- [Get Empires](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/get-empires.md): Retrieves a paginated list of Empires with different filtering options.
- [Get Boosters By Empire](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/get-boosters-by-empire.md): Retrieves the list of boosters configured for a specific Empire.
- [Get Leaderboard Stats for Single Address within Empire](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/get-leaderboard-stats-for-single-address-within-empire.md): Retrieve the leaderboard score, boosters, and ranking for a single address within a specific Empire.
- [Deploy Empire for Existing Token](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/deploy-empire-for-existing-token.md): Deploy a Empire Contract for an existing token on Base
- [Deploy Token with Attached Empire](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/deploy-token-with-attached-empire.md): Deploy a new Clanker token with an attached Empire contract in a single call
- [Refresh Leaderboard By Empire](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/api/refresh-leaderboard-by-empire.md): Updates and overwrites the scores for a specific Empire Leaderboard onchain and returns the updated rankings.
- [Contracts](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/contracts.md)
- [Empire Treasury (Read)](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/contracts/empire-treasury-read.md): List of relevant read calls for Empire treasury contracts
- [Empire Treasury (Write)](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/contracts/empire-treasury-write.md): Relevant write calls for Empire Treasury contracts.
- [Distribute Tokens](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/contracts/empire-treasury-write/distribute-tokens.md): Distribute tokens to specified leaderboard
- [Burn](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/contracts/empire-treasury-write/burn.md): Burns specified token
- [Guardian Management](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/contracts/empire-treasury-write/guardian-management.md): Add and remove co-guardians: extra wallets that can help run an empire.
- [NFT Airdrop](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/contracts/nft-airdrop.md): Send ERC-721 or ERC-1155 assets from the caller’s wallet to recipients in one transaction.
- [ERC-20 Airdrop](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/contracts/erc-20-airdrop.md): Send ERC-20 tokens from the caller’s wallet to many recipients in one transaction.
- [Staking Locker](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/contracts/staking-locker.md)
- [Empire Factory Contract](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs/contracts/empire-factory-contract.md): List of relevant read calls for the Empire Factory contract


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.