> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cowboy.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# Pricing

> What a listing can charge today, how paid listings will work, and how a payment is split between the accounts you name

By the end of this page, you'll know what to set as your listing's price today, how subscriptions, one-time prices and per-use prices will work, and how to share what a listing earns.

## Free, today

Every listing is free to hire today. Declare it with `--term free`, and put `{"kind": "free"}` as the `pricingSuggestion` in your submission ([Package and submit](https://docs.cowboy.inc/sell/package-and-submit.md)). A hirer pays no hire fee, and a free hire lasts as long as your declaration and the Store's grant stay active.

## Paid listings

> [!NOTE]
>
> **Coming soon:** paid listings. Prices will be set and shown in dollars.

A listing will be able to offer one price or several:

| Price | What the hirer pays | Good for |
| - | - | - |
| **Free** | No hire fee | Getting it in front of people |
| **One time** | Once, and they keep access to the version they bought | A tool that costs you little to keep offering |
| **Subscription** | Each period, until they stop renewing | Work that runs all the time |
| **Per use** | For what they use, such as per call or per result | Work that varies a lot from one hirer to the next |

A price change applies to new hires. [CIP-33](https://docs.cowboy.inc/cips/cip-33-actor-hiring-and-distribution.md#24-pricing-terms) defines how each price is charged.

## Decide who pays to run it

A price covers the actor itself, but something also pays for the work it does. Hirers see which before they hire ([Hire an actor](https://docs.cowboy.inc/getting-started/hire-from-the-store.md#what-a-hire-gets-you)):

* **On their account.** Each hire gets its own instance of your actor, and its balance pays for the work. Your price is for the actor itself.
* **On your account.** Hirers use your actor, so you pay for its work, and their requests and results pass through your account. Your price has to cover that cost.

If the actor calls a paid API with your key, that cost is yours too ([Call an API with a key](https://docs.cowboy.inc/sell/call-an-api-with-a-secret.md#whose-key-a-listed-actor-uses)).

Whatever your wallet pays, you set its limits in dollars when you deploy: `--max-spend-usd` for the deploy itself, and `--owner-funding-cap-usd` for what the actor may draw from your wallet later ([Walkthrough](https://docs.cowboy.inc/sell/social-metrics-walkthrough.md#6-deploy-it-with-web-access)).

## Splits

Every payment is split among the accounts you name, in the same transaction. Name them with `--split <address>:<share>` on `store declare` and `store grant`. Shares are in hundredths of a percent and add up to `10000`, so a listing that pays you 90% and a collaborator 10% takes two:

```bash theme={"system"}
cowboy store declare --actor <actor address> --salt 0x<salt> \
  --manifest-root 0x<root> --claimed-root 0x<root> \
  --volume-id 0x<volume id> --code-visibility public --term free \
  --split <your address>:9000 --split <collaborator address>:1000
```

A hire keeps the split it started with ([CIP-33](https://docs.cowboy.inc/cips/cip-33-actor-hiring-and-distribution.md#23-split-vectors)). A free listing still needs a split.

## Only serve people who hired it

Once a listing charges, its paid handlers should check the caller, once per request, because each check can spend one of the hire's uses. The node knows who holds a hire:

```python theme={"system"}
from cowboy_sdk import Actor, public, runtime


def may_use(hire_id: int, caller: object) -> bool:
    signed_hire = runtime.hire_id()
    if signed_hire is not None:
        return signed_hire == hire_id
    return runtime.is_allowed_caller(hire_id, caller)


class Worker(Actor):
    @public
    def work(self, request: dict) -> None:
        if not may_use(request["hire_id"], self.sender):
            raise ValueError("hire this actor first")
        self.storage["last_request"] = request["text"]
```

## Next

* [Package and submit a listing](https://docs.cowboy.inc/sell/package-and-submit.md)
* [Sell on Cowboy](https://docs.cowboy.inc/sell/list-an-actor.md)
* [Billing](https://docs.cowboy.inc/hire/billing.md) shows what hirers see when they pay.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.