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

# Market

The Market is where listed markers appear on a **global map**, so collectors can discover and buy them, and creators can be rewarded for the stories they helped shape.

On this page, you don’t see every marker that exists in Piny. You only see **markers that currently have an active listing**.

## Market map overview

When you open the Market page, you see a full‑screen map focused on your area or a default world view:

* **Only listed markers** are shown on this map – each one represents an NFT that is currently for sale.
* You can **move around the map** and **zoom in or out** to explore different regions and see where listed markers are located.
* Clicking a marker opens its detail view, where you can read the full story and, if it’s listed, see the sale information and buy it.

This turns trading into a geographic exploration: you discover NFTs by exploring places, not just scrolling a flat list.

## Filtering and searching markers

To help you find the markers you care about most, the Market map comes with powerful filters and search tools:

* **Text search**
  * You can search across multiple fields such as **name**, **message**, **minter**, **owner**, **event**, and **collection**.
  * Use this to quickly find a specific story, a creator you like, or markers from a particular event or collection.
* **Network filter**
  * You can filter listed markers by **network**, so you only see NFTs on the chains you care about.
  * This is useful if, for example, you only want to buy on a specific network.
* **Map‑based discovery**
  * As you pan and zoom, new markers in the visible area are loaded and shown on the map.
  * You can combine map movement with text search and network filters to narrow down exactly what you want.

The result is a **map‑first marketplace** where you can both browse freely and search with precision.

## Listing your marker for sale

You don’t list markers directly from the Market page. Instead, you go to the **marker detail page** of a marker you own and use the **Listing** tools there.

When you are the current owner of a marker and your wallet is connected:

* If the marker is **not listed yet**:
  * You see a **Listing** box with a **Create Sell Order** button.
  * When you click it, a dialog lets you:
    * Choose which **payment token** you want to accept (native coin or supported ERC‑20).
    * Set the **price** in that token.
    * If you are also the original minter, set an optional **creator fee** (a percentage, up to a fixed maximum) so you can earn on future resales.
  * After you confirm the transaction in your wallet, the marker becomes **listed** and starts appearing on the Market map with its price and payment token.
* If the marker is **already listed** and you are the seller:
  * You see the current **price**, **payment token**, and any **creator fee** applied on each sale.
  * You can:
    * **Edit** the listing to change the token, price, or (if you are the minter) the creator fee.
    * **Cancel** the listing to remove it from the Market.
  * Both actions require confirming a transaction in your wallet.

## Buying a marker from the Market

There are two main ways to buy a listed marker:

* **Directly from the Market map**
  * Find a marker on the map using panning, zooming, filters, and search.
  * Click on it to open the marker’s detail view.
* **From a marker detail page you reached elsewhere**
  * You might arrive at a marker from Explore, a collection, or an event, and then notice it is **listed for sale**.

When you look at someone else’s marker that is listed for sale and your wallet is connected:

* You see a **Listing** box with the **price** and **payment token**.
* If there is a creator fee, you also see the **percentage** that will go to the original creator.
* If you are eligible to buy, you see a **Buy** button:
  * The app checks your balance and, if needed, asks you to **approve** the payment token.
  * Then your wallet asks you to **confirm the purchase**.
  * After a successful transaction, you become the **new owner** of the marker and the listing disappears from the Market.

## Sale history

The Market also includes a **Sale History** section where you can see recent trades across the platform:

* A list of past sales with key details, such as buyer, seller, price, and network.
* A way to understand what kinds of markers are actively changing hands and at what levels.

This gives collectors and creators a transparent view of market activity over time.