> For the complete documentation index, see [llms.txt](https://docs.pearlswap.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pearlswap.ai/readme.md).
# Pearl Swap
Turn anything you hold into Pearl's own coin, and move PRL between Pearl and Hyperliquid.
Pearl Swap does two things.
**It gets you PRL.** Pay with whatever you already hold, on whatever network you hold it, and native PRL arrives at your own Pearl address. You do not need an account with us, or with an exchange, and you never hand us your coins to look after.
**It moves PRL between Pearl and Hyperliquid.** PRL on Hyperliquid can be traded against USDC on a real order book. PRL on Pearl is the coin itself. The same PRL can be on either side, and one is always exchangeable for the other, one for one.
Between the two sides sits an escrow that no single party controls: every PRL on Hyperliquid is matched by a PRL held on Pearl by three independent guardians, of whom any two must agree before anything moves. None of them can move it alone, and that includes us.
{% hint style="warning" %}
**Test networks only, for now.** Pearl Swap runs end to end on test networks. On the live site you can see prices, but payments are switched off and no real money can move. [Where the project stands](/reference/status.md) says what is finished and what is not.
{% endhint %}
Pay with what you have. The figure you see is the figure that arrives.
### Where to start
* [What Pearl is](/introduction/pearl.md) — the chain and the coin, if you are new to it.
* [What Pearl Swap is](/introduction/pearl-swap.md) — the problem this solves, and how.
* [Swapping into PRL](/use-it/swapping.md) — you hold something else and want PRL.
* [Moving PRL to Hyperliquid and back](/use-it/moving-prl.md) — you already hold PRL.
* [The short version](/how-it-works/overview.md) — what happens behind the screen.
* [Who can do what](/how-it-works/trust.md) — the honest account of what you are trusting.
---
# 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.pearlswap.ai/readme.md?ask=&goal=
```
`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.
