> ## Documentation Index
> Fetch the complete documentation index at: https://docs.defiorbit.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Credits

> How fixed and per-result credit costs are charged.

Only a 2xx response spends credits. Any other response is stored with `credits_charged` of 0.

Single-resource endpoints have a fixed cost per successful call. List, bundle, and batch endpoints multiply a unit cost by either `data.length` or `pagination.total`. [Pagination](/pagination) defines `limit`, `data.length`, and `total`.

Read the balance with [Get Remaining Credits](/api-reference/usage/credits). That call itself costs 1 credit, and the balances in the response are after that charge. Grants are manual grants plus the recurring-grant bucket. Purchased credits are everything else.

Usage drains one-off grants first, then recurring grants, then purchased credits. Leftover recurring-grant credits do not carry over: they expire at each monthly renewal and are replaced by that month's grant.

Query options such as `status=inactive` and `full=true` have their own unit price. That price replaces the default unit price. The endpoint page lists those rows.

## Page length and match count

`limit` is the page size: the maximum number of rows in `data`. `data.length` is how many rows this response contains. `pagination.total` is the match count for the whole request.

Uniswap V3, Aerodrome V3, and Orca list and batch calls charge `data.length` times the unit price.

Aave V3, Morpho, and Kamino list, bundle, and batch calls charge `pagination.total` times the unit price. Every page request pays that amount. For Aave V3 and Morpho the total counts wallet/chain results. For Kamino it counts obligations.

A successful call with `pagination.total` of 0 costs 0 credits.

A page after the last page still reports the original `pagination.total`, with an empty `data` array. Liquidity list and batch calls then cost 0 credits. Lending list, bundle, and batch calls still charge that total.

Events, snapshots, and usage logs use the per-call price in the table.

## Costs

| Endpoint | Unit credits | Billing unit |
| - | - | - |
| Uniswap V3, Aerodrome V3, Orca summary | 1 | Call |
| Uniswap V3, Aerodrome V3, Orca list (active) | 2 | `data.length` (positions) |
| Uniswap V3, Aerodrome V3, Orca list with `status=inactive` | 1 | `data.length` (positions) |
| Uniswap V3, Aerodrome V3, Orca list with `full=true` | 15 | `data.length` (positions) |
| Uniswap V3, Aerodrome V3, Orca position | 2 | Call |
| Uniswap V3, Aerodrome V3 events | 1 | Call |
| Uniswap V3, Aerodrome V3 daily snapshots | 2 | Call |
| Uniswap V3, Aerodrome V3 current snapshot | 5 | Call |
| Uniswap V3, Aerodrome V3 PnL | 8 (`status=inactive` is 4) | Call |
| Uniswap V3, Aerodrome V3 yield | 8 (`status=inactive` is 4) | Call |
| Uniswap V3, Aerodrome V3 full position | 15 (`status=inactive` is 7) | Call |
| Uniswap V3, Aerodrome V3, Orca batch | 12 | `data.length` (positions) |
| Aave V3 summary | 3 | Call |
| Aave V3 positions (no calculations) | 3 | `pagination.total` (wallet/chain results) |
| Aave V3 bundle | 15 | `pagination.total` (wallet/chain results) |
| Aave V3 batch | 12 | `pagination.total` (wallet/chain results) |
| Aave V3 events | 1 | Call |
| Aave V3 daily snapshots | 2 | Call |
| Aave V3 risk or yield | 8 | Call |
| Morpho summary | 1 | Call |
| Morpho positions (no calculations) | 3 | `pagination.total` (wallet/chain results) |
| Morpho bundle | 15 | `pagination.total` (wallet/chain results) |
| Morpho batch | 12 | `pagination.total` (wallet/chain results) |
| Morpho events | 1 | Call |
| Morpho daily snapshots | 2 | Call |
| Morpho risk or yield | 8 | Call |
| Kamino summary | 1 | Call |
| Kamino positions | 3 | `pagination.total` (obligations) |
| Kamino bundle | 15 | `pagination.total` (obligations) |
| Kamino batch | 12 | `pagination.total` (obligations) |
| Kamino events or daily snapshots | 1 | Call |
| Kamino risk or yield | 8 | Call |

\| Portfolio balance or assets | 30 | Call | | Usage credits or logs | 1 | Call |

## Examples

### One page of ten results

An active Uniswap V3 list whose matches all fit on the page:

| `limit` | `data.length` | `pagination.total` | Credits |
| - | - | - | - |
| 10 | 10 | 10 | 20 |

The charge is 10 × 2.

### Short last page

Page 3 of an active Uniswap V3 list:

| `limit` | `data.length` | `pagination.total` | Credits |
| - | - | - | - |
| 10 | 3 | 23 | 6 |

The charge is 3 × 2.

### No matches

An active Uniswap V3 list with nothing to return:

| `limit` | `data.length` | `pagination.total` | Credits |
| - | - | - | - |
| 10 | 0 | 0 | 0 |

### Several pages of a liquidity list

An inactive Uniswap V3 list (`status=inactive`, 1 credit per position on the page) with `pagination.total` 40 and `limit` 25. One response can hold at most 25 rows.

| Page | `data.length` | Credits |
| - | - | - |
| 1 | 25 | 25 |
| 2 | 15 | 15 |

The two requests together cost 40 credits.

### Batch of several wallets

A Uniswap V3 batch whose body contains 3 wallets. That route allows 20 wallets. The charge uses the positions on the page.

| `limit` | `data.length` | `pagination.total` | Credits |
| - | - | - | - |
| 10 | 5 | 5 | 60 |

The charge is 5 × 12.

### Lending charges the full match count

An Aave V3 bundle with `pagination.total` 40 and `limit` 10. Each request costs 40 × 15 credits.

| Page | `data.length` | Credits |
| - | - | - |
| 1 | 10 | 600 |
| 2 | 10 | 600 |
| 3 | 10 | 600 |
| 4 | 10 | 600 |

The four pages cost 2,400 credits.

Page 3 of an Aave V3 bundle with `pagination.total` 23 and `limit` 10 returns 3 rows and costs 345 credits (23 × 15).

An Aave V3 batch with `pagination.total` 4 costs 48 credits (4 × 12). Those 4 fit on the default page.

Page 2 of an Aave V3 bundle with `pagination.total` 10 and `limit` 10 has `data.length` 0 and costs 150 credits (10 × 15). Page 2 of an active Uniswap V3 list with that same `limit` and `pagination.total` costs 0 credits.

### Other calls

* Uniswap V3 summary (1 credit) plus a list of 3 active positions on one page (2 credits each) costs 7 credits.
* Portfolio balance and portfolio assets on the same wallet cost 60 credits (30 each).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.