# Credit costs

What each Wallet Master REST API call costs in credits, how the 1000M monthly quota resets, and how to check your balance before you spend it.

Every API call is paid in credits from a monthly quota that comes with the Wallet Database \+ API plan\. This page is the price list for the REST endpoints; the Bot API endpoints have [their own](/bot-api-credit-costs)\.

## Your monthly quota

- **1,000,000,000 credits \(1000M\) every 30 days\.** The balance resets to the full amount automatically; unused credits do not roll over\.
- One balance for both API families\. A Bot API call and a REST call draw from the same pool\.
- Check it any time with `GET /credits`, which costs nothing and returns your remaining balance as a number in a string\.

## Price per endpoint

| Endpoint | Cost |
| --- | --- |
| `POST /wallet_database` | 100 credits per matching address, whatever the limit\. A query that matches nothing costs a flat 100 |
| `GET /wallet_database/columns` | Free |
| `POST /token_creators` | 100 credits per address returned |
| `GET /token_creators/{address}` | 100 credits per request |
| `GET /wallets/{address}/activity` | 1 credit per request, a page of up to 100 swaps |
| `GET /credits` | Free |

## What common calls cost

| Call | Credits |
| --- | --- |
| A Wallet Database query matching 1,000 wallets | 100,000 |
| A Wallet Database query matching 100,000 wallets | 10,000,000 |
| One page of 50 creators | 5,000 |
| One creator's full record | 100 |
| A wallet with 2,000 swaps, read in full \(20 pages\) | 20 |

The monthly quota is ten thousand queries that match 1,000 wallets each, or a hundred that match 100,000\. The bill follows the match count, not the `limit`: a tight query is a cheap query, and a loose one costs the same whether you ask for 10 addresses or all of them\.

> [!TIP]
> Cache what does not change\. Wallet metrics are recomputed hourly, so the same query returns the same wallets for up to an hour; there is no reason to run it every minute\.

> [!NOTE]
> The API is for personal use\. If you want to power a product or a service of your own with Wallet Master data, ask in the Discord server about a custom plan\.