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

# Universal Points Income

The Onyx Points system is built around immediate utility, aligning platform activity with a mechanism that enable users to derive value from the very beginning.

***

### Universal Points Income (UPI)

Every trade executed on Onyx earns users Onyx Points based on platform activity. Unlike traditional points systems that rely solely on the expectation of a future token distribution, Onyx Points are designed to have utility from day one through the Onyx Universal Points Income (UPI) mechanism.

UPI is a weekly auction system funded by platform fees. Every week, users may choose to bid their Onyx Points in exchange for a pro-rata share of the pool. Points used in bids are permanently burned.

This creates two core dynamics within the ecosystem:

* Point Bidders: Receive real value during the points accumulation phase
* Point Holders: Benefit from compounded deflationary pressure on the weekly points, increasing point scarcity and their aggregate point share over time

Participation in UPI is optional. Users can either retain their points for future utility or burn them to access a share of platform-generated fees. This structure aligns incentives between the protocol and its most active participants while reinforcing Onyx’s core philosophy: providing traders with more edge.

Onyx Points are earned continuously through platform activity. The more user activity, the more points they accumulate and the larger their participation within the Onyx ecosystem becomes.

***


---

# 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, and the optional `goal` query parameter:

```
GET https://tradewithonyx.gitbook.io/docs/onyx/onyx-points/universal-points-income.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
