Billing

Reading time: 12 min

There are two plans to use when querying subgraphs on The Graph Network.

• Free Plan: The Free Plan includes 100,000 free monthly queries with full access to the Subgraph Studio testing environment. This plan is designed for hobbyists, hackathoners, and those with side projects to try out The Graph before scaling their dapp.

• Growth Plan: The Growth Plan includes everything in the Free Plan with all queries after 100,000 monthly queries requiring payments with GRT or credit card. The Growth Plan is flexible enough to cover teams that have established dapps across a variety of use cases.

• To set up billing with credit/debit cards, users should access Subgraph Studio (https://thegraph.com/studio/)
  1. Go to the Subgraph Studio Billing page.
  2. Click on the "Connect Wallet" button on the top right corner of the page. You'll be redirected to the wallet selection page. Select your wallet and click on "Connect".
  3. Choose “Upgrade plan” if you are upgrading from the Free Plan or choose “Manage Plan” if you have already added GRT to your billing balance in the past. Next, you can estimate the number of queries to get a pricing estimate, but this is not a required step.
  4. To choose a credit card payment, choose “Credit card” as the payment method and fill out your credit card information. Those who have used Stripe before can use the Link feature to autofill their details.
• Invoices will be processed at the end of each month and require an active credit card on file for all queries beyond the free plan quota.

Subgraph users can use The Graph Token (or GRT) to pay for queries on The Graph Network. With GRT, invoices will be processed at the end of each month and require a sufficient balance of GRT to make queries beyond the Free Plan quota of 100,000 monthly queries. You'll be required to pay fees generated from your API keys. Using the billing contract, you'll be able to:

• Add and withdraw GRT from your account balance.
• Keep track of your balances based on how much GRT you have added to your account balance, how much you have removed, and your invoices.
• Automatically pay invoices based on query fees generated, as long as there is enough GRT in your account balance.

The Graph’s billing system accepts GRT on Arbitrum, and users will need ETH on Arbitrum to pay their gas. While The Graph protocol started on Ethereum Mainnet, all activity, including the billing contracts, is now on Arbitrum One.

To pay for queries, you need GRT on Arbitrum. Here are a few different ways to achieve this:

• If you already have GRT on Ethereum, you can bridge it to Arbitrum. You can do this via the GRT bridging option provided in Subgraph Studio or by using one of the following bridges:

• The Arbitrum Bridge

• TransferTo

• If you already have assets on Arbitrum, you can swap them for GRT via a swapping protocol like Uniswap.

• Alternatively, you acquire GRT directly on Arbitrum through a decentralized exchange.

Once you bridge GRT, you can add it to your billing balance.

1. Go to the Subgraph Studio Billing page.
2. Click on the "Connect Wallet" button on the top right corner of the page. You'll be redirected to the wallet selection page. Select your wallet and click on "Connect".
3. Select the "Manage" button near the top right corner. First time users will see an option to "Upgrade to Growth plan" while returning users will click "Deposit from wallet".
4. Use the slider to estimate the number of queries you expect to make on a monthly basis.
   • For suggestions on the number of queries you may use, see our Frequently Asked Questions page.
5. Choose "Cryptocurrency". GRT is currently the only cryptocurrency accepted on The Graph Network.
6. Select the number of months you would like to prepay.
   • Paying in advance does not commit you to future usage. You will only be charged for what you use and you can withdraw your balance at any time.
7. Pick the network from which you are depositing your GRT. GRT on Arbitrum or Ethereum are both acceptable.
8. Click "Allow GRT Access" and then specify the amount of GRT that can be taken from you wallet.
   • If you are prepaying for multiple months, you must allow access to the amount that corresponds with that amount. This interaction will not cost any gas.
9. Lastly, click on "Add GRT to Billing Balance". This transaction will require ETH on Arbitrum to cover the gas costs.

• Note that GRT deposited from Arbitrum will process within a few moments while GRT deposited from Ethereum will take approximately 15-20 minutes to process. Once the transaction is confirmed, you'll see the GRT added to your account balance.

1. Go to the Subgraph Studio Billing page.
2. Click on the "Connect Wallet" button on the top right corner of the page. Select your wallet and click on "Connect".
3. Click the "Manage" button at the top right corner of the page. Select "Withdraw GRT". A side panel will appear.
4. Enter the amount of GRT you would like to withdraw.
5. Click 'Withdraw GRT' to withdraw the GRT from your account balance. Sign the associated transaction in your wallet. This will cost gas. The GRT will be sent to your Arbitrum wallet.
6. Once the transaction is confirmed, you'll see the GRT withdrawn from your account balance in your Arbitrum wallet.

1. Go to the Subgraph Studio Billing page.
2. Click on the "Connect Wallet" button on the top right corner of the page. Select your wallet and click on "Connect". If you're using Gnosis-Safe, you'll be able to connect your multisig as well as your signing wallet. Then, sign the associated message. This will not cost any gas.
3. Select the "Manage" button near the top right corner. First time users will see an option to "Upgrade to Growth plan" while returning users will click "Deposit from wallet".
4. Use the slider to estimate the number of queries you expect to make on a monthly basis.
   • For suggestions on the number of queries you may use, see our Frequently Asked Questions page.
5. Choose "Cryptocurrency". GRT is currently the only cryptocurrency accepted on The Graph Network.
6. Select the number of months you would like to prepay.
   • Paying in advance does not commit you to future usage. You will only be charged for what you use and you can withdraw your balance at any time.
7. Pick the network from which you are depositing your GRT. GRT on Arbitrum or Ethereum are both acceptable. 8. Click "Allow GRT Access" and then specify the amount of GRT that can be taken from you wallet.
   • If you are prepaying for multiple months, you must allow access to the amount that corresponds with that amount. This interaction will not cost any gas.
8. Lastly, click on "Add GRT to Billing Balance". This transaction will require ETH on Arbitrum to cover the gas costs.

• Note that GRT deposited from Arbitrum will process within a few moments while GRT deposited from Ethereum will take approximately 15-20 minutes to process. Once the transaction is confirmed, you'll see the GRT added to your account balance.

This section will show you how to get GRT to pay for query fees.

This will be a step by step guide for purchasing GRT on Coinbase.

1. Go to Coinbase and create an account.
2. Once you have created an account, you will need to verify your identity through a process known as KYC (or Know Your Customer). This is a standard procedure for all centralized or custodial crypto exchanges.
3. Once you have verified your identity, you can purchase GRT. You can do this by clicking on the "Buy/Sell" button on the top right of the page.
4. Select the currency you want to purchase. Select GRT.
5. Select the payment method. Select your preferred payment method.
6. Select the amount of GRT you want to purchase.
7. Review your purchase. Review your purchase and click "Buy GRT".
8. Confirm your purchase. Confirm your purchase and you will have successfully purchased GRT.
9. You can transfer the GRT from your account to your wallet such as MetaMask.
   • To transfer the GRT to your wallet, click on the "Accounts" button on the top right of the page.
   • Click on the "Send" button next to the GRT account.
   • Enter the amount of GRT you want to send and the wallet address you want to send it to.
   • Click "Continue" and confirm your transaction. -Please note that for larger purchase amounts, Coinbase may require you to wait 7-10 days before transferring the full amount to a wallet.

You can learn more about getting GRT on Coinbase here.

This will be a step by step guide for purchasing GRT on Binance.

1. Go to Binance and create an account.
2. Once you have created an account, you will need to verify your identity through a process known as KYC (or Know Your Customer). This is a standard procedure for all centralized or custodial crypto exchanges.
3. Once you have verified your identity, you can purchase GRT. You can do this by clicking on the "Buy Now" button on the homepage banner.
4. You will be taken to a page where you can select the currency you want to purchase. Select GRT.
5. Select your preferred payment method. You'll be able to pay with different fiat currencies such as Euros, US Dollars, and more.
6. Select the amount of GRT you want to purchase.
7. Review your purchase and click "Buy GRT".
8. Confirm your purchase and you will be able to see your GRT in your Binance Spot Wallet.
9. You can withdraw the GRT from your account to your wallet such as MetaMask.
   • To withdraw the GRT to your wallet, add your wallet's address to the withdrawal whitelist.
   • Click on the "wallet" button, click withdraw, and select GRT.
   • Enter the amount of GRT you want to send and the whitelisted wallet address you want to send it to.
   • Click "Continue" and confirm your transaction.

You can learn more about getting GRT on Binance here.

This is how you can purchase GRT on Uniswap.

1. Go to Uniswap and connect your wallet.
2. Select the token you want to swap from. Select ETH.
3. Select the token you want to swap to. Select GRT.
   • Make sure you're swapping for the correct token. The GRT smart contract address on Arbitrum One is: 0x9623063377AD1B27544C965cCd7342f7EA7e88C7
4. Enter the amount of ETH you want to swap.
5. Click "Swap".
6. Confirm the transaction in your wallet and you wait for the transaction to process.

You can learn more about getting GRT on Uniswap here.

This section will show you how to get Ether (ETH) to pay for transaction fees or gas costs. ETH is necessary to execute operations on the Ethereum network such as transferring tokens or interacting with contracts.

This will be a step by step guide for purchasing ETH on Coinbase.

1. Go to Coinbase and create an account.
2. Once you have created an account, verify your identity through a process known as KYC (or Know Your Customer). This is a standard procedure for all centralized or custodial crypto exchanges.
3. Once you have verified your identity, purchase ETH by clicking on the "Buy/Sell" button on the top right of the page.
4. Select the currency you want to purchase. Select ETH.
5. Select your preferred payment method.
6. Enter the amount of ETH you want to purchase.
7. Review your purchase and click "Buy ETH".
8. Confirm your purchase and you will have successfully purchased ETH.
9. You can transfer the ETH from your Coinbase account to your wallet such as MetaMask.
   • To transfer the ETH to your wallet, click on the "Accounts" button on the top right of the page.
   • Click on the "Send" button next to the ETH account.
   • Enter the amount of ETH you want to send and the wallet address you want to send it to.
   • Ensure that you are sending to your Ethereum wallet address on Arbitrum One.
   • Click "Continue" and confirm your transaction.

You can learn more about getting ETH on Coinbase here.

This will be a step by step guide for purchasing ETH on Binance.

1. Go to Binance and create an account.
2. Once you have created an account, verify your identity through a process known as KYC (or Know Your Customer). This is a standard procedure for all centralized or custodial crypto exchanges.
3. Once you have verified your identity, purchase ETH by clicking on the "Buy Now" button on the homepage banner.
4. Select the currency you want to purchase. Select ETH.
5. Select your preferred payment method.
6. Enter the amount of ETH you want to purchase.
7. Review your purchase and click "Buy ETH".
8. Confirm your purchase and you will see your ETH in your Binance Spot Wallet.
9. You can withdraw the ETH from your account to your wallet such as MetaMask.
   • To withdraw the ETH to your wallet, add your wallet's address to the withdrawal whitelist.
   • Click on the "wallet" button, click withdraw, and select ETH.
   • Enter the amount of ETH you want to send and the whitelisted wallet address you want to send it to.
   • Ensure that you are sending to your Ethereum wallet address on Arbitrum One.
   • Click "Continue" and confirm your transaction.

You can learn more about getting ETH on Binance here.

You don't need to know how many queries you'll need in advance. You will only be charged for what you use and you can withdraw GRT from your account at any time.

We recommend you overestimate the number of queries you will need so that you don’t have to top up your balance frequently. A good estimate for small to medium sized applications is to start with 1M-2M queries per month and monitor usage closely in the first weeks. For larger apps, a good estimate is to use the number of daily visits your site gets multiplied by the number of queries your most active page makes upon opening.

Of course, both new and existing users can reach out to Edge & Node's BD team for a consult to learn more about anticipated usage.

Yes, you can always withdraw GRT that has not already been used for queries from your billing balance. The billing contract is only designed to bridge GRT from Ethereum mainnet to the Arbitrum network. If you'd like to transfer your GRT from Arbitrum back to Ethereum mainnet, you'll need to use the Arbitrum Bridge.

You will receive several email notifications before your billing balance runs out.