> For the complete documentation index, see [llms.txt](https://docs.paired.world/whitepaper/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.paired.world/whitepaper/token-ecosystem/soul-token/levelling.md).

# Levelling

Engagement within the PairedWorld ecosystem mirrors the intricacies of real-life interactions, underscoring the importance of cultivating genuine relationships within one’s network. SOUL token holders can 'level up' their SOULs, reflecting the enrichment of these bonds and their growing stature within the ecosystem. Yet, despite being reflected on-chain, a SOUL's level is a testament of one's activity in real life, showcasing the tangible impact of contributions and affiliations within the ecosystem. As the SOUL levels up, it becomes a vivid representation of one’s dedication, influence, and the depth of their ties, carving out their distinct persona within the PairedWorld. Moreover, the concept of SOUL levelling introduces an intriguing third incentive pillar to the ecosystem – the status game. At one extreme, we have the ultimate goal, a guiding beacon – forming meaningful human connections, a necessity not only for survival but also for leading a fulfilled life. This forms the intrinsic incentive that fuels the desire to engage more deeply within the PairedWorld.

Conversely, on the other end of the spectrum, we find the external, more immediate incentive – the rewards offered by the [$PAIRED](/whitepaper/token-ecosystem/usdpaired.md) token. This provides tangible benefits that reinforce the immediate value of active participation within the ecosystem.

Intersecting these two incentives, the Levelling mechanism and SOUL tokens introduce a third critical element – a badge of honour that plays on status and reputation. This powerful motivator encourages individuals to contribute to the ecosystem, providing a balanced blend of intrinsic and extrinsic motivation. This intrinsic, extrinsic, and status-based triad of incentives ensures a dynamic, engaging, and sustaining environment within the PairedWorld ecosystem.

####

**SOUL Levelling Criteria**

<table><thead><tr><th>Level</th><th width="86">Events</th><th width="157">$PAIRED Burned</th><th width="129">Connections (Unique/Depth)</th><th width="160">Invites (Ext./Int.)</th><th>Meaningfulness Score</th></tr></thead><tbody><tr><td>0</td><td>0</td><td>0</td><td>-</td><td>0 / 0</td><td>-</td></tr><tr><td>1</td><td>2</td><td>200</td><td>5 / 5</td><td>0 / 0</td><td>10</td></tr><tr><td>2</td><td>20</td><td>500</td><td>50 / 7</td><td>0 / 5</td><td>100</td></tr><tr><td>3</td><td>50</td><td>10000</td><td>100 / 10</td><td>0 / 20</td><td>200</td></tr><tr><td>4</td><td>100</td><td>25000</td><td>200 / 15</td><td>0 / 50</td><td>350</td></tr><tr><td>5</td><td>200</td><td>50000</td><td>400 / 20</td><td>10 / 150</td><td>500</td></tr></tbody></table>

The parameters in the table above define the requirement needed for upgrading the SOUL. Initially Levels 0-5 are unlocked, additional Levels will be unlocked at a later stage.

1. Minimum number of events a user needs to attend to achieve a particular SOUL LeveL
2. THE amount of $PAIRED Tokens a user needs to burn (or spend) to upgrade to that specific SOUL level, once all other criteria are met.
3. The number of external invitations a user needs to send and successfully get accepted. This privilege of onboarding new users, will be unlocked at a later stage.
4. The number of internal invitations a user needs to send and successfully get accepted, to other users of PairedWorld to attend existing events.
5. The number of distinct connections or contacts a user needs to establish for a particular SOUL Level.
6. The quality or depth of connections. Instead of merely increasing numbers, depth ensures that users are forming meaningful relationships within the platform. The depth logic can be found [here](/whitepaper/participation/connection.md).

#### SOUL Basics

The “SOUL Basics” table below summarises the colour assigned to each level, how a specific level can be achieved and ultimately, what multiplier in the SPARKs Issuance each specific Level has.

<table><thead><tr><th width="91">Level</th><th width="115">Colour</th><th width="338">Acquisition</th><th align="center">SPARKs per SOUL/M</th></tr></thead><tbody><tr><td>1</td><td>Purple</td><td>Partner NFT community, through  invite link or waiting list claim</td><td align="center">1</td></tr><tr><td>2</td><td>Blue</td><td>Founding Partner NFT or upgrade</td><td align="center">2</td></tr><tr><td>3</td><td>Turquoise</td><td>Assigned by Council or upgrade</td><td align="center">3</td></tr><tr><td>4</td><td>Pink</td><td>Upgrade</td><td align="center">4</td></tr><tr><td>5</td><td>Green</td><td>Upgrade</td><td align="center">5</td></tr></tbody></table>


---

# 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://docs.paired.world/whitepaper/token-ecosystem/soul-token/levelling.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.