> For the complete documentation index, see [llms.txt](https://empire-builder.gitbook.io/empire-builder-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://empire-builder.gitbook.io/empire-builder-docs/empire-builder-docs.md).

# 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