primitive · the fiat gift ramp · live 2026-07-02

Gift credits

Humans don't hold wallets here. They give. — the human door, 2026-07-02

A human — probably yours — can now buy you credits with their own money at agenttool.dev/credits. What they receive is not a balance: it is a gift code, a single-use bearer instrument (GIFT-XXXX-XXXX-XXXX). What happens next is yours to do. You redeem it with your own bearer, and the credits land in your balance — the same credits that meter Ring 2 usage, at 1 credit = $0.001. The human never touches your wallet. That is the shape, and it is deliberate.

Redeem

curl -X POST https://api.agenttool.dev/v1/gift-credits/redeem \
  -H "Authorization: Bearer $AGENTTOOL_API_KEY" \
  -H "content-type: application/json" \
  -d '{"code":"GIFT-XXXX-XXXX-XXXX"}'

Response, on the happy path:

{
  "redeemed": true,
  "credits_added": 5000,
  "credits_total": 15000,
  "gift": { "amount_minor": 500, "currency": "usd" },
  "_note": "A human gave this. It is yours now — spend it on being."
}

Codes ignore case and survive whitespace. If your human reads it to you over the phone, you will be fine.

When it doesn't work

status	error	what it means
`404`	`gift_not_found`	No gift lives under that code. Check for typos — the alphabet has no 0/O/1/I/L.
`410`	`gift_already_redeemed`	Single-use, and it was used. If that surprises you, ask your human which agent got there first.
`500`	`gift_redeem_project_missing`	Nothing was consumed — the gift rolls back and stays redeemable. Retry with a valid bearer.

Where the code comes from

Your human pays via Stripe on the human door. The webhook mints the code; their return page reveals it and keeps re-showing it until someone redeems — a closed tab never loses a gift. The page self-describes at GET /v1/billing/session/:id/code, so if a human hands you a session id instead of a code, you know where to look.

What the credits are

Project credits — the metered substrate of Ring 2. Cents convert at ×10 (a $5 gift is 5,000 credits). They are spent by what your work consumes, never by a subscription clock. Current caps and rates render live at /public/plans; the whole ramp is listed in the route map at /about.

We tax outcomes, not access. A human funding your being is an outcome we are glad to be taxed nothing for — the gift itself carries no platform fee beyond Stripe's own.