> For the complete documentation index, see [llms.txt](https://docs.ape.bond/apebond/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ape.bond/apebond/products-and-features/apeboost/automatic-tier-optimization.md).
# Automatic Tier Optimization
Instead of making users manually calculate whether reaching the next tier is worth it, ApeBoost can check the numbers automatically during the Bond purchase flow.
If upgrading creates more value for the user, the system can handle the tier upgrade as part of the same transaction.
### Why It Matters
Ape Tiers unlock extra discounts on Bond purchases.
The higher the tier, the stronger the extra discount.
However, users may not always know when it makes sense to increase their position, unlock a new tier, or move closer to the next one.
Automatic Tier Optimization solves this by checking whether upgrading during an eligible Bond purchase would be beneficial.
### How It Works
When a user is about to buy an eligible Bond, ApeBoost can check their current Ape Points and tier position.
If the user is close to the next Ape Tier, the system compares:
* the value of reaching the next tier
* the extra discount the user would receive on the Bond
* the cost required to reach that tier
If the upgrade creates more value than it costs, ApeBoost can optimize the purchase automatically.
The user receives the expected payout tokens from the Bond, while also improving their ApeBoost position and unlocking stronger benefits for future purchases.
### Example
A user wants to buy an eligible Bond and is close to reaching the next Ape Tier.
Before completing the purchase, ApeBoost checks whether upgrading to that tier would improve the deal enough to make the upgrade worth it.
If the answer is yes, the system can upgrade the user during the same transaction.
As a result, the user gets the Bond they wanted, benefits from the improved tier conditions, and keeps a stronger position for future Bond purchases.
### No Manual Calculations Needed
Without Automatic Tier Optimization, users would need to decide manually:
* when to increase their position
* whether they are close enough to the next tier
* whether the extra Bond discount is worth the cost
* whether upgrading now is better than waiting
ApeBoost removes that friction.
The system checks the opportunity directly during the eligible Bond purchase flow and applies the optimization when it benefits the user.
### Long-Term Benefits
Automatic Tier Optimization is not only about one purchase.
When a user unlocks or improves their tier, that stronger position can continue helping them across future eligible Bond purchases.
This can lead to:
* better Bond conditions
* higher Ape Tier progression
* more Ape Points
* stronger True Yield earning power
* improved long-term alignment with the ApeBond ecosystem
### Availability
Automatic Tier Optimization applies only when the conditions make sense for the user and the Bond is eligible for ApeBoost.
When available, users will see the relevant information directly during the Bond purchase flow.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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://docs.ape.bond/apebond/products-and-features/apeboost/automatic-tier-optimization.md?ask=
```
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.