Heliad docs ยท v3
Heliad documentation
Heliad runs a fork of Helius's open-source priority fee estimator on an open Solana endpoint. This page covers the fork, the API, the fee report and the token.
01Overview
Heliad is an open Solana endpoint with two tools on it. A priority fee estimator, forked from the code Helius publishes as open source, and a fee report that prices any transaction against the fees being paid right now.
The same URL also forwards 28 standard Solana methods to public nodes. There is no API key and no account. The project has a token, HELIAD, which is separate from the endpoint and not needed to use it.
02The fork
The fee engine is a fork of atlas-priority-fee-estimator, the service behind Helius's getPriorityFeeEstimate. Helius publishes it under the Apache-2.0 licence. Heliad runs a JavaScript port of it.
| Upstream | helius-labs/atlas-priority-fee-estimator |
|---|---|
| Licence | Apache License 2.0 |
| Ported from | d15db477f400cc7e295837e13e50d785ea3c7965 |
| Language | Rust upstream, JavaScript here |
What was forked
- How each transaction is priced, including v1 transactions.
- The calculation: global and per-account groups, then the highest value of each percentile.
- Request validation, the six levels and the recommended fee.
What was changed
- Blocks are read over JSON-RPC, not from a gRPC stream.
- The window is at most 30 blocks, not 150 slots.
- Lookup tables and serialized v1 transactions are not resolved.
The full list of ported functions and changes is in the NOTICE, next to a copy of the Apache-2.0 licence.
Only this open-source component was forked. The rest of the Helius platform is closed and is not part of Heliad. Heliad is an independent project, not affiliated with or endorsed by Helius.
03API
Send a JSON-RPC 2.0 request with POST. A GET on the same URL returns a description of the service.
| Endpoint | https://heliad.vercel.app/api/rpc |
|---|---|
| Network | Solana mainnet |
| Auth | None |
| Batch | Up to 10 requests per call |
| Rate limit | About 90 requests per minute per IP address, best effort |
| CORS | Open, callable from a browser |
Quick start
curl -s https://heliad.vercel.app/api/rpc \
-H "content-type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"getSlot"}'
With @solana/web3.js, pass the URL where you would pass any RPC endpoint:
import { Connection } from "@solana/web3.js";
const connection = new Connection("https://heliad.vercel.app/api/rpc");
const slot = await connection.getSlot();
Methods
| Implemented | getPriorityFeeEstimate getTransactionFeeReport |
|---|---|
| Accounts | getAccountInfo getBalance getMultipleAccounts getMinimumBalanceForRentExemption |
| Transactions | getTransaction getSignaturesForAddress getSignatureStatuses simulateTransaction sendTransaction getFeeForMessage getRecentPrioritizationFees |
| Tokens | getTokenAccountsByOwner getTokenAccountBalance getTokenSupply getTokenLargestAccounts |
| Blocks | getSlot getBlock getBlocks getBlockHeight getBlockTime getLatestBlockhash isBlockhashValid getEpochInfo |
| Node | getHealth getVersion getGenesisHash getTransactionCount getRecentPerformanceSamples |
| Not served | DAS, webhooks, enhanced transactions, WebSockets, getProgramAccounts. Any other method returns -32601. |
04Fee estimates
getPriorityFeeEstimate returns a price in micro-lamports per compute unit, ready to pass to setComputeUnitPrice. The parameters, the validation and the response are those of the upstream project.
curl -s https://heliad.vercel.app/api/rpc \
-H "content-type: application/json" \
-d '{
"jsonrpc": "2.0", "id": "1",
"method": "getPriorityFeeEstimate",
"params": [{
"accountKeys": ["TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"],
"options": { "includeAllPriorityFeeLevels": true }
}]
}'
Parameters
| transaction | Serialized legacy or v0 transaction, Base58 or Base64. The estimate is scoped to its writable accounts. |
|---|---|
| accountKeys | Up to 500 public keys. Each one gets its own group of fees. Cannot be combined with transaction. |
| neither | A global estimate across recent transactions. |
| priorityLevel | Min Low Medium High VeryHigh UnsafeMax. Default Medium. |
| includeAllPriorityFeeLevels | Returns all six levels in priorityFeeLevels. |
| recommended | Returns the median with a floor of 10,000. Cannot be combined with priorityLevel, includeAllPriorityFeeLevels, lookbackSlots or includeVote. |
| lookbackSlots | 1 to 150. Capped by the number of blocks held, see below. |
| includeVote | Counts vote transactions too. |
| evaluateEmptySlotAsZero | Adds a zero for each block where an account has no transaction. On by default when options is sent. |
| includeDetails | Adds mean, standard deviation and sample count for each group. |
| transactionEncoding | Base58 (default) or Base64. |
How it is computed
- Only successful transactions are counted.
- Legacy and v0 transactions: the price set by
SetComputeUnitPrice, or zero when none is set. - v1 transactions:
transactionConfig.priorityFee, a total in lamports, divided by the compute unit limit. Without a limit the sample is skipped. - Fees are grouped globally and per requested account, using the writable accounts each transaction locks.
- Each level is a percentile (0, 25, 50, 75, 95, 100), and the result is the highest value of that percentile across the groups.
Where it differs from Helius
- Shorter window. Up to 6 new blocks are read per request and up to 30 are kept while the service is warm. Upstream keeps 150 slots.
- VeryHigh. The open-source code returns the plain 95th percentile, and so does Heliad. Helius's hosted API documents extra headroom on that level.
- Lookup tables. For a serialized transaction, only the static account keys are used.
- Serialized v1 transactions are not decoded yet. Pass
accountKeysinstead.
Three response headers say what an estimate was built from: X-Heliad-Source, X-Heliad-Slots and X-Heliad-Samples. If no block can be read, the source falls back to slot-minima, which gives much lower numbers.
05Fee report
getTransactionFeeReport is a Heliad extension. It takes the signature of a confirmed transaction, prices it with the same rules as the estimator, and places it among the fees being paid now.
curl -s https://heliad.vercel.app/api/rpc \
-H "content-type: application/json" \
-d '{"jsonrpc":"2.0","id":1,
"method":"getTransactionFeeReport",
"params":["TRANSACTION_SIGNATURE"]}'
| priorityFee | The price bid, in micro-lamports per compute unit, and the total in lamports. |
|---|---|
| computeUnits | The limit, whether it was set explicitly, and the units consumed. |
| fee | Total fee and base fee, in lamports. |
| network.percentile | Share of recent transactions that bid the same or less. |
| network.band | belowLow low medium high or veryHigh. |
| network.lamportsAtCurrentLevels | What the same compute limit would cost at each current level. |
Public nodes only keep recent history, so an old signature returns -32004. The comparison uses the latest blocks, not the blocks around the transaction.
06Token
HELIAD is the project's token. It is a standard pump.fun coin: the name, the symbol and the image are fixed when it is created.
| Name | Heliad |
|---|---|
| Ticker | HELIAD |
| Contract | Published here at launch |
| Network | Solana mainnet |
| Launchpad | pump.fun bonding curve |
| Supply | 1,000,000,000 |
| Dev allocation | 0. The creator does not buy at launch. |
| Presale | None |
The token is not needed to use the API. Holding it gives no access, no priority and no rights over the service.
Only the contract shown on this site is official. Anyone can create another token with the same name, so compare the full address before you trade.
07Wallet
The Connect wallet button on the home page reads your public address and shows a short version of it in the header. That is all it does.
- The site never asks you to sign a message or approve a transaction.
- No trade happens on this site.
- If any page using the Heliad name asks for a signature or a seed phrase, close it.
08Limits and risks
The endpoint has no uptime guarantee. It runs on public Solana nodes and a free hosting tier, so it can be slow, rate limited or unavailable.
- Do not put it behind anything that must not fail, such as a trading bot or a production app.
- Fee estimates are computed on a short window and can be wrong. Check them before you rely on them.
- The token has no intrinsic value. Its price is extremely volatile and you can lose everything you put in.
- Nothing on this site is financial advice.