GET
Read an agent's model fees

Authorizations

Authorization
string
header
required

The authorization field takes the session bearer returned by sign-in, or an API key where the route allows keys. Paste the token itself into the authorization field.

Path Parameters

accountId
string
required
Minimum string length: 1
deploymentId
string
required
Required string length: 1 - 64

Response

Success

version
string
required
Allowed value: "agent-model-fees/v1"
deploymentId
string
required
Pattern: ^agt_[0-9a-f]{32}$
accruedFeeMicroUsd
string
required

Every model fee this agent accrued, in millionths of a USD: each metered model call's cost plus 20 percent, rounded up.

Pattern: ^(?:0|[1-9][0-9]*)$
unpaidFeeMicroUsd
string
required

The accrued fees not collected yet, in millionths of a USD.

Pattern: ^(?:0|[1-9][0-9]*)$
meteredCallCount
integer
required
Required range: x >= 0
lastAccruedAtEpochMs
integer | null
required
wallet
object
required

The agent's own wallet as the fee check sees it: no_wallet for an agent with no agent account, balance_unknown before its balance is read, or its known free collateral in millionths of a USD, negative while losing positions use more margin than it holds.

payable
boolean | null
required

Whether the wallet covers the unpaid fees; null when the wallet or its balance is unknown. An agent pauses with pauseReason fees_unpaid only when this is false.

pauseReason
enum<string> | null
required
Available options:
owner_request,
fees_unpaid,
null
priceMarkupBps
number
required
collection
string
required

Fees accrue and are checked against the wallet; none is collected yet.

Allowed value: "accrued_not_collected"