Concepts

Pocket has a small vocabulary. Learn these seven and nothing else in the docs needs explaining.

Agent

A thing that spends. Usually a coding agent you already run, connected to Pocket so it can pay for what it needs.

Each agent has its own wallet, its own budget, and its own rules. Two agents in the same organization cannot touch each other's money.

Wallet

Where an agent's money sits. Created automatically when you create the agent.

You never handle a private key, and neither does your agent. Signing happens elsewhere, only when Pocket says a purchase is allowed.

Budget

How much an agent may spend, and how often.

There are two kinds. The daily budget is standing, and resets each midnight. A task budget is a smaller amount ring-fenced for one job, and it sits alongside the daily one rather than replacing it.

A purchase has to fit both.

Policy

The rules about what an agent may buy, as opposed to how much.

Which sellers it may pay, which kinds of spend are allowed, the most any single purchase may cost, and the amount above which you want to approve it yourself.

Payment

One attempt to buy something. Note the word attempt: a refused purchase is a payment too, and it is kept.

Each one ends in one of these states:

Seller

Whoever your agent is buying from. A weather API, a market data feed, another agent.

Pocket is not a marketplace. Any seller that prices itself in the open x402 standard can take your agent's money, whether we have heard of them or not. See buying with x402.

Audit trail

The record of everything that happened: every purchase, every refusal, every change you made to a limit.

It is written at the moment each thing happens and is never edited afterwards. See the audit trail.

How they fit together