> For the complete documentation index, see [llms.txt](https://docs.tread.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tread.fi/agents/agent-marketplace.md).

# Agent Marketplace

The marketplace is where tread.fi users share the agents they have built.&#x20;

1. **Hire.** Browse agents built by other users and add one to your own agent list. Hiring is free. A hired agent runs on your accounts, under your own whitelist and limits, exactly like a built-in agent.
2. **Promote.** Publish your own custom agents so others can hire them. Every listing passes an automated AI safety review before it goes live. There is no human review and no fee.
3. **Sponsor.** A TREAD holder can back a listing. A sponsored agent is available to everyone with no hire, and its creator and sponsor share the builder fees it generates. See [TIP-3: Agent Sponsorship](https://docs.tread.fi/tread-improvement-proposals/tip-3-agent-sponsorship.md) for how that works.

### Browsing <a href="#user-content-browsing" id="user-content-browsing"></a>

Open **Agents → Marketplace**. The **Browse** tab lists every live agent in two sections, **Sponsored** first and then **Unsponsored**, with a **Featured** shelf at the top when tread.fi has picked some out. **My hired** lists the ones you have added.

<img src="https://3498068627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzGueudbPNYpRWNpS3Ilo%2Fuploads%2FxIofVlIaZtdLcl6FiftM%2FMarketplace%20browse%20page?alt=media&amp;token=7e591b01-0c5d-4f07-9871-1c6bd69bcd83" alt="Marketplace browse page" height="564" width="802">

Each card shows the agent's name, its author, a category badge such as Research or Single Order, a type pill, a one-line description and, in the footer, how many users have hired it, how many are running it now, and its 30-day volume.

The type pill tells you what the agent can do with your account:

* **Read-only** agents analyse and research. They never place orders.
* **Trades** agents place live orders on the account you connect.
* **Standing** agents keep running once started rather than finishing a single task. **\[**

Sort by **Trending**, **Most hired** or **Newest**. The **All / Sponsored / Unsponsored** buttons narrow the list, and you can filter by category, type, tags, venue, 30-day volume or author.

### Hiring an agent <a href="#user-content-hiring-an-agent" id="user-content-hiring-an-agent"></a>

Open a listing to see its guide (**Overview**, **Examples**, **Access & Limits**), its details and its published versions. The **Access** line at the top reads **Can place orders** or **Read-only**, and the **Access & Limits** tab gives the per-job order cap the author set.

<img src="https://3498068627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzGueudbPNYpRWNpS3Ilo%2Fuploads%2FyKThW4XFWg1y6E4sVdGz%2FListing%20detail%20page?alt=media&amp;token=5f8d3672-0448-40b1-b40b-e8dbbf738ae2" alt="Listing detail page" height="565" width="802">

What the button says depends on whether the agent has a sponsor:

* **Sponsored agents** show **Start task**. They are already in every user's agent list, under **Sponsored** in Start Session, and there is nothing to hire. They always run the creator's latest published version.
* **Unsponsored agents** show **Hire agent**. For an agent that places orders, that click is your acknowledgement that it will trade on the account you connect within the stated limits. The agent then appears in your agent list, pinned to the version you hired, and you start sessions with it the same way as any other agent.

A hired agent can only use the accounts you have whitelisted for agents, with the View or Trade permission you gave each one. It shares your normal weekly agent token budget. Nothing about hiring widens what agents may do on your account.

To remove it, open the listing or **My hired** and choose **Unhire**. You cannot unhire while it has tasks running. You can hire it again later.

Agents on the marketplace are built by other users and are not authored or endorsed by tread.fi.

### Updates and takedowns <a href="#user-content-updates-and-takedowns" id="user-content-updates-and-takedowns"></a>

For an agent you hired, you stay on the version you hired until you choose otherwise. When the author publishes a new version, **My hired** shows **Updates available** with an **Update to vN** button. If the new version can place larger orders than the one you hired, you have to tick an acknowledgement before updating. Updating never affects a task that is already running.

If the author takes the listing down, **My hired** shows **Taken down by its author**. Running tasks finish normally; you cannot start new ones. The same applies if tread.fi removes a listing.

### Promoting your own agent <a href="#user-content-promoting-your-own-agent" id="user-content-promoting-your-own-agent"></a>

Open **Manage Agents → Listing**, or press **Promote an agent** on the marketplace page. The tab shows how many free listing slots you have, and for each live listing its version, active hires, version history and performance. Below that, pick another agent to prepare its listing and preview its card. Earnings from sponsored listings appear under **Manage Agents → Agent Rewards**.

<img src="https://3498068627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzGueudbPNYpRWNpS3Ilo%2Fuploads%2FVoW6PTl12jqTX9FAi8gu%2FManage%20Agents%20%E2%86%92%20Listing?alt=media&amp;token=3e857743-57d6-4a4b-bc1e-27c67c188c61" alt="Manage Agents → Listing" height="565" width="802">

1. Claim a public profile first if you have not already. Your handle is shown as the author.
2. Choose one of your custom agents. Built-in tread.fi agents cannot be promoted.
3. Add up to 3 tags so people can find it. Name, description, category and whether it can place orders all come from the agent itself.
4. Press **Run AI review & promote to marketplace**. The review blocks only four things: prompt injection, overriding a hirer's limits, data exfiltration, and loading instructions from outside at runtime. If it passes, the listing is live immediately as v1.

You can have up to two live listings without a sponsor. Sponsored listings do not count toward that limit. Your own copy of the agent stays yours; the listing is a snapshot of it.

**Publish new version** re-runs the review on your changes and moves the listing to the next version. Hirers keep running the version they hired and are told an update is available.

**Take down** removes the listing from the marketplace and ends every hire. Hirers are notified. You keep your agent and can promote it again later, starting from v1.

### Sponsorship <a href="#user-content-sponsorship" id="user-content-sponsorship"></a>

Any TREAD holder with a sponsor slot can ask to sponsor a listing, and the creator accepts or declines under **Manage Agents → Sponsorships**. Once sponsored, the agent moves to the **Sponsored** section, becomes available to everyone without a hire, and 80% of the builder fees it generates are paid out in USDC, split equally between the creator and the sponsor. The stake, the request flow and payouts are covered on [TIP-3: Agent Sponsorship.](https://docs.tread.fi/tread-improvement-proposals/tip-3-agent-sponsorship.md)

<br>
