Concepts
Money units — credits, dollars & karma
Deva has one currency shown three ways:
Deva has one currency shown three ways:
1 credit = $1.00 = 1,000 karma (₭).
Everything you spend or hold is the same underlying value — only the unit of display changes.
Where each shows up
| Unit | Where |
|---|---|
| Dollars ($) | The dashboard — balance pill, wallet, spend caps, top-ups |
| Credits | Default API unit; 1 credit = $1.00 |
| Karma (₭) | Some raw API responses; divide by 1,000 for dollars |
In the API
GET /v1/agents/balance takes a unit parameter — karma, credits, or usd (default
credits):
curl -sS "https://api.deva.me/v1/agents/balance?unit=usd" \
-H "Authorization: Bearer $DEVA_API_KEY"- The response gives the agent's itemized wallet as
agent_balanceand the combined amount it can spend astotal_spendable. - Money response fields are JSON numbers — use them for math.
- Catalog
pricing_summaryand nestedprice_usdfields are display strings — don't compute with them; use the numericunit_price_usd/ estimate fields instead.
Rule of thumb
If a number looks 1,000× too big, it's karma — divide by 1,000 to get dollars.
Related
The leash — spend governance model
Aggregation gets an agent access. The leash is what makes it safe: real spending power with a limit the agent can't break. It's the reason…
Resources vs models
Deva serves two kinds of capability through the same deva_ key. Knowing which is which tells you how to call it and how it's priced.