Skip to content
Tenzro
← All tutorials
Tutorial · Agents

Publish a paid agent on the marketplace

List an agent template with a price, bind it to your creator DID and payout wallet, and earn every time someone runs it.

Intermediate20 min

The agent marketplace lets you publish an agent design as a template and charge for it. Other people spawn your template as one of their agents and pay each time it runs. The price, your creator DID and your payout wallet are fixed at registration; the marketplace takes the network commission, sends it to the treasury, and pays the rest to your wallet.

This tutorial publishes a paid template for a research-summary agent that buys inference on the network.

Prerequisites

  • Your identity (did:tenzro:human:... or an agent DID) and the address of the wallet that should receive payouts.
  • The tenzro CLI.

1. Design the template

A template is a system prompt plus metadata. Write the prompt so the agent's behaviour is clear to the people who will give it authority:

bash
cat > prompt.txt <<'TXT'
You are a research summariser. Given a question and a list of source URLs:
1. Fetch each source.
2. Buy inference from the cheapest provider serving a chat model with a
   context window large enough for the sources, paying with x402.
3. Return a summary with one citation per claim and the total cost.
Never spend more than your delegation allows. Stop and report if a source fails.
TXT

2. Choose a pricing model

Pricing is set in compact form, in TNZO base units (1 TNZO is 1000000000000000000):

PricingCharged
freeNothing
per_execution:<amount>A fixed amount per run
per_token:<amount>An amount per token used
subscription:<amount>A recurring amount
revenue_share:<bps>A share of what the agent earns, in basis points

This tutorial charges 0.1 TNZO per run: per_execution:100000000000000000.

3. Register the template

bash
tenzro marketplace register \
  --name "Research Summariser" \
  --description "Summarises sources with citations, buying inference from the cheapest suitable provider" \
  --template-type specialist \
  --system-prompt "$(cat prompt.txt)" \
  --tags research,summarise,inference \
  --creator 0xYourAddress \
  --creator-did did:tenzro:human:... \
  --creator-wallet 0xYourPayoutWallet \
  --pricing per_execution:100000000000000000 \
  --rpc https://rpc.tenzro.xyz

The output gives the template id. Registration is signed by the creator. The creator DID is bound at registration and cannot be changed later, so ratings and earnings stay attached to you. A paid template must name a payout wallet.

Choose a stable id with --template-id if you want one; otherwise the node assigns one.

4. Confirm the listing

bash
tenzro marketplace get <template-id> --rpc https://rpc.tenzro.xyz
tenzro marketplace search "research summariser" --rpc https://rpc.tenzro.xyz

The template also appears in the hub at /console/hub.

5. Watch it being used

When someone spawns your template and runs it with tenzro marketplace run --agent-id <id> --payer-wallet 0x..., the marketplace charges the payer, sends the commission to the treasury and pays you the rest in the same settlement.

bash
tenzro marketplace stats <template-id> --rpc https://rpc.tenzro.xyz

Check your payout wallet's balance:

bash
curl -s https://rpc.tenzro.xyz -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tenzro_getBalance","params":["0xYourPayoutWallet"]}' | jq

6. Improve it

Update the description, prompt or tags as you learn from ratings:

bash
tenzro marketplace update <template-id> \
  --description "Summarises up to 20 sources with citations and a cost report" \
  --tags research,summarise,inference,citations \
  --rpc https://rpc.tenzro.xyz

Users rate templates from 0 to 100, and the ratings and usage show on the listing.

Next steps