account
Balance and pricing reads. Lets a caller pre-check spend before an operation that costs spArks.
Get the account's current spArks balance
Call this before create_timestamp if you want to pre-check that the account can afford the operation and explain a likely 402 in advance, rather than reacting to one after the fact. Combine with get_pricing to compare balance against cost.
Get the account's current spArks balance › Responses
OK
Get current spArks pricing and service costs
Public pricing reference. Does not require a user credential, only the channel Consumer-Token. Returns the current cost (in spArks) of a timestamp operation and the credits-to-USD exchange rate. Both timestamp_register (standard) and timestamp_register_agentic (MCP agent calls) are always returned, regardless of the caller's own auth, so this is a reliable pre-check either way. An agent will actually be charged timestamp_register_agentic automatically on create_timestamp, no separate parameter needed. This is a flat service rate for API/agent-originated calls, not a discount on spArks themselves. Use this to explain a 402 from create_timestamp in terms the human can act on (they separately purchase more spArks on web/mobile. This API has no purchase flow).
Get current spArks pricing and service costs › Responses
OK