Uploaded by Afrim A. Berke

helius API

advertisement
API Docs
Welcome
What is Helius?
The Ultimate Solana developer experience.
What is Helius?
Solana's scale presents challenges such as costly RPC nodes, unreliable data streaming, and
cryptic on-chain transactions. We solve these problems.
We founded Helius to help you build better, cheaper, and faster on Solana.
What Does Helius Offer?
RPCs
Geyser plugins
Enhanced APIs
Webhooks and websockets
1-click private and dedicated infrastructure
24/7 developer support
Solana RPCs
Helius RPCs are powered by the highest-end hardware, ensuring your app performs at its
best.
We provide Solana's most battle-tested RPCs, trusted by thousands of crypto's best
developers. We have global coverage with data centers across North America, Europe, and
Asia and 99.99% uptime SLAs.
We pride ourselves on having the best 24/7 developer support in crypto.
DAS API and Compression
With DAS API, you can access Solana's most complete, versatile, and performant NFT +
token API.
With compression, you have access to the most cost-efficient way of minting large numbers
of digital assets in crypto.
Enhanced Solana APIs
Making sense of Solana data is challenging, as it often appears as a series of long, obscure
byte data without context. This makes it difficult for you and your users to understand
what's happening.
The Enhanced Transactions APIs solve this by providing enriched, descriptive context.
Instead of opaque bytes, you see the details of on-chain transactions, such as whether they
are NFT listings, DEX swaps, DeFi loans, or DAO votes.
Webhooks and Websockets
Webhooks allow you to respond to on-chain events in real-time.
With built-in support for over 70 transaction types and low-latency event streaming, you
can automate your app's interactions with Solana without spending time on complex smart
contract parsers.
The best part? You can input up to 100 thousand addresses into a single webhook.
Pricing & Rate Limits
Flexible pricing for all your needs. Switch plans or cancel at anytime. Start in under 5
seconds.
Pricing Plans
We currently offer four self-serve subscription tiers as well as custom tailor-made plans for
your needs.
* See rate limit exceptions below.
Rate Limit Exceptions *
Photon Limits
Enterprise Plans
Ideal for teams at enterprise scale or with custom requirements. Create a custom plan with
volume pricing, custom rate limits, and custom dedicated infrastructure. Customize your
support level with support SLAs, uptime guarantees, usage alerts, and direct access to our
engineering team to optimize your infrastructure. Click here to contact our sales team.
Credits
Credits vary by usage:
RPC calls are 1 credit with two exceptions: getProgramAccounts and archival calls are
10 credits
Archival calls include the following: getTransaction, getBlock, getBlocks,
getInflationReward, getConfirmedBlock, getConfirmedBlocks,
getConfirmedTransaction, getConfirmedSignaturesForAddress2,
getConfirmedSignaturesForAddress, getSignaturesForAddress, getBlockTime
DAS calls are 10 credits
DAS calls include the following: getAsset, getAssetProof, getAssetsByOwner,
getAssetsByAuthority, getAssetsByCreator, getAssetsByGroup, searchAssets,
getSignaturesForAsset, getTokenAccounts, getNFTEditions
Photon calls are 10 credits
Photon getValidityProofs are 100 credits since they are computationally expensive
Webhook pushes are 1 credit
Priority Fee API calls are 1 credit
Enhanced Transactions API and Mint API calls are 100 credits
Overages apply if monthly credits are exceeded on paid plans, rates vary depending on the
plan (see below). Consider upgrading your plan if you are incurring overages. If you need
more than 500M credits (Professional Plan), contact us to chat about custom plans.
Payment Methods
Pay with a credit card or in crypto. We also offer automatic crypto payments! Check out our
quick demo video below (30 seconds).
Solana RPC Nodes
Helius RPCs Overview
Solana's most loved RPC nodes.
What is the Solana RPC API?
To interact with blockchain data, you must use an RPC node. Here is a brief explainer on
how RPCs on Solana work:
What makes Helius RPCs Different?
At Helius, we are Solana natives. We've been here since the beginning — and unlike other
providers, we exclusively specialize in Solana — focused on perfecting the Solana
experience.
We pride ourselves on having the most well-rounded RPC offering in the entire ecosystem.
We are in the top 1% in performance, the top 1% in pricing, and the most consistent uptime.
No surprises.
If you encounter any issues, we provide best-in-class 24/7 support to help unblock you and
keep you moving forward.
How to use Helius RPCs?
Generate an API key at dev.helius.xyz, and your RPC URLs will be created for you. We
provide controls to fine-tune your RPC access patterns (for example, only allow requests
from certain IPs or domains).
You can configure these in our dev portal.
RPC Node Locations
Helius provides services through a globally dispersed set of nodes, strategically positioned
in key locations: New York, Ashburn, Chicago, Vancouver, Los Angeles, Singapore, Tokyo,
Frankfurt, and the UK. Helius automatically directs user requests to the closest node,
guaranteeing the quickest and most efficient routing.
Dedicated Nodes
We also provide dedicated and private RPC nodes at best-in-class rates for serious power
users. These are necessary for the lowest possible latencies. Head to Helius' developer
portal to set up your dedicated node automatically!
Private Dedicated Nodes
Ideal for latency-sensitive use cases like trading, bots, sniping, and more or for teams that
want an isolated environment with predictable performance and billing. Get a single node in
a specific region to optimize server-to-server communication or setup a cluster of nodes
with distributed geographic coverage. Extend functionality with advanced Geyser plugins.
Demo
RPC Proxy — Protect Your Keys
How to stop your Helius API keys from leaking with 1 click.
A common problem when working with RPCs or APIs on the client side is your API keys
leaking. Malicious actors can run up your quota or rate limits if they get access to your keys.
Helius does provide access controls for this (for example, you can lockdown your endpoints
to only serve requests for certain IPs and Domains) — but using a proxy is the better
solution.
We've setup a simple open-source RPC proxy that you can deploy with 1-click to
Cloudflare, you can check it out below:
Priority Fee API
What Are Priority Fees on Solana?
Helius Priority Fee API
The getPriorityFeeEstimate is a new RPC method that provides fee recommendations
based on historical data. Most importantly, it considers both global and local fee markets.
For example, say you wanted to submit a swap on Jupiter. You could make the following
request:
And the API will provide you with a recommended fee:
The estimate is priced in micro-lamports per compute unit.
You can also provide a serialized transaction instead of manually specifying the accounts.
For example:
How it Works
The method uses a set of predefined priority levels (percentiles) to dictate the returned
estimate. Users can optionally specify to receive all the priority levels and adjust the
window with which these are calculated via lookbackSlots
Examples
Request all priority fee levels for Jup v6
Response
Request the high priority level for Jup v6
Response
Sending a transaction with the Priority Fee API
(Javascript)
This code snippet showcases how one can transfer SOL from one account to another. In this
code, the transaction is passed to the priority fee API which then determines the specified
priority fee from all the accounts involved in the transaction.
(Appendix) Calculating the Percentiles
To calculate the percentiles, we need to consider the global and local fee market over
transactions in the last N slots
For example,
where txn_fees are the txn_fees from the last 150 blocks, and account_fees(accounts) are
the fees for transactions containing these accounts from the last 150 blocks. Here, we are
considering the total set of fees seen for accounts and transactions as opposed to the
minimum.
Global Fee Market Estimate
The global fee market estimate is a percentile of priority fees paid for transactions in the
last N slots.
Local Fee Market Estimate
The local fee market is influenced by the number of people trying to obtain a lock on an
account. We can estimate this similarly to the global fee market but instead use the
percentile of fees paid for transactions involving a given account(s). If a user requests an
estimate for multiple accounts in the same transaction, we will take the max of the
percentiles across those accounts.
Priority Fee Estimate
The priority_fee_estimate will be the max of the global and local fee market estimates.
Extensions
This method could also be integrated into simulateTransaction and returned with the
response context. This way, developers using simulateTransaction can eliminate an
extra RPC call.
Loading...
Compression & DAS API
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
ZK Compression & Photon API
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Webhooks & Websockets
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Solana APIs
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Resources
Loading...
Loading...
Loading...
Loading...
Download