Skip to main content
The following functionality exists for wallets reconstituted server-side. More on Privy architecture here
Your app can query the total Privy gas credits charged across a set of wallets over a given time range using the GET /v1/apps/gas_spend endpoint. This is useful for tracking gas credit consumption per wallet, reconciling costs, and building internal usage dashboards.

​
Request

Send a GET request to https://api.privy.io/v1/apps/gas_spend with the following query parameters:
​
wallet_ids
string[]
required
Array of wallet IDs to query. Must contain between 1 and 100 IDs.
​
start_timestamp
number
required
Start of the time range in milliseconds (inclusive).
​
end_timestamp
number
required
End of the time range in milliseconds (exclusive). The range between start_timestamp and end_timestamp must not exceed 30 days.

​
Response

​
value
string
Total Privy gas credits charged in USD, as a decimal string (e.g. "12.345678").
​
currency
string
The currency of the value. Always "usd".

​
Example

curl --request GET \
  --url 'https://api.privy.io/v1/apps/gas_spend?wallet_ids=wallet-1&wallet_ids=wallet-2&start_timestamp=1712188800000&end_timestamp=1713398400000' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'privy-app-id: <privy-app-id>'
Response
{
  "value": "12.345678",
  "currency": "usd"
}

​
Errors

StatusDescription
400Missing or invalid query parameters, or the date range exceeds 30 days
401Missing or invalid app secret
404One or more wallet IDs do not belong to the app