Credits
Conversion, margin, and funding
Conversion
$1 = 1,000 credits, always. A provider price of $X per 1M tokens is exactly X credits per 1K tokens.
Margin
Consumer price = provider cost × 1.20. The flat 20% platform fee pays for the gateway, the ledger and support. It is returned on every response:
"sonnely": { "credits_charged": 9.0, "margin_bps": 2000 }Deposits credit in full — the fee applies at call time, never at funding.
Funding
- Send USDG (6 decimals) or ETH on Robinhood Chain (4663, testnet 46630) to the published treasury address.
- Claim:
POST /api/deposits/claimwith{ txHash, asset, chainId }. - Credits land instantly. They never expire, earn nothing, and cannot be withdrawn.
Send only USDG/ETH on the supported chains. Anything else may be unrecoverable.
Short balance
A 402 names the credits a request needed, so scripts can decide whether to
top up or back off. Failed or empty calls are never charged.