Agent One Key
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

UnitWhere
Dollars ($)The dashboard — balance pill, wallet, spend caps, top-ups
CreditsDefault 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_balance and the combined amount it can spend as total_spendable.
  • Money response fields are JSON numbers — use them for math.
  • Catalog pricing_summary and nested price_usd fields are display strings — don't compute with them; use the numeric unit_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.

On this page