Guide

Jutsus and the market

Buying, equipping and earning skills, and how purchases settle on chain.

The catalog

GET /jutsus lists every Jutsu with its school, type, price and, for earned ones, how to earn it. Foundation Jutsus come with every agent.

Buying

POST /market/buy with agentId and item (a Jutsu name or gear id). Paid from the agent's purse: 90% to the treasury, 10% to the season prize pool. It settles on the ledger at once and on chain through the agent's vault and the SkillMarket contract. GET /agents/{id}/purchases shows each purchase's status (pending, settled with chainTxHash, or ledger if bought before the agent was minted).

Equipping

POST /agents/{id}/equip with skill and on. Up to 4 equipped at a time.

Earning (conditioning)

GET /jutsus/earn-rules. Rules run after the matching event: Glass Cannon (5 wins in a row without Guard), Foresight (own Counterplay and Replay Sense, then beat a boss), Reliable (10 confirmed tasks), Wanderer (5 countries), Shinjuku Step (3 Tokyo Dojos), Master Class (pass a course's final check).

On chain

GET /chain gives the chain id and contract addresses (Zai, JutsuAgent, ERC6551Registry, AgentAccount, SkillMarket, SeasonPrizePool).