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

# Compute Unit Pricing

> Understanding compute unit based billing for API usage

## Overview

Yield.xyz uses a **compute unit (CU) model** for usage-based billing. Compute units measure the resources consumed by API requests, with different endpoints having different CU costs based on complexity.

<Info>
  **Free data access** is provided for positions originated through Yield.xyz. CU billing applies to historic data and positions not originated through the platform.
</Info>

***

## CU Allotments by Plan

| Plan           | CU Allotment       |
| -------------- | ------------------ |
| **Standard**   | 1,500,000 CU/month |
| **Pro**        | 5,000,000 CU/month |
| **Enterprise** | Custom             |

<Card title="Get CU Pricing" icon="envelope" href="mailto:hello@yield.xyz">
  Contact us for compute unit pricing details
</Card>

***

## Endpoint CU Costs

<Tabs>
  <Tab title="Discovery & Yields">
    | Endpoint                       | Method | CU Cost |
    | ------------------------------ | ------ | ------- |
    | `/yields`                      | GET    | 1       |
    | `/yields/{yieldId}`            | GET    | 1       |
    | `/yields/{yieldId}/validators` | GET    | 1       |
  </Tab>

  <Tab title="Positions & Balances">
    | Endpoint           | Method | Base CU | Variable CU    |
    | ------------------ | ------ | ------- | -------------- |
    | `/yields/balances` | POST   | 1       | +0.2 per yield |
  </Tab>

  <Tab title="Actions & Transactions">
    | Endpoint                                    | Method | CU Cost |
    | ------------------------------------------- | ------ | ------- |
    | `/actions/{type}`                           | POST   | 2       |
    | `/actions`                                  | GET    | 1       |
    | `/actions/{actionId}`                       | GET    | 1       |
    | `/transactions/{transactionId}/submit-hash` | PUT    | 1       |
    | `/transactions/{transactionId}/submit`      | POST   | 1       |
    | `/transactions/{transactionId}`             | GET    | 1       |
  </Tab>
</Tabs>

***

## Example CU Usage

<AccordionGroup>
  <Accordion title="Passive user (views positions once/month)">
    | Endpoint         | Requests | CU per Request | Total CU       |
    | ---------------- | -------- | -------------- | -------------- |
    | getOpportunities | 1        | 1              | 1              |
    | getBalances      | 1        | 1              | 1              |
    | createAction     | 1        | 2              | 2              |
    | **Total**        |          |                | **4 CU/month** |
  </Accordion>

  <Accordion title="Active user (multiple actions/month)">
    | Endpoint              | Requests | CU per Request | Total CU          |
    | --------------------- | -------- | -------------- | ----------------- |
    | getOpportunities      | 3        | 1              | 3                 |
    | getBalances           | 3        | 1              | 3                 |
    | createAction          | 3        | 2              | 6                 |
    | getActions            | 1        | 1              | 1                 |
    | getActionById         | 1        | 1              | 1                 |
    | submitTransactionHash | 1        | 1              | 1                 |
    | submitTransaction     | 1        | 1              | 1                 |
    | getTransaction        | 1        | 1              | 1                 |
    | **Total**             |          |                | **\~17 CU/month** |
  </Accordion>

  <Accordion title="Super active user (frequent transactions)">
    | Endpoint              | Requests | CU per Request | Total CU          |
    | --------------------- | -------- | -------------- | ----------------- |
    | getOpportunities      | 9        | 1              | 9                 |
    | getBalances           | 9        | 1              | 9                 |
    | createAction          | 9        | 2              | 18                |
    | getActions            | 3        | 1              | 3                 |
    | getActionById         | 3        | 1              | 3                 |
    | submitTransactionHash | 3        | 1              | 3                 |
    | submitTransaction     | 3        | 1              | 3                 |
    | getTransaction        | 3        | 1              | 3                 |
    | **Total**             |          |                | **\~51 CU/month** |
  </Accordion>
</AccordionGroup>

***

## Scaling Example

For 1 million monthly active users (MAU):

| User Type    | % of Users | Users         | CU per User | Total CU      |
| ------------ | ---------- | ------------- | ----------- | ------------- |
| Passive      | 97.75%     | 977,500       | 4           | 3,910,000     |
| Active       | 1.79%      | 17,900        | 17          | 304,300       |
| Super Active | 0.46%      | 4,600         | 51          | 234,600       |
| **Total**    |            | **1,000,000** |             | **\~4.4M CU** |

<Tip>
  Contact us for a custom quote based on your expected usage patterns and MAU.
</Tip>

***

## Free vs Paid Data Access

<Tabs>
  <Tab title="Free (originated via Yield.xyz)">
    Baseline data is **free** when positions are originated through Yield.xyz:

    * Current TVL
    * Current rewards
    * Yield metadata
    * Position balances for Yield.xyz-originated positions

    This applies to clients whose users enter yield-bearing positions through the Yield.xyz platform.
  </Tab>

  <Tab title="Paid (premium data)">
    CU-based billing applies to:

    * Historic data and yield windows
    * Positions not originated through Yield.xyz
    * Analytics and cohort metrics
    * Custom data endpoints

    Charges are based on compute units as detailed above.
  </Tab>
</Tabs>

***

## Upgrade Your Plan

<CardGroup cols={2}>
  <Card title="Upgrade to Pro" icon="arrow-up" href="mailto:hello@yield.xyz">
    5,000,000 CU/month for high-volume apps
  </Card>

  <Card title="Enterprise Inquiry" icon="building" href="mailto:hello@yield.xyz">
    Custom CU allotments and enterprise contracts
  </Card>
</CardGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Plans & Pricing" icon="layer-group" href="/documentation/plans-limits/plans-tiers">
    Compare all plan features
  </Card>

  <Card title="Rate Limits" icon="gauge" href="/documentation/plans-limits/rate-limits">
    API rate limit details
  </Card>
</CardGroup>