# activeAssetData
Source: https://docs.uniblock.dev/api-reference/hyperliquid/activeassetdata
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#2
Native Hyperliquid `/info` operation. Returns the user's active asset data (leverage, max trade sizes) for `coin`.
# allBorrowLendReserveStates
Source: https://docs.uniblock.dev/api-reference/hyperliquid/allborrowlendreservestates
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#30
Native Hyperliquid `/info` operation. Returns the reserve states for all borrow/lend markets.
# allMids
Source: https://docs.uniblock.dev/api-reference/hyperliquid/allmids
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#55
Native Hyperliquid `/info` operation. Returns the mid prices for all coins. Accepts an optional `dex` to scope a HIP-3 builder-deployed perp DEX.
# allPerpMetas
Source: https://docs.uniblock.dev/api-reference/hyperliquid/allperpmetas
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#20
Native Hyperliquid `/info` operation. Returns perpetuals metadata across all perpetual DEXs.
# approvedBuilders
Source: https://docs.uniblock.dev/api-reference/hyperliquid/approvedbuilders
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#15
Native Hyperliquid `/info` operation. Returns the builders `user` has approved.
# batchClearinghouseStates
Source: https://docs.uniblock.dev/api-reference/hyperliquid/batchclearinghousestates
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#61
Synthetic Uniblock `type`, not a native Hyperliquid operation. Reads the perpetuals clearinghouse state for a *list* of `users` in one request (one `clearinghouseState` sub-request per user), returning one slot per user. The list is capped at 50 users Uniblock-side.
# batchPortfolioStates
Source: https://docs.uniblock.dev/api-reference/hyperliquid/batchportfoliostates
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#62
Synthetic Uniblock `type`, not a native Hyperliquid operation. Composes a full normalized Portfolio State (perpetuals + spot + user abstraction) for a *list* of `users` in one request, returning one slot per user. The list is capped at 50 users Uniblock-side.
# borrowLendReserveState
Source: https://docs.uniblock.dev/api-reference/hyperliquid/borrowlendreservestate
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#31
Native Hyperliquid `/info` operation. Returns the borrow/lend reserve state for `token`.
# borrowLendUserState
Source: https://docs.uniblock.dev/api-reference/hyperliquid/borrowlenduserstate
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#32
Native Hyperliquid `/info` operation. Returns the user's borrow/lend positions.
# builderFills
Source: https://docs.uniblock.dev/api-reference/hyperliquid/builderfills
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#45
Native Hyperliquid `/info` operation. Returns the most recent fills routed through `builder`, across every user. Each row carries the `user` it belongs to. Set `aggregateByTime` to merge fills that occurred at the same time, and `cursor` to page backwards in time.
# builderFillsByTime
Source: https://docs.uniblock.dev/api-reference/hyperliquid/builderfillsbytime
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#46
Native Hyperliquid `/info` operation. Returns the fills routed through `builder` within a time range, across every user. `startTime` is required unless `cursor` is supplied. Set `aggregateByTime` to merge fills that occurred at the same time.
# candleSnapshot
Source: https://docs.uniblock.dev/api-reference/hyperliquid/candlesnapshot
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#53
Native Hyperliquid `/info` operation. Returns OHLC candles for the coin, interval, and time range in `req`.
# clearinghouseState
Source: https://docs.uniblock.dev/api-reference/hyperliquid/clearinghousestate
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#1
Native Hyperliquid `/info` operation. Returns the perpetuals clearinghouse state (margin summary, open positions) for `user`. Accepts an optional `dex` to scope a HIP-3 builder-deployed perp DEX.
# delegations
Source: https://docs.uniblock.dev/api-reference/hyperliquid/delegations
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#33
Native Hyperliquid `/info` operation. Returns the user's staking delegations.
# delegatorHistory
Source: https://docs.uniblock.dev/api-reference/hyperliquid/delegatorhistory
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#50
Native Hyperliquid `/info` operation. Returns the user's staking-delegation history.
# delegatorRewards
Source: https://docs.uniblock.dev/api-reference/hyperliquid/delegatorrewards
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#51
Native Hyperliquid `/info` operation. Returns the user's staking rewards.
# delegatorSummary
Source: https://docs.uniblock.dev/api-reference/hyperliquid/delegatorsummary
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#34
Native Hyperliquid `/info` operation. Returns a summary of the user's staking delegations.
# exchangeStatus
Source: https://docs.uniblock.dev/api-reference/hyperliquid/exchangestatus
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#26
Native Hyperliquid `/info` operation. Returns the current exchange status.
# extraAgents
Source: https://docs.uniblock.dev/api-reference/hyperliquid/extraagents
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#14
Native Hyperliquid `/info` operation. Returns the user's approved extra agents.
# frontendOpenOrders
Source: https://docs.uniblock.dev/api-reference/hyperliquid/frontendopenorders
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#7
Native Hyperliquid `/info` operation. Returns the user's open orders with frontend annotations. Accepts an optional `dex` to scope a HIP-3 builder-deployed perp DEX.
# fundingHistory
Source: https://docs.uniblock.dev/api-reference/hyperliquid/fundinghistory
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#48
Native Hyperliquid `/info` operation. Returns the funding-rate history for `coin` within a time range.
# historicalOrders
Source: https://docs.uniblock.dev/api-reference/hyperliquid/historicalorders
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#56
Native Hyperliquid `/info` operation. Returns the user's historical orders.
# l2Book
Source: https://docs.uniblock.dev/api-reference/hyperliquid/l2book
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#54
Native Hyperliquid `/info` operation. Returns the L2 order book for `coin`. Optionally aggregate price levels with `nSigFigs` (and `mantissa`).
# leadingVaults
Source: https://docs.uniblock.dev/api-reference/hyperliquid/leadingvaults
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#12
Native Hyperliquid `/info` operation. Returns the vaults `user` leads.
# liquidatable
Source: https://docs.uniblock.dev/api-reference/hyperliquid/liquidatable
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#40
Native Hyperliquid `/info` operation. Returns the positions currently liquidatable.
# marginTable
Source: https://docs.uniblock.dev/api-reference/hyperliquid/margintable
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#18
Native Hyperliquid `/info` operation. Returns the margin tiers for margin-table `id`.
# maxBuilderFee
Source: https://docs.uniblock.dev/api-reference/hyperliquid/maxbuilderfee
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#35
Native Hyperliquid `/info` operation. Returns the max builder fee `user` approved for `builder`.
# maxMarketOrderNtls
Source: https://docs.uniblock.dev/api-reference/hyperliquid/maxmarketorderntls
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#38
Native Hyperliquid `/info` operation. Returns the max market-order notional per asset.
# meta
Source: https://docs.uniblock.dev/api-reference/hyperliquid/meta
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#16
Native Hyperliquid `/info` operation. Returns perpetuals metadata (the universe of perpetual assets). Accepts an optional `dex` to scope a HIP-3 builder-deployed perp DEX.
# openOrders
Source: https://docs.uniblock.dev/api-reference/hyperliquid/openorders
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#6
Native Hyperliquid `/info` operation. Returns the user's resting open orders. Accepts an optional `dex` to scope a HIP-3 builder-deployed perp DEX.
# orderStatus
Source: https://docs.uniblock.dev/api-reference/hyperliquid/orderstatus
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#58
Native Hyperliquid `/info` operation. Returns the status of a single order for `user`, identified by `oid` (numeric order id) or `cloid` (client order id).
# orderStatusByOid
Source: https://docs.uniblock.dev/api-reference/hyperliquid/orderstatusbyoid
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#59
Native Hyperliquid `/info` operation. Alias of `orderStatus` (Hydromancer parity). Returns the status of a single order for `user`, identified by `oid` or `cloid`; normalized to `orderStatus` before routing.
# outcomeMeta
Source: https://docs.uniblock.dev/api-reference/hyperliquid/outcomemeta
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#8
Native Hyperliquid `/info` operation. Returns metadata for prediction-market outcomes.
# perpAnnotation
Source: https://docs.uniblock.dev/api-reference/hyperliquid/perpannotation
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#21
Native Hyperliquid `/info` operation. Returns the annotation for a perpetual `coin`.
# perpCategories
Source: https://docs.uniblock.dev/api-reference/hyperliquid/perpcategories
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#22
Native Hyperliquid `/info` operation. Returns the perpetual asset categories.
# perpConciseAnnotations
Source: https://docs.uniblock.dev/api-reference/hyperliquid/perpconciseannotations
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#23
Native Hyperliquid `/info` operation. Returns concise annotations for all perpetuals.
# perpDeployAuctionStatus
Source: https://docs.uniblock.dev/api-reference/hyperliquid/perpdeployauctionstatus
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#28
Native Hyperliquid `/info` operation. Returns the current perpetual-deploy auction status.
# perpDexLimits
Source: https://docs.uniblock.dev/api-reference/hyperliquid/perpdexlimits
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#25
Native Hyperliquid `/info` operation. Returns the limits for perpetual `dex`.
# perpDexs
Source: https://docs.uniblock.dev/api-reference/hyperliquid/perpdexs
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#19
Native Hyperliquid `/info` operation. Returns the list of perpetual DEXs.
# perpDexStatus
Source: https://docs.uniblock.dev/api-reference/hyperliquid/perpdexstatus
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#24
Native Hyperliquid `/info` operation. Returns the status of perpetual `dex`.
# perpsAtOpenInterestCap
Source: https://docs.uniblock.dev/api-reference/hyperliquid/perpsatopeninterestcap
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#39
Native Hyperliquid `/info` operation. Returns the perpetuals currently at their open-interest cap. Accepts an optional `dex` to scope a HIP-3 builder-deployed perp DEX.
# portfolioState
Source: https://docs.uniblock.dev/api-reference/hyperliquid/portfoliostate
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#60
Synthetic Uniblock `type`, not a native Hyperliquid operation. Composes a normalized Hyperliquid Portfolio State for `user` — perpetuals, spot, and user abstraction state — through this same route, and returns the stable Uniblock contract rather than a raw `/info` response.
# settledOutcome
Source: https://docs.uniblock.dev/api-reference/hyperliquid/settledoutcome
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#9
Native Hyperliquid `/info` operation. Returns the settled result for a prediction-market `outcome`.
# spotClearinghouseState
Source: https://docs.uniblock.dev/api-reference/hyperliquid/spotclearinghousestate
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#3
Native Hyperliquid `/info` operation. Returns the spot clearinghouse state (token balances) for `user`.
# spotDeployState
Source: https://docs.uniblock.dev/api-reference/hyperliquid/spotdeploystate
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#27
Native Hyperliquid `/info` operation. Returns the user's spot-deploy auction state.
# spotMeta
Source: https://docs.uniblock.dev/api-reference/hyperliquid/spotmeta
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#17
Native Hyperliquid `/info` operation. Returns spot metadata (tokens and trading pairs).
# spotPairDeployAuctionStatus
Source: https://docs.uniblock.dev/api-reference/hyperliquid/spotpairdeployauctionstatus
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#29
Native Hyperliquid `/info` operation. Returns the current spot-pair-deploy auction status.
# subAccounts
Source: https://docs.uniblock.dev/api-reference/hyperliquid/subaccounts
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#52
Native Hyperliquid `/info` operation. Returns the user's sub-accounts.
# userAbstraction
Source: https://docs.uniblock.dev/api-reference/hyperliquid/userabstraction
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#4
Native Hyperliquid `/info` operation. Returns the user abstraction state for `user`.
# userDexAbstraction
Source: https://docs.uniblock.dev/api-reference/hyperliquid/userdexabstraction
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#57
Native Hyperliquid `/info` operation. Returns the user's HIP-3 DEX abstraction state.
# userFees
Source: https://docs.uniblock.dev/api-reference/hyperliquid/userfees
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#37
Native Hyperliquid `/info` operation. Returns the user's fee schedule and traded volume.
# userFills
Source: https://docs.uniblock.dev/api-reference/hyperliquid/userfills
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#41
Native Hyperliquid `/info` operation. Returns the user's most recent fills. Set `aggregateByTime` to merge fills that occurred at the same time.
# userFillsByTime
Source: https://docs.uniblock.dev/api-reference/hyperliquid/userfillsbytime
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#42
Native Hyperliquid `/info` operation. Returns the user's fills within a time range. Set `aggregateByTime` to merge fills that occurred at the same time, and `reversed` to return oldest-first.
# userFunding
Source: https://docs.uniblock.dev/api-reference/hyperliquid/userfunding
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#47
Native Hyperliquid `/info` operation. Returns the user's funding payments within a time range.
# userNonFundingLedgerUpdates
Source: https://docs.uniblock.dev/api-reference/hyperliquid/usernonfundingledgerupdates
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#49
Native Hyperliquid `/info` operation. Returns the user's non-funding ledger updates within a time range.
# userRole
Source: https://docs.uniblock.dev/api-reference/hyperliquid/userrole
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#13
Native Hyperliquid `/info` operation. Returns the user's role (e.g. user, agent, sub-account, vault).
# userTwapSliceFills
Source: https://docs.uniblock.dev/api-reference/hyperliquid/usertwapslicefills
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#43
Native Hyperliquid `/info` operation. Returns the user's TWAP slice fills.
# userTwapSliceFillsByTime
Source: https://docs.uniblock.dev/api-reference/hyperliquid/usertwapslicefillsbytime
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#44
Native Hyperliquid `/info` operation. Returns the user's TWAP slice fills within a time range.
# userVaultEquities
Source: https://docs.uniblock.dev/api-reference/hyperliquid/uservaultequities
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#11
Native Hyperliquid `/info` operation. Returns the user's vault equity positions.
# validatorL1Votes
Source: https://docs.uniblock.dev/api-reference/hyperliquid/validatorl1votes
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#36
Native Hyperliquid `/info` operation. Returns the current validator L1 votes.
# vaultSummaries
Source: https://docs.uniblock.dev/api-reference/hyperliquid/vaultsummaries
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#10
Native Hyperliquid `/info` operation. Returns summaries of all vaults.
# webData2
Source: https://docs.uniblock.dev/api-reference/hyperliquid/webdata2
/reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#5
Native Hyperliquid `/info` operation. Returns aggregated frontend web data for `user`.
# Send JSON-RPC Requests
Source: https://docs.uniblock.dev/api-reference/json-rpc/send-json-rpc-requests
/reference/api-json.json post /json-rpc
Stateless, lightweight, remote procedure call (RPC) protocol that is commonly used when interacting with chain.
# Get Token 24 Hour Volume
Source: https://docs.uniblock.dev/api-reference/market-data/get-token-24-hour-volume
/reference/api-json.json get /market-data/24-hour-volume
Gets the 24 hour volume of a token.
# Get Token History Snapshot
Source: https://docs.uniblock.dev/api-reference/market-data/get-token-history-snapshot
/reference/api-json.json get /market-data/history
Gets the price, volume, market cap of a token at a given date.
# Get Token Market Cap
Source: https://docs.uniblock.dev/api-reference/market-data/get-token-market-cap
/reference/api-json.json get /market-data/market-cap
Gets the market cap of a token.
# Get Token Market Chart
Source: https://docs.uniblock.dev/api-reference/market-data/get-token-market-chart
/reference/api-json.json get /market-data/chart-range
Gets the price, volume, market cap of a token at a given range on a predefined granularity.
# Get Token Price
Source: https://docs.uniblock.dev/api-reference/market-data/get-token-price
/reference/api-json.json get /market-data/price
Gets the price of a token.
# Get Token Price Range
Source: https://docs.uniblock.dev/api-reference/market-data/get-token-price-range
/reference/api-json.json get /market-data/chart-price-range
Gets the price of a token at a given range in a period.
# Get Trending Tokens
Source: https://docs.uniblock.dev/api-reference/market-data/get-trending-tokens
/reference/api-json.json get /market-data/trending
Gets the trending tokens.
# Get Collection Floor Prices
Source: https://docs.uniblock.dev/api-reference/nft/get-collection-floor-prices
/reference/api-json.json get /nft/floor-price
Returns the floor prices of a NFT collection by marketplace.
# Get Collection NFTs
Source: https://docs.uniblock.dev/api-reference/nft/get-collection-nfts
/reference/api-json.json get /nft/nft-in-collection
Get the NFTs of a collection by contract address.
# Get Collection Rarity Summary
Source: https://docs.uniblock.dev/api-reference/nft/get-collection-rarity-summary
/reference/api-json.json get /nft/collection/rarity
Get summary of attribute prevalence for an NFT collection. Commonly used to calculate rarity scores for a collection based on its traits.
# Get Collection Trait Attributes
Source: https://docs.uniblock.dev/api-reference/nft/get-collection-trait-attributes
/reference/api-json.json get /nft/collection/trait/attributes
Get the attributes of a trait in a collection.
# Get Collection Traits
Source: https://docs.uniblock.dev/api-reference/nft/get-collection-traits
/reference/api-json.json get /nft/collection/traits
Get the traits of a collection.
# Get Contract NFT Owners
Source: https://docs.uniblock.dev/api-reference/nft/get-contract-nft-owners
/reference/api-json.json get /nft/owners/contract
Get list of wallet addresses owning one or more of the contract's nfts.
# Get NFT Collection Metadata
Source: https://docs.uniblock.dev/api-reference/nft/get-nft-collection-metadata
/reference/api-json.json get /nft/collection-metadata
Get the metadata of an NFT collection.
# Get NFT Metadata
Source: https://docs.uniblock.dev/api-reference/nft/get-nft-metadata
/reference/api-json.json get /nft/metadata
Get the metadata of a specific NFT.
# Get NFT Owners
Source: https://docs.uniblock.dev/api-reference/nft/get-nft-owners
/reference/api-json.json get /nft/owners/nft
Get owner's wallet address or all owners' wallet addresses of a specific nft. Number of owners can be greater than 1 for ERC-1155 tokens, or 0 if the token is burned.
# Get NFT Sales
Source: https://docs.uniblock.dev/api-reference/nft/get-nft-sales
/reference/api-json.json get /nft/sales
Gets NFT sales that have happened through on-chain marketplaces.
# Get NFT Transfers
Source: https://docs.uniblock.dev/api-reference/nft/get-nft-transfers
/reference/api-json.json get /nft/transfers/nft
Get the transfers of a nft.
# Get Token Airdrop Flag
Source: https://docs.uniblock.dev/api-reference/nft/get-token-airdrop-flag
/reference/api-json.json get /nft/is-airdrop
Returns whether a token is marked as an airdrop or not.
# Get Wallet NFT Balances
Source: https://docs.uniblock.dev/api-reference/nft/get-wallet-nft-balances
/reference/api-json.json get /nft/balance
Get the NFT balances of an address.
# Get Wallet NFT Collections
Source: https://docs.uniblock.dev/api-reference/nft/get-wallet-nft-collections
/reference/api-json.json get /nft/owned-collections
Gets all NFT contracts held by an owner address.
# Get Wallet NFT Holder Status
Source: https://docs.uniblock.dev/api-reference/nft/get-wallet-nft-holder-status
/reference/api-json.json get /nft/is-nft-holder
This endpoint checks whether a wallet address holds a specific NFT or if a wallet address holds any NFT from a given collection.
If tokenId is entered, the endpoint will check if the wallet address holds that exact NFT. While if tokenId is omitted, the endpoint will check if the wallet address holds any NFT from the entered collection.
# Get Wallet NFT Transfers
Source: https://docs.uniblock.dev/api-reference/nft/get-wallet-nft-transfers
/reference/api-json.json get /nft/transfers
Get the NFT transfers of a wallet.
# Get Address ERC-1155 Transfers
Source: https://docs.uniblock.dev/api-reference/scan/get-address-erc-1155-transfers
/reference/api-json.json get /scan/account-erc1155-transactions
Returns the list of ERC-1155 ( Multi Token Standard ) tokens transferred by an address, with optional filtering by token contract.
# Get Address ERC-20 Balance
Source: https://docs.uniblock.dev/api-reference/scan/get-address-erc-20-balance
/reference/api-json.json get /scan/token-balance
Returns the current balance of ERC-20 token of an address
# Get Address ERC-20 Transfers
Source: https://docs.uniblock.dev/api-reference/scan/get-address-erc-20-transfers
/reference/api-json.json get /scan/account-erc20-transactions
Returns the list of ERC-20 tokens transferred by an address, with optional filtering by token contract.
# Get Address ERC-721 Transfers
Source: https://docs.uniblock.dev/api-reference/scan/get-address-erc-721-transfers
/reference/api-json.json get /scan/account-erc721-transactions
Returns the list of ERC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract.
# Get Address Ether Balance
Source: https://docs.uniblock.dev/api-reference/scan/get-address-ether-balance
/reference/api-json.json get /scan/account-native-balance-single
Returns the Ether balance of a given address.
# Get Address Ether Balances
Source: https://docs.uniblock.dev/api-reference/scan/get-address-ether-balances
/reference/api-json.json get /scan/account-native-balance-multi
Returns the balance of the accounts from a list of addresses.
# Get Address Event Logs
Source: https://docs.uniblock.dev/api-reference/scan/get-address-event-logs
/reference/api-json.json get /scan/log-address
Returns the event logs from an address, with optional filtering by block range.
# Get Address Event Logs by Topic
Source: https://docs.uniblock.dev/api-reference/scan/get-address-event-logs-by-topic
/reference/api-json.json get /scan/log-by-address-filtered-topics
Returns the event logs from an address, filtered by topics and block range.
# Get Address Internal Transactions
Source: https://docs.uniblock.dev/api-reference/scan/get-address-internal-transactions
/reference/api-json.json get /scan/account-internal-transactions-by-address
Returns the list of internal transactions performed by an address, with optional pagination.
# Get Address Transactions
Source: https://docs.uniblock.dev/api-reference/scan/get-address-transactions
/reference/api-json.json get /scan/account-normal-transactions
Returns the list of transactions performed by an address, with optional pagination.
# Get Beacon Chain Withdrawals by Address
Source: https://docs.uniblock.dev/api-reference/scan/get-beacon-chain-withdrawals-by-address
/reference/api-json.json get /scan/account-beacon-withdrawals
Retrieves beacon chain withdrawal transactions made to a specified address.
# Get Block Mining ETA
Source: https://docs.uniblock.dev/api-reference/scan/get-block-mining-eta
/reference/api-json.json get /scan/block-get-countdown
Returns the estimated time remaining, in seconds, until a certain block is mined.
# Get Block Number by Time
Source: https://docs.uniblock.dev/api-reference/scan/get-block-number-by-time
/reference/api-json.json get /scan/block-by-timestamp
Returns the block number that was mined at a certain timestamp.
# Get Block Rewards
Source: https://docs.uniblock.dev/api-reference/scan/get-block-rewards
/reference/api-json.json get /scan/block-rewards
Returns the block reward and "Uncle" block rewards.
# Get Blockchain Size History
Source: https://docs.uniblock.dev/api-reference/scan/get-blockchain-size-history
/reference/api-json.json get /scan/native-node-size
Returns the size of the native blockchain, in bytes, over a date range.
# Get Contract ABI
Source: https://docs.uniblock.dev/api-reference/scan/get-contract-abi
/reference/api-json.json get /scan/contract-abi
Returns the Contract Application Binary Interface ( ABI ) of a verified smart contract.
# Get Contract Creator Info
Source: https://docs.uniblock.dev/api-reference/scan/get-contract-creator-info
/reference/api-json.json get /scan/contract-creation
Returns a contract's deployer address and transaction hash it was created, up to 5 at a time.
# Get Contract Execution Status
Source: https://docs.uniblock.dev/api-reference/scan/get-contract-execution-status
/reference/api-json.json get /scan/transaction-execution-status
Returns the status code of a contract execution.
# Get Contract Source Code
Source: https://docs.uniblock.dev/api-reference/scan/get-contract-source-code
/reference/api-json.json get /scan/contract-source-code
Returns the Solidity source code of a verified smart contract.
# Get ERC-20 Supply
Source: https://docs.uniblock.dev/api-reference/scan/get-erc-20-supply
/reference/api-json.json get /scan/token-supply
Returns the current amount of ERC-20 token in circulation
# Get Ether Supply Summary
Source: https://docs.uniblock.dev/api-reference/scan/get-ether-supply-summary
/reference/api-json.json get /scan/native-supply
Current amount of Ether in circulation, ETH2 Staking rewards, EIP1559 burnt fees, and total withdrawn ETH from the beacon chain
# Get Event Logs by Block
Source: https://docs.uniblock.dev/api-reference/scan/get-event-logs-by-block
/reference/api-json.json get /scan/log-by-topics
Returns the events log in a block range, filtered by topics.
# Get Gas Price Tiers
Source: https://docs.uniblock.dev/api-reference/scan/get-gas-price-tiers
/reference/api-json.json get /scan/current-gas-estimation
Returns the current Safe, Proposed and Fast gas prices.
# Get Internal Transactions by Block
Source: https://docs.uniblock.dev/api-reference/scan/get-internal-transactions-by-block
/reference/api-json.json get /scan/account-internal-transactions-by-block-range
Returns the list of internal transactions performed within a block range, with optional pagination.
# Get Native Token Price
Source: https://docs.uniblock.dev/api-reference/scan/get-native-token-price
/reference/api-json.json get /scan/native-price
Returns the latest price of 1 Native Token.
# Get Node Count
Source: https://docs.uniblock.dev/api-reference/scan/get-node-count
/reference/api-json.json get /scan/native-node-count
Returns the total number of discoverable chain nodes.
# Get Transaction Confirmation Time
Source: https://docs.uniblock.dev/api-reference/scan/get-transaction-confirmation-time
/reference/api-json.json get /scan/estimation-confirmation-time
Returns the estimated time, in seconds, for a transaction to be confirmed on the blockchain.
# Get Transaction Execution Status
Source: https://docs.uniblock.dev/api-reference/scan/get-transaction-execution-status
/reference/api-json.json get /scan/transaction-receipt-status
Returns the status code of a transaction execution.
# Get Transaction Internal Transactions
Source: https://docs.uniblock.dev/api-reference/scan/get-transaction-internal-transactions
/reference/api-json.json get /scan/account-internal-transactions-by-hash
Returns the list of internal transactions performed within a transaction.
# Verify Contract Source
Source: https://docs.uniblock.dev/api-reference/scan/verify-contract-source
/reference/api-json.json post /scan/contract-verify-source-code
Submits a contract source code to Etherscan for verification.
# Verify Proxy Contract Source
Source: https://docs.uniblock.dev/api-reference/scan/verify-proxy-contract-source
/reference/api-json.json get /scan/contract-verify-proxy
Submits a proxy contract source code to Etherscan for verification.
# Get Address Allowances
Source: https://docs.uniblock.dev/api-reference/token/get-address-allowances
/reference/api-json.json get /token/allowances
Get the allowances of an address.
# Get Address Portfolio
Source: https://docs.uniblock.dev/api-reference/token/get-address-portfolio
/reference/api-json.json get /token/portfolio
Get the portfolio of an address.
# Get Address Token Balance History
Source: https://docs.uniblock.dev/api-reference/token/get-address-token-balance-history
/reference/api-json.json get /token/balance/historical
Get the historical token balances of an address.
# Get Address Token Balances
Source: https://docs.uniblock.dev/api-reference/token/get-address-token-balances
/reference/api-json.json get /token/balance
Get the native and fungible token balances of an address.
# Get Address Token Transfers
Source: https://docs.uniblock.dev/api-reference/token/get-address-token-transfers
/reference/api-json.json get /token/transfers
Get the token transfers of an address.
# Get Token Metadata
Source: https://docs.uniblock.dev/api-reference/token/get-token-metadata
/reference/api-json.json get /token/metadata
Get token metadata. Batch query supported via comma-separated tokenAddress values.
# Get Token USD Price
Source: https://docs.uniblock.dev/api-reference/token/get-token-usd-price
/reference/api-json.json get /token/price
Get the USD price of a token. Batch query supported via comma-separated contractAddress values.
# Get Token USD Price History
Source: https://docs.uniblock.dev/api-reference/token/get-token-usd-price-history
/reference/api-json.json get /token/price/historical
Get the historical USD price of a token.
# Get Wallet Last Active
Source: https://docs.uniblock.dev/api-reference/token/get-wallet-last-active
/reference/api-json.json get /token/activity
Retrieve the last active timestamp for a wallet across each of 100+ chains.
# Get Address Transaction Details
Source: https://docs.uniblock.dev/api-reference/transaction/get-address-transaction-details
/reference/api-json.json get /transactions/advanced
Get the transactions of an address, including sends, receives, token and NFT transfers, and contract interactions.
# Get Address Transactions
Source: https://docs.uniblock.dev/api-reference/transaction/get-address-transactions
/reference/api-json.json get /transactions
Get the transactions of an address.
# Get Block Transactions
Source: https://docs.uniblock.dev/api-reference/transaction/get-block-transactions
/reference/api-json.json get /transactions/block
Get all transactions from in a block.
# Get Transaction by Hash
Source: https://docs.uniblock.dev/api-reference/transaction/get-transaction-by-hash
/reference/api-json.json get /transaction
Get a specific transaction from its hash.
# Create Address Webhook
Source: https://docs.uniblock.dev/api-reference/webhook/create-address-webhook
/reference/api-json.json post /webhook/address-activity
Create an address activity driven webhook.
# Create Contract Webhook
Source: https://docs.uniblock.dev/api-reference/webhook/create-contract-webhook
/reference/api-json.json post /webhook/contract-event
Create a contract event driven webhook.
# Create Solana Address Webhook
Source: https://docs.uniblock.dev/api-reference/webhook/create-solana-address-webhook
/reference/api-json.json post /webhook/solana-address-activity
Create an address activity driven webhook.
# Delete Webhook by ID
Source: https://docs.uniblock.dev/api-reference/webhook/delete-webhook-by-id
/reference/api-json.json delete /webhook/{id}
Delete a webhook.
# Get All Webhooks
Source: https://docs.uniblock.dev/api-reference/webhook/get-all-webhooks
/reference/api-json.json get /webhook
Get all webhooks.
# Get Webhook Details
Source: https://docs.uniblock.dev/api-reference/webhook/get-webhook-details
/reference/api-json.json get /webhook/{id}
Get a webhook.
# Update Webhook Details
Source: https://docs.uniblock.dev/api-reference/webhook/update-webhook-details
/reference/api-json.json patch /webhook/{id}
Edit an existing webhook.
# Starting out with Uniblock
Source: https://docs.uniblock.dev/guides/getting-started/starting-out
Explore Uniblock product offerings: the Unified API for blockchain data, JSON-RPC across 300+ chains, direct provider APIs, and Hyperliquid tooling.
Access 300+ blockchains including Ethereum, Solana, and Polygon, and 55+ providers through a single, reliable interface. Simple integration, enterprise-grade infrastructure, and the best price-to-performance ratio in the space. Get started today →
# Supported Chains
Source: https://docs.uniblock.dev/guides/getting-started/supported-chains
Browse the full list of blockchains supported by Uniblock across JSON-RPC, Unified API, and direct provider integrations for over 300 networks.
This page redirects to the [Chains Overview](/reference/chains/overview-chains).
# Uniblock Quickstart Guide
Source: https://docs.uniblock.dev/guides/getting-started/uniblock-quickstart-guide
Create your first Uniblock project, generate an API key, make your first request, and integrate the Unified API into your application in minutes.
New to Uniblock? Get access for free through our [dashboard](https://dashboard.uniblock.dev/).
Estimated time: under 10 minutes.
## Steps
1. Create an Uniblock project
2. Make a request
3. Get your project API key
4. Set up Uniblock as your client
***
## 1. Create an Uniblock project
Every Uniblock integration starts with a project. Projects hold your API keys, track your usage, and scope your analytics.
Go to [dashboard.uniblock.dev](https://dashboard.uniblock.dev) and click the **Home** tab in the left sidebar.
Click **Create a project** in the Get Started section on the Home page.
Enter a project name and click **Create**. Your new project appears in the project list immediately.
***
## 2. Make a request
Once your project is created, you can test any Unified API endpoint using the built-in API Tester, no code required.
Click your project from the Home page to enter the project dashboard.
In the left sidebar, go to **Endpoints → API Tester**. This opens the Uniblock Explorer in a new tab.
In the Explorer, find the `/token/metadata` endpoint and expand it. This endpoint returns metadata for any ERC-20 token by chain and address.
Click the **Try it out** button next to the endpoint to activate the input fields.
Example parameter values are pre-filled. Click **Execute** to send the request using those values.
The response body appears below with a `200` status code and the token metadata JSON. You've just made your first Uniblock API call.
***
## 3. Get your project API key
The API key you saw in your project overview is what authenticates your requests and associates usage with your project.
Go back to your project and open the **Overview** page. Your API key is displayed at the top; click the copy icon next to it.
In the Explorer, click the **Authorize** button. Paste your API key into the `X-API-Key` field and click **Authorize**, then **Close**.
With your key active, requests made through the Explorer (or your application) are tracked under your project metrics in **Endpoints → Analytics**.
***
## 4. Set up Uniblock as your client
Ready to integrate Uniblock into your application? Here's a minimal Node.js example to make your first programmatic request.
Create a new directory and initialize it:
```bash npm theme={null}
mkdir my-uniblock-app
cd my-uniblock-app
npm init -y
```
```bash yarn theme={null}
mkdir my-uniblock-app
cd my-uniblock-app
yarn init --yes
```
Create a file named `index.js` with the following contents. Replace `YOUR_API_KEY` with your actual project API key.
```javascript index.js theme={null}
const options = {
method: 'GET',
headers: {
accept: 'application/json',
'X-API-KEY': 'YOUR_API_KEY'
}
};
fetch(
'https://api.uniblock.dev/uni/v1/token/balance?chainId=1&walletAddress=0x3f5ce5fbfe3e9af3971dd833d26ba9b5c936f0be',
options
)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
```
```bash theme={null}
node index.js
```
You should see the token balance output in your console:
```json theme={null}
{
"balances": [
{
"contractAddress": "0x0000000000095413afc295d19edeb1ad7b71c952",
"balance": "100000000000000000000"
},
{
"contractAddress": "0x0000000035f26e72b70552b92bf7e02f67a90549",
"balance": "20000000000000000000000000"
}
],
"cursor": "ALC_0x09a3ecafa817268f77be1283176b946c4ff2e608"
}
```
Your project dashboard will also show this call in **Endpoints → Analytics**.
***
## Analytics & logs
After making API calls, head to **Endpoints → Analytics** in your project to review performance and request history.
* **Analytics**: shows request volume, latency, success/failure rates, and endpoint breakdowns
* **See Detailed Logs** (at the bottom of the Analytics tab): shows per-request detail including provider routing, response headers, and fallback attempts
See the [Analytics & Logs guide](/guides/uniblock/uniblock-analytics) for a full walkthrough.
***
### Congratulations!
You've created a project, made your first request, and set up Uniblock as your API client. You're ready to start building.
[Unified API Overview](/reference/unified-api/overview-unified-apis)
***
Create your free account and start building with unified blockchain infrastructure across 300+ chains.
Explore all available endpoints and interactive playgrounds
# Hyperliquid trader leaderboard: rank a watchlist by margin
Source: https://docs.uniblock.dev/guides/hyperliquid/analytics-dashboard/leaderboard
Rank a watchlist of Hyperliquid traders by perps margin and live volume using batched portfolio reads and the allFills WebSocket fill stream.
A leaderboard ranks traders against each other. The approach here is **watchlist-based**:
you define the set of addresses to track (traders you've discovered from the fill tape,
a curated list, addresses your users follow) and rank them with a single batched read
per refresh, plus live volume from the stream you already have open.
This scales cleanly and costs one request per cycle rather than one per trader.
## 1. Batch the portfolio reads
`batchPortfolioStates` takes a `users` array and returns one result slot per address, in
request order.
```javascript theme={null}
const watchlist = [
"0xaaa...",
"0xbbb...",
// …up to 50
];
const slots = await info({ type: "batchPortfolioStates", users: watchlist });
```
```json theme={null}
[
{
"user": "0xaaa...",
"result": {
"type": "portfolioState",
"address": "0xaaa...",
"chainId": 999,
"perpetuals": { "marginSummary": { "accountValue": "125043.10", "...": "…" } },
"spot": { "balances": [] }
},
"error": null
},
{
"user": "0xbbb...",
"result": null,
"error": "upstream timeout"
}
]
```
**`marginSummary.accountValue` is perps margin only: it excludes vault equity**, same
as on the [wallet tracker](/guides/hyperliquid/analytics-dashboard/wallet-tracker#1-read-account-state).
On a leaderboard this is worse than on a single wallet page: a vault-heavy trader
doesn't just display low, they can be ranked out of the board entirely, and the
mis-ranking is invisible because there's nothing on screen to contradict it.
Folding vault equity in requires one additional `userVaultEquities` call per watchlist
address on top of the existing batched read, so one extra Info call per wallet on every
refresh. At 50 wallets polled every 60 seconds that's a real, ongoing CU cost, not a
one-time fix, so it's a judgment call rather than a strict correctness bug to patch
silently:
* if your watchlist is small and user-pinned (a personal watchlist, not a
leaderboard), the scan is usually worth paying for: sum perps margin and vault
equity into a combined figure (not "Total Value", since it still excludes spot
balances, see the [wallet tracker](/guides/hyperliquid/analytics-dashboard/wallet-tracker#1-read-account-state)),
and keep **Perps Margin** as its own column so the two numbers aren't buried into
each other.
* if the set is large and refreshed often (a public leaderboard), label the column
**Perps Margin** rather than "Account Value", and say plainly that the ranking
excludes vault equity. Don't rank on a number you haven't actually computed.
Whichever you choose, don't call this column "Account Value" or "Total Value"
unqualified, since either name overclaims what a perps-only (or perps-plus-vault) figure
represents.
Two properties of that response shape matter:
**Failure is isolated per user.** A slot that failed has `result: null` and a populated
`error`; the rest of the batch still succeeds. One bad address never takes down the
board, but you must handle the null, or your ranking will throw on the first slot that
didn't resolve.
**Slots come back in request order**, with `user` echoed on each, so you can either zip
by index or key by `user`. Keying by `user` is the more robust of the two.
**The limit is 50 users per request.** Beyond that the request fails; it does not
silently truncate. Chunk larger watchlists, and remember that each chunk is a separate
billed request.
```javascript theme={null}
function chunk(arr, size) {
const out = [];
for (let i = 0; i < arr.length; i += size) out.push(arr.slice(i, i + size));
return out;
}
async function fetchWatchlist(addresses) {
const batches = await Promise.all(
chunk(addresses, 50).map((users) => info({ type: "batchPortfolioStates", users })),
);
return batches.flat().map((slot) => {
const perps = slot.result?.perpetuals;
return {
address: slot.user,
error: slot.error,
accountValue: perps ? Number(perps.marginSummary.accountValue) : null,
positions: (perps?.assetPositions ?? []).map((a) => a.position),
unrealizedPnl: (perps?.assetPositions ?? []).reduce(
(sum, a) => sum + Number(a.position.unrealizedPnl),
0,
),
};
});
}
```
## 2. Rank
Perps margin is the headline metric and comes straight from the batch. Label it
accordingly. As covered above, it excludes vault equity:
```javascript theme={null}
const ranked = rows
.filter((r) => r.accountValue !== null)
.sort((a, b) => b.accountValue - a.accountValue)
.map((r, i) => ({ rank: i + 1, ...r }));
```
Keep the failed rows rather than dropping them silently. Render them unranked with a
"data unavailable" state. A trader vanishing from the board because of one timed-out
request looks like a bug to anyone watching a specific address.
## 3. Keep it live between polls
Refetching the batch every few seconds is the expensive way to make a leaderboard feel
live. The cheap way is to poll slowly and recompute unrealized PnL locally against live
mids in between.
You already have the positions from the batch, and the price store from the
[wallet tracker](/guides/hyperliquid/analytics-dashboard/wallet-tracker#4-keep-mid-prices-live).
That's everything needed:
```javascript theme={null}
function liveAccountValue(row) {
if (row.accountValue === null) return null;
// Replace each position's snapshot uPnL with one computed off the live mid.
const liveUpnl = row.positions.reduce((sum, p) => {
const mid = prices.get(p.coin);
if (mid === undefined) return sum + Number(p.unrealizedPnl);
return sum + Number(p.szi) * (mid - Number(p.entryPx));
}, 0);
return row.accountValue - row.unrealizedPnl + liveUpnl;
}
```
A 60-second poll with live uPnL in between gives a board that ticks continuously at
1/30th the request cost of a 2-second poll.
Pause polling when the tab is hidden. A leaderboard left open in a background tab
overnight is hundreds of requests nobody looked at.
```javascript theme={null}
document.addEventListener("visibilitychange", () => {
document.hidden ? stopPolling() : startPolling();
});
```
## 4. Rank by live volume
Perps margin ranks *wealth* (with the vault-equity caveat above). To rank *activity*, accumulate traded notional per address
from the `allFills` stream, the same subscription already powering prices and the tape.
```javascript theme={null}
const volumeByAddress = new Map();
ws.on("message", (raw) => {
const msg = JSON.parse(raw.toString());
if (msg.channel !== "allFills" || !Array.isArray(msg.fills)) return;
for (const [address, fill] of msg.fills) {
if (!fill?.coin || !fill.px) continue;
const notional = Math.abs(Number(fill.px) * Number(fill.sz));
volumeByAddress.set(address, (volumeByAddress.get(address) ?? 0) + notional);
}
});
```
Because `allFills` is venue-wide, this observes **every** trader, not just your
watchlist, which makes it a discovery mechanism as much as a ranking one:
```javascript theme={null}
// Rank the watchlist by session volume…
const byVolume = watchlist
.map((address) => ({ address, volume: volumeByAddress.get(address) ?? 0 }))
.sort((a, b) => b.volume - a.volume);
// …or surface active traders you aren't tracking yet.
const candidates = [...volumeByAddress.entries()]
.filter(([address]) => !watchlist.includes(address))
.sort((a, b) => b[1] - a[1])
.slice(0, 20);
```
This volume is **session-scoped**: it counts from when your stream connected, and
resets on reconnect. Label it accordingly ("volume this session", not "24h volume"). If
you need a persistent figure, accumulate into a datastore server-side with one
long-lived connection shared across all users, rather than one per browser tab.
## 5. Assemble the surface
```javascript theme={null}
async function refreshLeaderboard(watchlist) {
const rows = (await fetchWatchlist(watchlist)).map((row) => ({
...row,
liveValue: liveAccountValue(row),
sessionVolume: volumeByAddress.get(row.address) ?? 0,
openPositions: row.positions.length,
}));
// Rank only the rows that have a value to rank. A slot that failed upstream is
// not "last". It is unknown, and numbering it as last states something false.
const ranked = rows
.filter((r) => r.liveValue !== null)
.sort((a, b) => b.liveValue - a.liveValue)
.map((row, i) => ({ ...row, rank: i + 1 }));
const unavailable = rows
.filter((r) => r.liveValue === null)
.map((row) => ({ ...row, rank: null }));
// Unranked rows go after the ranked ones, still visible, still identifiable.
return [...ranked, ...unavailable];
}
startPolling(() => refreshLeaderboard(watchlist), 60_000);
```
Sensible columns: rank, address, perps margin (live) with an "excludes vault equity"
label, unrealized PnL, open position count, and session volume, with the address linking through to the
[wallet tracker](/guides/hyperliquid/analytics-dashboard/wallet-tracker) and
[PnL](/guides/hyperliquid/analytics-dashboard/pnl) surfaces for a full history on
whoever's at the top.
Render a `rank: null` row with a dash and a "data unavailable" state rather than a
number. A trader whose batch slot timed out on this cycle will be ranked normally on the
next one, and showing them in last place in the meantime reads as a real ranking change to
anyone watching that address.
## Cost summary
Putting the whole dashboard together, the steady-state cost of a running instance is
small and, importantly, **flat in the number of traders you display**:
| Source | Cost |
| ---------------------------------------- | -------------------------------------- |
| `batchPortfolioStates`, 50 traders @ 60s | 50 lookups/min |
| `allFills` subscription | 1/min, powers prices, tape, and volume |
| `l2Book`, one coin | 0.5/min |
| `webData2` + `meta` @ 60s | 2 requests/min |
The single `allFills` subscription doing triple duty is the load-bearing design decision
across this series. Adding traders to the watchlist grows only the batch; adding surfaces
to the dashboard costs nothing extra at all.
## Where to go next
* [Info API overview](/guides/hyperliquid/info-api/overview) lists every supported
Info type.
* [Rate limits, caching & polling](/guides/hyperliquid/info-api/limits) covers poll
intervals and backoff.
* [Hyperliquid WebSockets](/guides/hyperliquid/websockets/overview) documents every
available channel and its payload.
# Hyperliquid market explorer: open interest and order book
Source: https://docs.uniblock.dev/guides/hyperliquid/analytics-dashboard/market-explorer
Build a venue-wide Hyperliquid view: per-asset open interest, funding rates, a live L2 order book, and a real-time trade tape on Uniblock.
The market explorer switches from one address to the whole venue: every perp asset with
its mark price, open interest, funding rate and 24-hour change; a live order book for a
selected coin; and a streaming tape of every fill on the exchange.
## 1. Build the market table
The asset universe and its market context come from two types that must be read together:
* **`meta`** gives the static universe: asset names, size decimals, max leverage.
* **`webData2`** gives the live context per asset: mark price, open interest, funding,
24-hour volume.
```javascript theme={null}
const [meta, webData] = await Promise.all([
info({ type: "meta" }),
// webData2 is user-scoped, but its assetCtxs slice is global market context.
// Any valid address works; the account sections are simply ignored.
info(
{ type: "webData2", user: "0x0000000000000000000000000000000000000000" },
{ provider: "goldrush" },
),
]);
```
Pin `webData2` to GoldRush for this read. `webData2` is served by several providers,
but they don't all populate the `assetCtxs` slice. Leave the request unpinned and the
waterfall may hand you a response whose `assetCtxs` is an empty array, which renders
every price, open interest, and funding cell in your table as null. Pinning removes
the ambiguity. The `meta` read alongside it needs no pin: every provider serves it.
### The positional join
Here's the part that's easy to get wrong. `webData2.assetCtxs` is a bare array with **no
coin field on its entries**. It's joined to `meta.universe` **by index**, so that
`assetCtxs[i]` is the context for `universe[i]`.
```json theme={null}
{
"universe": [
{ "name": "BTC", "szDecimals": 5, "maxLeverage": 50 },
{ "name": "ETH", "szDecimals": 4, "maxLeverage": 50 }
],
"assetCtxs": [
{ "markPx": "62150.0", "openInterest": "1284.5", "funding": "0.0000125", "prevDayPx": "61200.0", "dayNtlVlm": "482000000.0", "midPx": "62149.5", "oraclePx": "62148.0", "dayBaseVlm": "7820.4", "premium": "0.00003", "impactPxs": ["62149.0", "62150.0"] }
]
}
```
Two consequences follow, and both are load-bearing:
**Index alignment is the join key**, so you must not filter the universe before indexing
into `assetCtxs`. Filtering delisted assets first shifts every subsequent index by one
and silently mislabels the entire rest of the table, showing BTC's open interest
against ETH. Filter *inside* the loop, after you've read `ctxs[i]`.
**The arrays can be different lengths.** `assetCtxs` is not guaranteed to be as long as
`universe`, so guard every access.
```javascript theme={null}
function joinMarketRows(universe, ctxs) {
const rows = [];
for (let i = 0; i < universe.length; i++) {
const asset = universe[i];
// Skip delisted assets HERE, after indexing, so alignment is preserved.
if (!asset || asset.isDelisted) continue;
const ctx = ctxs[i];
const markPx = ctx ? Number(ctx.markPx) : null;
const prevDayPx = ctx ? Number(ctx.prevDayPx) : 0;
rows.push({
coin: asset.name,
szDecimals: asset.szDecimals,
maxLeverage: asset.maxLeverage,
markPx,
midPx: ctx?.midPx != null ? Number(ctx.midPx) : null,
// openInterest is in base units, so multiply by mark for USD notional.
oiNotional: ctx && markPx !== null ? Number(ctx.openInterest) * markPx : null,
funding: ctx ? Number(ctx.funding) : null,
dayNtlVlm: ctx ? Number(ctx.dayNtlVlm) : null,
change24h:
ctx && markPx !== null && prevDayPx > 0 ? (markPx - prevDayPx) / prevDayPx : null,
});
}
return rows;
}
```
A few field notes:
* **`openInterest` is denominated in the base asset**, not USD. Multiply by `markPx` to
get the notional figure people expect to see in a market table.
* **`funding` is the current hourly rate** as a decimal, so `0.0000125` is `0.00125%` per
hour. Multiply by `24 * 365` for the annualized figure if you display APR.
* **`szDecimals`** is the asset's size precision. Use it to format sizes correctly rather
than picking a fixed decimal count for the whole table.
## 2. Overlay live mids
The `markPx` values in `assetCtxs` are a snapshot. Rather than re-polling `webData2` on a
tight loop, reuse the live price store from the
[wallet tracker](/guides/hyperliquid/analytics-dashboard/wallet-tracker#4-keep-mid-prices-live).
The `allFills` stream is already giving you a last-trade price per coin, and it's the
same one subscription regardless of how many assets you display.
```javascript theme={null}
const displayRows = rows.map((row) => ({
...row,
// Live tick wins; fall back to the snapshot mid, then the snapshot mark.
price: prices.get(row.coin) ?? row.midPx ?? row.markPx,
}));
```
Refresh `webData2` on a slow interval of 30 to 60 seconds for the fields the tape can't
give you (open interest, funding, 24-hour volume), and let the stream carry price.
## 3. Add a live order book
`l2Book` is available over both REST and WebSocket. For a live book, subscribe:
a polling loop costs a request per tick and still lags.
```javascript theme={null}
ws.send(
JSON.stringify({ method: "subscribe", subscription: { type: "l2Book", coin: "BTC" } }),
);
```
The `coin` field accepts a single asset (`"BTC"`) or an array (`["BTC", "ETH"]`).
Omitting it streams every asset, at **50 credits per minute** rather than 0.5 per coin.
Only take the wildcard if you genuinely need all 200-plus books.
```json theme={null}
{
"channel": "l2Book",
"data": {
"coin": "BTC",
"time": 1753660812345,
"levels": [
[{ "px": "62149.0", "sz": "1.24", "n": 5 }],
[{ "px": "62151.0", "sz": "0.87", "n": 3 }]
]
}
}
```
`levels` is a two-element array, **`[bids, asks]`**, each sorted best-first. So
`levels[0][0]` is the highest bid and `levels[1][0]` is the lowest ask. Each level
carries `px` (price), `sz` (total size at that price) and `n` (number of orders).
Cumulative depth, for a depth chart or a ladder:
```javascript theme={null}
function cumulativeDepth(levels) {
let cum = 0;
return levels.map((l) => {
const sz = Number(l.sz);
cum += sz;
return { px: Number(l.px), sz, n: l.n, cum };
});
}
const [bids, asks] = book.levels;
const bidDepth = cumulativeDepth(bids);
const askDepth = cumulativeDepth(asks);
const spread = Number(asks[0].px) - Number(bids[0].px);
const midPrice = (Number(asks[0].px) + Number(bids[0].px)) / 2;
```
If you're rendering a book for one coin at a time, unsubscribe from the previous coin
when the user switches. Subscriptions are billed per minute and matched for unsubscribe
by exact body, so leaving old ones open is a slow, silent cost leak.
For a high-frequency book you can subscribe to `l2BookDiff` instead: a full snapshot
first, then per-block changed levels only, at a fifth the cost. You maintain the book
locally, replacing each level and deleting it when `sz` is `"0"`. See the
[WebSocket guide](/guides/quickstart-guides/hyperliquid-websocket-guide) for the
snapshot/diff handling.
## 4. Add the trade tape
You already have the subscription (`allFills`, opened for the price store), so the tape
costs nothing extra. Same `[address, fill]` tuple envelope as `userFills`:
```javascript theme={null}
const MAX_TAPE_ROWS = 200;
const tape = [];
ws.on("message", (raw) => {
const msg = JSON.parse(raw.toString());
if (msg.channel !== "allFills" || !Array.isArray(msg.fills)) return;
for (const [address, fill] of msg.fills) {
if (!fill?.coin || !fill.px) continue;
tape.unshift({
address,
coin: fill.coin,
side: fill.side === "B" ? "buy" : "sell",
px: Number(fill.px),
sz: Number(fill.sz),
notional: Math.abs(Number(fill.px) * Number(fill.sz)),
time: fill.time,
});
}
tape.length = Math.min(tape.length, MAX_TAPE_ROWS);
});
```
The `address` half of each tuple is what makes this more than a price ticker: it links
each fill to a trader, so a "largest fills" view doubles as trader discovery. Click
through to the [wallet tracker](/guides/hyperliquid/analytics-dashboard/wallet-tracker)
for whoever just moved size.
```javascript theme={null}
// Whale tape: only fills above a notional threshold.
const whaleFills = tape.filter((f) => f.notional >= 100_000);
```
`allFills` carries the entire venue, with thousands of events per minute in active
markets. Cap your buffer (as above), and never re-render per message. Accumulate
into an array and flush to the UI on a timer.
## Next
[Leaderboard](/guides/hyperliquid/analytics-dashboard/leaderboard) ranks traders using
batch reads plus the same `allFills` stream.
# Build a Hyperliquid Analytics Dashboard
Source: https://docs.uniblock.dev/guides/hyperliquid/analytics-dashboard/overview
Build a four-surface Hyperliquid analytics dashboard on Uniblock's Info API and WebSocket feed: wallet tracking, PnL, market data, and leaderboards.
This series walks through building a **Hyperliquid analytics dashboard** on Uniblock: a
wallet tracker, per-trader PnL analytics, a live market and order book explorer, and a
trader leaderboard. Each page is self-contained, but they build in order, and the wallet
tracker introduces the patterns the others reuse.
Everything here runs on two Uniblock surfaces:
* The [**Hyperliquid Info API**](/guides/hyperliquid/info-api/overview), a
`POST /uni/v1/hyperliquid/info` dispatch endpoint where the body's `type` field
selects the operation.
* The [**GoldRush WebSocket**](/guides/hyperliquid/websockets/overview) at
`wss://websocket.uniblock.dev/goldrush`, for order books and live fill streams.
Create your project and grab your API key from the
[Uniblock dashboard](https://dashboard.uniblock.dev). New to Hyperliquid's
architecture? Read [HyperCore vs. HyperEVM](/guides/quickstart-guides/hypercore-vs-hyperevm)
first. This series is entirely HyperCore (the native order book), not the EVM side.
## What you'll build
| Surface | Answers | Page |
| --------------- | ----------------------------------------------- | -------------------------------------------------------------------------- |
| Wallet tracker | What does this address hold right now? | [Wallet tracker](/guides/hyperliquid/analytics-dashboard/wallet-tracker) |
| PnL analytics | How has this address performed over time? | [PnL analytics](/guides/hyperliquid/analytics-dashboard/pnl) |
| Market explorer | What's happening across the venue right now? | [Market explorer](/guides/hyperliquid/analytics-dashboard/market-explorer) |
| Leaderboard | Who's winning, out of the traders I care about? | [Leaderboard](/guides/hyperliquid/analytics-dashboard/leaderboard) |
## Architecture: put a proxy in front
Your API key must never reach the browser. For the REST side that's a familiar rule. For
the WebSocket side it's a hard constraint: **browsers cannot set headers on a WebSocket
handshake**, so browser code physically cannot authenticate to
`wss://websocket.uniblock.dev/goldrush` with an `X-API-KEY` header. A small server-side
bridge isn't a stylistic preference here; it's the only way to open the stream from a
web app at all.
The whole server is about forty lines: forward Info request bodies verbatim, and pipe
WebSocket frames in both directions.
```javascript theme={null}
import { createServer } from "node:http";
import { WebSocketServer, WebSocket } from "ws";
const API_KEY = process.env.UNIBLOCK_API_KEY;
const INFO_URL = "https://api.uniblock.dev/uni/v1/hyperliquid/info";
const WSS_URL = "wss://websocket.uniblock.dev/goldrush";
// --- REST: forward the body verbatim, inject the key ---
const server = createServer(async (req, res) => {
if (req.method !== "POST" || !req.url.startsWith("/api/info")) {
res.writeHead(404).end();
return;
}
const url = new URL(req.url, "http://localhost");
const upstream = new URL(INFO_URL);
upstream.searchParams.set("chainId", url.searchParams.get("chainId") ?? "999");
// Let the client pin a provider when it needs one (see below).
const provider = url.searchParams.get("provider");
if (provider) upstream.searchParams.set("provider", provider);
const chunks = [];
for await (const chunk of req) chunks.push(chunk);
const r = await fetch(upstream, {
method: "POST",
headers: { "X-API-KEY": API_KEY, "content-type": "application/json" },
body: Buffer.concat(chunks),
});
res.writeHead(r.status, { "content-type": "application/json" });
res.end(Buffer.from(await r.arrayBuffer()));
});
// --- WebSocket: bridge browser <-> Uniblock, inject the key ---
const wss = new WebSocketServer({ noServer: true });
server.on("upgrade", (req, socket, head) => {
if (new URL(req.url, "http://localhost").pathname !== "/ws") return socket.destroy();
wss.handleUpgrade(req, socket, head, (client) => {
const upstream = new WebSocket(WSS_URL, { headers: { "X-API-KEY": API_KEY } });
const pending = [];
// The browser may subscribe before the upstream socket is open, so buffer until then.
upstream.on("open", () => {
for (const msg of pending) upstream.send(msg);
pending.length = 0;
});
upstream.on("message", (data) => {
if (client.readyState === WebSocket.OPEN) client.send(data);
});
client.on("message", (data) => {
const msg = data.toString();
if (upstream.readyState === WebSocket.OPEN) upstream.send(msg);
else pending.push(msg);
});
const closeBoth = () => {
client.close();
upstream.close();
};
client.on("close", closeBoth);
upstream.on("close", closeBoth);
upstream.on("error", closeBoth);
});
});
server.listen(8787);
```
Every REST example in this series calls `POST /api/info` against that proxy. To keep the
snippets readable, they all assume this helper:
```javascript theme={null}
async function info(body, opts = {}) {
const qs = new URLSearchParams({ chainId: "999", ...opts });
const res = await fetch(`/api/info?${qs}`, {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify(body),
});
if (!res.ok) throw new Error(`info ${body.type} failed: ${res.status}`);
return res.json();
}
```
## Two conventions that apply everywhere
### Numbers arrive as decimal strings
Hyperliquid returns almost every number as a string: `"1234.5"`, not `1234.5`. This is
deliberate: it preserves exact decimal precision that IEEE-754 floats would lose. Keep
values as strings while you carry them around, and convert only at the point you do
display math:
```javascript theme={null}
// Wrong. String concatenation, not addition: "7500.00" + "42.10" === "7500.0042.10"
const wrong = position.positionValue + position.unrealizedPnl;
// Right. Convert at the edge, where you're formatting
const right = Number(position.positionValue) + Number(position.unrealizedPnl);
```
### `chainId` selects the network
`999` is Hyperliquid mainnet (the default), `998` is testnet. Every example here uses
mainnet.
## Which provider serves what
Uniblock routes each Info request through a provider waterfall: Alchemy, Dwellir,
Chainstack, GoldRush, in that priority order. **Different providers serve different Info
types**, and that has a practical consequence: the historical and market-data types this
series leans on are served by GoldRush alone.
| Info `type` | Alchemy | Dwellir | Chainstack | GoldRush | Used by |
| ------------------------ | :-----: | :-----: | :--------: | :------: | ------------------- |
| `portfolioState` | ✓ | ✓ | ✓ | ✓ | Wallet, Leaderboard |
| `batchPortfolioStates` | ✓ | ✓ | ✓ | ✓ | Leaderboard |
| `clearinghouseState` | ✓ | ✓ | ✓ | ✓ | Wallet |
| `spotClearinghouseState` | ✓ | ✓ | ✓ | ✓ | Wallet |
| `openOrders` | ✓ | ✓ | ✓ | ✗ | Wallet |
| `frontendOpenOrders` | ✓ | ✓ | ✓ | ✓ | Wallet |
| `meta` | ✓ | ✓ | ✓ | ✓ | Market explorer |
| `webData2` | ✓ | ✗ | ✓ | ✓ | Market explorer |
| `allMids` | ✗ | ✗ | ✗ | ✓ | Market explorer |
| `l2Book` | ✗ | ✗ | ✗ | ✓ | Market explorer |
| `candleSnapshot` | ✗ | ✗ | ✗ | ✓ | PnL |
| `userFills` | ✗ | ✗ | ✗ | ✓ | Wallet, PnL |
| `userFillsByTime` | ✗ | ✗ | ✗ | ✓ | PnL |
| `userFunding` | ✗ | ✗ | ✗ | ✓ | PnL |
You don't normally need to act on this, because the waterfall automatically picks a
provider that serves your `type`. It matters in two situations:
* **Debugging.** If a response looks wrong, pinning `?provider=` lets you compare
providers directly and find out whether you're looking at a routing artifact or real
data.
* **Consistency.** If you want two related reads to come from the same source, pin both.
`openOrders` is the one asymmetry worth remembering: GoldRush serves
`frontendOpenOrders` but not `openOrders`. If you want your open-orders read to
survive a failover to GoldRush, use `frontendOpenOrders`. It returns the same orders
with extra frontend metadata.
## Cost model
Two meters run, and they behave differently.
**REST is billed per request.** A batch type multiplies: `batchPortfolioStates` over 50
addresses is billed as 50 lookups, not one. That's still far cheaper than 50 separate
requests, but it isn't free.
**WebSocket is billed per subscription-minute**, and the rate depends on the channel:
| Channel | Rate | Wildcard (no `coin`) |
| -------------------------------------------------------------------------------------- | ---------------------------- | --------------------- |
| `l2Book` | 0.5 / coin / min | 50 / min (all assets) |
| `l2BookDiff` | 0.1 / coin / min | 10 / min (all assets) |
| `l4Book` | 2 / coin / min (**BTC: 20**) | not supported |
| `allFills`, `userFills`, `orderUpdates`, `builderFills`, `userNonFundingLedgerUpdates` | 1 / min | n/a |
The shape of that table is the whole argument for scoping your subscriptions:
subscribing to `l2Book` for three coins costs 1.5/min; omitting `coin` to get all of them
costs 50/min, over thirty times more for data you'll mostly discard.
The general rule that follows: **prefer one WebSocket subscription over a polling loop.**
A stream you hold open for an hour costs 60 units; polling the same data every two
seconds costs 1,800 requests. Where you must poll, poll slowly and back off on `429`.
Routing through Uniblock removes Hyperliquid's per-IP request-weight cap, but your
plan's rate limits still apply, and bursts return `429`. See
[Rate limits, caching & polling](/guides/hyperliquid/info-api/limits).
## Next
Start with the [wallet tracker](/guides/hyperliquid/analytics-dashboard/wallet-tracker):
it introduces account state, live prices, and your first WebSocket subscription.
# Hyperliquid PnL analytics: realized PnL, fees, and win rate
Source: https://docs.uniblock.dev/guides/hyperliquid/analytics-dashboard/pnl
Derive realized PnL, fees, funding, win rate, and per-coin breakdowns for any Hyperliquid address from its fill history on Uniblock.
Hyperliquid doesn't hand you a PnL curve; it hands you fills. Every fill that reduces a
position carries the profit or loss that closing it realized, so a trader's whole
performance history is derivable from `userFillsByTime` plus `userFunding`.
This page builds the derivation: realized PnL over time, fees, funding, win rate, volume,
and a per-coin breakdown.
`userFills`, `userFillsByTime`, `userFunding`, and `candleSnapshot` are all served by
GoldRush. The waterfall routes to it automatically, so you only need
`?provider=goldrush` if you're pinning for consistency or debugging.
## 1. Fetch the fill history
`userFillsByTime` takes a millisecond-epoch window. `endTime` is optional and defaults to
now.
```javascript theme={null}
const now = Date.now();
const startTime = now - 30 * 24 * 60 * 60 * 1000; // last 30 days
const fills = await info({ type: "userFillsByTime", user: address, startTime });
```
Each fill carries everything the derivation needs:
```json theme={null}
{
"coin": "ETH",
"px": "2410.5",
"sz": "1.5",
"side": "A",
"time": 1753660812345,
"startPosition": "1.5",
"dir": "Close Long",
"closedPnl": "128.40",
"hash": "0x...",
"oid": 88123456,
"fee": "1.81",
"tid": 445566778899
}
```
The two load-bearing fields:
* **`closedPnl`** is the realized profit or loss from the portion of the position that
this fill closed. It's `"0.0"` on fills that only *open* or *increase* a position,
because nothing was realized. Only closing fills carry a non-zero value.
* **`fee`** is what you paid to trade, always positive, and always deducted. A negative
fee (a maker rebate) appears as a negative value, which the arithmetic below handles
without a special case.
### Handling the 2000-fill cap
Hyperliquid caps a fills response at **2000 rows**, keeping the most recent. For an
active trader over a long window, that's a truncated view, and nothing in the response
tells you it happened. You have to infer it:
```javascript theme={null}
const FILL_CAP = 2000;
const truncated = fills.length >= FILL_CAP;
```
To reconstruct a full history, page backwards: fetch a window, and if you hit the cap,
fetch again ending just before the oldest fill you received.
```javascript theme={null}
// Not every fill is backed by a real trade. Synthetic fills (spot dust conversions
// are the common case) carry `tid: 0` and a zero `hash`, so one account can hold
// dozens of distinct fills sharing both. Compose the key from fields that stay
// distinct across them.
const fillKey = (f) => `${f.tid}:${f.oid}:${f.time}:${f.coin}`;
async function fetchAllFills(address, startTime) {
const all = [];
let endTime = Date.now();
while (true) {
const page = await info({ type: "userFillsByTime", user: address, startTime, endTime });
if (page.length === 0) break;
all.push(...page);
if (page.length < FILL_CAP) break; // partial page, so we've reached the start
// Step back to just before the oldest fill in this page.
const oldest = Math.min(...page.map((f) => f.time));
if (oldest <= startTime) break;
endTime = oldest - 1;
}
// Pages can overlap at boundaries, so de-duplicate, but not on `tid` alone.
return [...new Map(all.map((f) => [fillKey(f), f])).values()];
}
```
Don't de-duplicate on `tid` by itself. It's a *trade* id, and fills that aren't trades
don't have one. A spot dust conversion is emitted with `tid: 0` and
`hash: "0x000…0"`. Key a map on `tid` and an account with 42 dust conversions collapses
to a single row, quietly undercounting volume, fill count, and per-coin activity.
Each page is a billed request, so an unbounded backfill over a very active address can
be expensive. Bound the loop: cap the number of pages, or show the truncated window
with a "showing the most recent 2000 fills" note and let the user opt in to the full
history.
## 2. Derive the numbers
With the fills in hand, everything else is arithmetic. Sort oldest-first, walk once, and
accumulate.
```javascript theme={null}
// Does this fill reduce or flip exposure? `dir` is Hyperliquid's own description of
// what the fill did to the position, so read it rather than inferring from PnL.
// "Open Long" / "Open Short" → adds exposure
// "Close Long" / "Close Short" → reduces it
// "Long > Short" / "Short > Long" → flips it (closes, then reopens)
// "Liquidated …" / "Auto-Deleveraged …" → closed involuntarily
// "Spot Dust Conversion", "Buy", "Sell" → spot, no perp exposure at all
function isClosingFill(f) {
const dir = f.dir ?? "";
return dir.includes("Close") || dir.includes(">") || /^(Liquidated|Auto-Deleveraged)/.test(dir);
}
function derivePnl(fills) {
const asc = [...fills].sort((a, b) => a.time - b.time);
const series = []; // cumulative realized PnL, one point per fill
const coins = new Map(); // per-coin breakdown
let cumulative = 0;
let fees = 0;
let volume = 0;
let closingFills = 0;
let wins = 0;
for (const f of asc) {
const closedPnl = Number(f.closedPnl);
const fee = Number(f.fee);
const notional = Math.abs(Number(f.px) * Number(f.sz));
cumulative += closedPnl - fee;
fees += fee;
volume += notional;
// Win rate counts only fills that closed exposure. Opening fills must not enter
// the denominator, since including them would tank the rate for everyone.
if (isClosingFill(f)) {
closingFills++;
if (closedPnl > 0) wins++;
}
series.push({ time: f.time, value: cumulative });
const row = coins.get(f.coin) ?? { coin: f.coin, realizedPnl: 0, volume: 0, fills: 0 };
row.realizedPnl += closedPnl - fee;
row.volume += notional;
row.fills++;
coins.set(f.coin, row);
}
return {
series,
realizedPnl: cumulative,
fees,
volume,
totalFills: asc.length,
closingFills,
winRate: closingFills > 0 ? wins / closingFills : null,
byCoin: [...coins.values()].sort((a, b) => b.volume - a.volume),
truncated: asc.length >= 2000,
};
}
```
Three definitions in that function are worth stating explicitly, because they're the ones
people get wrong:
**Realized PnL is net of fees.** `Σ(closedPnl − fee)`. Hyperliquid's `closedPnl` is
gross, so it doesn't deduct what you paid to trade. Report gross PnL as "realized PnL" and
your numbers will consistently overstate performance, by more the more actively the
address trades.
**Volume is notional, `Σ|px × sz|`.** The absolute value matters: `sz` can be negative
depending on direction, and a trader's volume is a magnitude, not a signed quantity.
**Win rate is wins ÷ *closing* fills**, not wins ÷ all fills. Every position takes at
least one opening fill that realizes nothing, so dividing by the total fill count
silently halves the win rate of anyone who opens and closes in single fills, and
distorts it unpredictably for everyone else.
Get the denominator from `dir`, not from `closedPnl`. The tempting shortcut ("a closing
fill is one where `closedPnl ≠ 0`") is wrong in both directions. A position closed
exactly at its entry price realizes nothing and would be dropped from the denominator,
inflating the win rate of anyone who scratches trades. And a spot dust conversion also
carries `closedPnl: 0` despite touching no perp position at all. `dir` states what the
fill actually did, so it answers the question directly.
This derivation covers **realized** PnL only: settled facts from closed positions.
It deliberately excludes unrealized PnL on positions still open. If your dashboard
shows a combined figure, compute the unrealized half separately from live positions
and mids (see the
[wallet tracker](/guides/hyperliquid/analytics-dashboard/wallet-tracker#4-keep-mid-prices-live)),
and label the two clearly. Mixing them into one number produces a figure that jumps
around with the market and reconciles against nothing.
## 3. Add funding
Perp traders pay or receive funding continuously, and over a long holding period it can
dominate trading PnL. It's a separate ledger from fills:
```javascript theme={null}
const funding = await info({ type: "userFunding", user: address, startTime });
```
```json theme={null}
[
{
"time": 1753660800000,
"hash": "0x...",
"delta": {
"type": "funding",
"coin": "BTC",
"usdc": "-0.42",
"szi": "0.12",
"fundingRate": "0.0000125"
}
}
]
```
`delta.usdc` is **signed**: negative is funding you paid, positive is funding you
received. So the accumulation is a plain sum, no sign flip:
```javascript theme={null}
function deriveFunding(updates) {
const asc = [...updates].sort((a, b) => a.time - b.time);
const series = [];
let net = 0;
for (const u of asc) {
net += Number(u.delta.usdc); // + received, − paid
series.push({ time: u.time, value: net });
}
return { series, net };
}
```
Keep funding on its own line rather than folding it into realized PnL. They answer
different questions (one is trading skill, the other is carry cost) and a trader whose
strategy is profitable but whose funding bill exceeds it needs to see both.
## 4. Add price context
A PnL curve is easier to read against the market it was earned in. `candleSnapshot`
supplies the backdrop.
This is the one type in the series with a **nested request body**. Its parameters go
inside a `req` object rather than at the top level:
```javascript theme={null}
const candles = await info({
type: "candleSnapshot",
req: { coin: "BTC", interval: "1h", startTime, endTime: Date.now() },
});
```
```json theme={null}
[
{
"t": 1753657200000,
"T": 1753660799999,
"s": "BTC",
"i": "1h",
"o": "62010.0",
"c": "62150.0",
"h": "62300.0",
"l": "61890.0",
"v": "142.85",
"n": 3218
}
]
```
Candles arrive oldest-first. The keys are terse: `t` open time, `T` close time, `s`
coin, `i` interval, `o`/`h`/`l`/`c` the OHLC prices, `v` volume, `n` trade count.
Match the interval to the window so the chart stays readable rather than returning
thousands of points:
```javascript theme={null}
function intervalForWindow(days) {
return days <= 7 ? "1h" : days <= 30 ? "4h" : "1d";
}
```
## 5. Assemble the surface
```javascript theme={null}
async function loadPnl(address, days) {
const startTime = Date.now() - days * 24 * 60 * 60 * 1000;
const [fills, funding] = await Promise.all([
info({ type: "userFillsByTime", user: address, startTime }),
info({ type: "userFunding", user: address, startTime }),
]);
const pnl = derivePnl(fills);
const fundingDerivation = deriveFunding(funding);
return {
...pnl,
funding: fundingDerivation,
net: pnl.realizedPnl + fundingDerivation.net,
};
}
```
A reasonable set of headline tiles from that: **realized PnL** (net of fees),
**funding**, **fees paid**, **volume**, **win rate**, and **fill count**, with the
cumulative `series` as the chart and `byCoin` as a sortable table underneath.
Surface `truncated` in the UI. A user comparing a 90-day figure against their own
records will otherwise conclude your numbers are wrong, when in fact the window was
capped. One line, "showing the most recent 2000 fills", turns a bug report into
understood behavior.
## Next
[Market explorer](/guides/hyperliquid/analytics-dashboard/market-explorer) moves from
one address to the whole venue.
# Hyperliquid wallet tracker: positions, balances, live fills
Source: https://docs.uniblock.dev/guides/hyperliquid/analytics-dashboard/wallet-tracker
Build a Hyperliquid wallet tracker that shows perp positions, spot balances, open orders, live unrealized PnL, and a real-time fill feed for any address.
The wallet tracker answers *what does this address hold right now?*: open perp
positions with entry, mark, and liquidation prices, spot balances, resting orders, and a
live fill feed that ticks as the address trades.
This page introduces three patterns the rest of the series reuses: reading account state,
maintaining a live mid-price store, and subscribing to a user-scoped WebSocket channel.
All examples use the `info()` helper and the key-holding proxy from the
[series overview](/guides/hyperliquid/analytics-dashboard/overview).
## 1. Read account state
You have two options, and the choice is about how much normalization you want.
**`portfolioState`** is a Uniblock synthetic type: one call returns perps, spot, and
account-abstraction mode composed into a single object, with each section isolated so a
failure in one doesn't take down the others.
```javascript theme={null}
const portfolio = await info({ type: "portfolioState", user: address });
// {
// type: "portfolioState",
// address: "0x...",
// chainId: 999,
// perpetuals: { marginSummary, assetPositions, withdrawable, ... } | null,
// spot: { balances: [...] } | null
// }
```
Note that `perpetuals` and `spot` are **nullable**. A section that failed upstream comes
back `null` rather than throwing, so guard before you read into it.
**`clearinghouseState`** and **`spotClearinghouseState`** are the native Hyperliquid
reads, if you'd rather compose them yourself:
```javascript theme={null}
const [perps, spot] = await Promise.all([
info({ type: "clearinghouseState", user: address }),
info({ type: "spotClearinghouseState", user: address }),
]);
```
Either way, the perp payload has the same shape:
```json theme={null}
{
"marginSummary": {
"accountValue": "1250.44",
"totalNtlPos": "8300.10",
"totalRawUsd": "1250.44",
"totalMarginUsed": "415.00"
},
"crossMarginSummary": { "...": "same fields" },
"crossMaintenanceMarginUsed": "83.00",
"withdrawable": "835.44",
"assetPositions": [
{
"type": "oneWay",
"position": {
"coin": "BTC",
"szi": "0.12",
"entryPx": "62150.0",
"positionValue": "7500.00",
"unrealizedPnl": "42.10",
"returnOnEquity": "0.0562",
"liquidationPx": "48120.5",
"leverage": { "type": "cross", "value": 10 },
"marginUsed": "750.00"
}
}
],
"time": 1753660800000
}
```
**`marginSummary.accountValue` is perps margin only: it does not include vault
equity.** A wallet with a large vault stake can show a small `accountValue` here while
actually holding far more. Rendering this field alone as "Account Value" or "Total
Value" understates such wallets, sometimes by orders of magnitude.
Join it with `userVaultEquities` (one extra Info call per wallet), which returns the
wallet's vault deposits as vault-address/equity pairs. Fetch the two independently so a
failure in one doesn't take down the other, because `Promise.all` rejects the whole pair the
moment either call throws, which is exactly the failure case you're trying to degrade
gracefully from:
```javascript theme={null}
const [perps, vaultEquities] = await Promise.all([
info({ type: "clearinghouseState", user: address }).catch(() => null),
info({ type: "userVaultEquities", user: address }).catch(() => null),
]);
function toFiniteNumber(value) {
if (value === null || value === undefined) return null;
const trimmed = String(value).trim();
if (trimmed === "") return null; // Number(" ") is 0, so whitespace is blank too
const parsed = Number(trimmed);
return Number.isFinite(parsed) ? parsed : null;
}
// Blank or unparseable accountValue is unknown, not $0. Number("") is 0, and
// rendering that as a real figure is the same species of lie as the missing vault leg.
const perpsMargin = perps ? toFiniteNumber(perps.marginSummary.accountValue) : null;
let unweighed = 0;
const vaultEquity = vaultEquities === null
? null // the vault call itself failed; don't fold that into a silent 0
: vaultEquities.reduce((sum, v) => {
const equity = toFiniteNumber(v.equity);
if (equity === null) unweighed++; // counted, not silently dropped; see below
return sum + (equity ?? 0);
}, 0);
const knownValue = perpsMargin === null || vaultEquity === null
? null
: perpsMargin + vaultEquity;
```
**Don't call this a total, and don't stop at two of three buckets.** Perps margin +
vault equity still leaves out spot balances, and `spotClearinghouseState` gives you a cost
basis (`entryNtl`), not a mark price, so valuing spot needs `spotMeta` and spot mids on
top. Naming the perps+vault sum "Total Value" just moves the same understatement to a
different set of wallets (spot-heavy ones instead of vault-heavy ones). Call the field
something honest about its scope, such as `knownValue` or "Perps + Vaults", until spot is
actually priced in.
Two honesty rules matter more than the arithmetic:
* if the vault call **failed** outright, treat the contribution as `null`, not `0`. A
figure that silently falls back to perps-only margin looks complete but understates
the wallet exactly as before.
* a single stake whose `equity` string doesn't parse (`unweighed` above) is different
from a failed call: the call succeeded, one entry just isn't numeric. Counting it as
0 keeps `knownValue` a **floor** rather than discarding the whole scan over one bad
entry, but the UI must say so: show a `(floor)` qualifier whenever `unweighed > 0`,
so the figure never reads as complete when it isn't.
That gives three display states, not two:
* `perpsMargin` and `vaultEquity` both known → render the combined figure **and** a
labelled **Perps Margin** tile side by side. Collapsing them into one number loses
the perps-only figure some readers specifically want.
* `perpsMargin` known, `vaultEquity` `null` → render **only** the Perps Margin tile,
noting the vault call failed. There is no combined figure to show.
* `perps` is `null` → render neither metric; report that the perps request failed.
* `perps` is available but `perpsMargin` is `null` (blank or unparseable
`accountValue`) → render neither metric; report the value as unavailable. This is a
data-quality gap, not a request failure, so don't word it as one.
## 2. Render the positions table
Positions live one level down, under `assetPositions[].position`. The field that trips
people up is `szi`, which is the **signed** position size, so its sign is what tells you
long from short. There is no `side` field.
```javascript theme={null}
const positions = (perps?.assetPositions ?? []).map(({ position: p }) => ({
coin: p.coin,
side: Number(p.szi) > 0 ? "long" : "short",
size: Math.abs(Number(p.szi)),
entryPx: Number(p.entryPx),
// null for a cross-margin position that can't be individually liquidated
liquidationPx: p.liquidationPx === null ? null : Number(p.liquidationPx),
leverage: `${p.leverage.value}x ${p.leverage.type}`,
marginUsed: Number(p.marginUsed),
unrealizedPnl: Number(p.unrealizedPnl),
}));
```
`liquidationPx` is legitimately `null` for some positions. Cross-margin positions
don't each have their own liquidation price, since the whole account is collateral.
Render a dash, not a zero.
Spot balances are flatter:
```javascript theme={null}
const balances = (spot?.balances ?? []).map((b) => ({
coin: b.coin,
total: Number(b.total),
available: Number(b.total) - Number(b.hold), // `hold` is locked in resting orders
entryNtl: Number(b.entryNtl),
}));
```
## 3. Show open orders
```javascript theme={null}
const orders = await info({ type: "frontendOpenOrders", user: address });
// [{ coin, side, limitPx, sz, oid, timestamp, origSz, cloid? }]
```
`side` is `"B"` for bid (buy) and `"A"` for ask (sell), Hyperliquid's convention
throughout, in fills as well as orders. `sz` is what's left unfilled; `origSz` is what
the order was placed for, so `origSz - sz` is the filled portion.
Use `frontendOpenOrders` rather than `openOrders` unless you have a reason not to. Both
return the same resting orders, but `frontendOpenOrders` adds order-type and trigger
metadata, and it's served by all four providers, whereas `openOrders` is not served by
GoldRush. If your request fails over to GoldRush, `frontendOpenOrders` keeps working.
## 4. Keep mid prices live
Positions are only half the picture: `unrealizedPnl` in the snapshot was true at
`time`, and it drifts the moment the market moves. To keep it live you need a current
mark for each coin.
**There is no `allMids` WebSocket channel.** This is the single most common wrong
assumption when building on this stack: the REST type exists, so people look for the
matching stream and don't find one. The working pattern is a hybrid:
* **Seed and correct** from REST `allMids` on a slow interval (30 seconds is plenty).
* **Update tick-by-tick** from the `allFills` WebSocket channel, taking each fill's price
as the latest trade price for its coin.
```javascript theme={null}
const prices = new Map();
// Seed from REST, and re-seed slowly to correct any drift.
async function seedPrices() {
const mids = await info({ type: "allMids" }); // { "BTC": "62150.0", "ETH": "2410.5", ... }
for (const [coin, px] of Object.entries(mids)) prices.set(coin, Number(px));
}
await seedPrices();
setInterval(seedPrices, 30_000);
// Update from the live trade stream.
ws.send(JSON.stringify({ method: "subscribe", subscription: { type: "allFills" } }));
ws.on("message", (raw) => {
const msg = JSON.parse(raw.toString());
if (msg.channel !== "allFills") return;
for (const [, fill] of msg.fills) {
if (fill?.coin && fill.px) prices.set(fill.coin, Number(fill.px));
}
});
```
Two things to note about that subscription, both covered in full in the next section:
`allFills` needs no parameters (it's the whole venue), and its payload arrives as
`[address, fill]` **tuples**, which is why the loop destructures past the address.
`allFills` is a busy stream, with thousands of events a minute at peak. Don't
re-render on every message. Batch price updates and flush on a timer (250ms works
well) so a busy market doesn't pin your UI thread.
With a live price map, unrealized PnL becomes a derivation rather than a fetch:
```javascript theme={null}
function liveUnrealizedPnl(positions) {
return positions.reduce((sum, p) => {
const mid = prices.get(p.coin);
// Fall back to the snapshot value until the first price for that coin arrives.
if (mid === undefined) return sum + Number(p.unrealizedPnl);
return sum + Number(p.szi) * (mid - Number(p.entryPx));
}, 0);
}
```
Because `szi` is signed, that one expression is correct for both directions: a short has
negative `szi`, so a falling price yields a positive product.
## 5. Stream this wallet's fills
Finally, subscribe to the address's own fills for a live activity feed.
```javascript theme={null}
ws.send(
JSON.stringify({
method: "subscribe",
subscription: { type: "userFills", addresses: [address] },
}),
);
```
**`userFills` takes `addresses: string[]`, not `user: string`.** This diverges from
Hyperliquid's native WebSocket contract, and it fails quietly: send the native
`{ type: "userFills", user: "0x..." }` form and the subscription is accepted but never
delivers anything. The same applies to `orderUpdates`. If a user-scoped stream is
silent, check this first.
The payload diverges too. Fills arrive as **`[address, fill]` tuples** under a `fills`
key, not in Hyperliquid's native `{ data: { user, fills } }` envelope:
```json theme={null}
{
"channel": "userFills",
"fills": [
[
"0xabc...",
{
"coin": "BTC",
"px": "62180.0",
"sz": "0.02",
"side": "B",
"time": 1753660812345,
"startPosition": "0.10",
"dir": "Open Long",
"closedPnl": "0.0",
"hash": "0x...",
"oid": 88123456,
"fee": "0.37",
"tid": 445566778899
}
]
]
}
```
Because `allFills` and `userFills` share that envelope, one parser handles both:
```javascript theme={null}
function parseFillTuples(msg) {
if (!Array.isArray(msg.fills)) return [];
return msg.fills.filter(([address, fill]) => typeof address === "string" && fill?.coin);
}
ws.on("message", (raw) => {
const msg = JSON.parse(raw.toString());
if (msg.channel !== "userFills") return;
for (const [, fill] of parseFillTuples(msg)) {
feed.unshift({
coin: fill.coin,
side: fill.side === "B" ? "buy" : "sell",
px: Number(fill.px),
sz: Number(fill.sz),
// Human-readable already: "Open Long", "Close Short", "Long > Short", …
dir: fill.dir,
pnl: Number(fill.closedPnl),
time: fill.time,
});
}
});
```
The `dir` field is worth surfacing directly in the feed. It is a pre-formatted
description of what the fill did to the position, which saves you inferring it from
`startPosition` and `szi`.
Subscriptions are matched for unsubscribe by their **exact** body. Send
`{ method: "unsubscribe", subscription: { type: "userFills", addresses: [address] } }`
with the identical `addresses` array you subscribed with, or the subscription (and its
per-minute billing) stays open. When a user switches wallets, unsubscribe the old
address before subscribing the new one.
## Reconnecting
The stream will drop. Handle it with exponential backoff, and re-send every active
subscription on reconnect, because the server keeps no state across connections:
```javascript theme={null}
let retry = 0;
function connect() {
const ws = new WebSocket("ws://localhost:8787/ws");
ws.on("open", () => {
retry = 0;
for (const sub of activeSubscriptions) {
ws.send(JSON.stringify({ method: "subscribe", subscription: sub }));
}
});
ws.on("close", () => {
setTimeout(connect, Math.min(15_000, 500 * 2 ** retry++));
});
return ws;
}
```
## Next
The wallet tracker shows the present. Next,
[PnL analytics](/guides/hyperliquid/analytics-dashboard/pnl) reconstructs the past from
fill history.
# Hyperliquid EVM Overview
Source: https://docs.uniblock.dev/guides/hyperliquid/evm/overview
Standard JSON-RPC access to HyperEVM (chain 999, testnet 998) through Uniblock: read state, send transactions, and call contracts with familiar EVM tooling.
**HyperEVM** is Hyperliquid's EVM-compatible chain: the layer where you deploy standard Solidity contracts and interact with Hyperliquid using the same JSON-RPC methods you'd use on any other EVM chain. Uniblock exposes HyperEVM through its unified JSON-RPC endpoint, so you get low-latency routing and automatic provider failover behind one API key.
HyperEVM is the permissionless, contract-programmable half of Hyperliquid.
HyperCore (the native order book) is reached through the
[Info API](/guides/hyperliquid/info-api/overview) and
[WebSockets](/guides/hyperliquid/websockets/overview) instead. See
[HyperCore vs. HyperEVM](/guides/quickstart-guides/hypercore-vs-hyperevm).
## Endpoint
Send a `POST` request to the unified JSON-RPC endpoint with the chain ID in the query string:
```plaintext theme={null}
https://api.uniblock.dev/uni/v1/json-rpc?chainId=999
```
Include the JSON-RPC `method` and `params` in the request body, authenticated with your `x-api-key` header.
## Supported networks
| Network | Symbol | Type | Chain ID |
| ------------------- | ------ | ------- | -------- |
| Hyperliquid | `HYPE` | Mainnet | `999` |
| Hyperliquid Testnet | `HYPE` | Testnet | `998` |
## Method groups
HyperEVM supports the standard EVM JSON-RPC surface plus extended namespaces. Browse the full reference:
Core `eth_*` methods: blocks, balances, transactions, logs, and contract calls.
Low-level `debug_*` methods for tracing and state inspection.
`trace_*` methods for transaction and block-level execution traces.
`erigon_*` methods for header and receipt lookups.
`ots_*` methods powering block-explorer style queries.
## Next steps
Make your first HyperEVM JSON-RPC call in under two minutes.
# Query HyperEVM
Source: https://docs.uniblock.dev/guides/hyperliquid/evm/quickstart
Make your first HyperEVM JSON-RPC call on Uniblock in under two minutes with cURL, ethers.js, or viem against chain 999 mainnet or 998 testnet.
Estimated time: under two minutes. This guide assumes you already have an Uniblock project; if not, follow the [Uniblock Quickstart Guide](/guides/getting-started/uniblock-quickstart-guide) first.
Replace `YOUR_API_KEY` with the key from your
[Uniblock dashboard](https://dashboard.uniblock.dev). Use `chainId=999` for
mainnet or `998` for testnet.
## Raw JSON-RPC
Read the latest HyperEVM block number:
```bash cURL theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/json-rpc?chainId=999' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": [],
"id": 1
}'
```
```javascript JavaScript theme={null}
const res = await fetch(
"https://api.uniblock.dev/uni/v1/json-rpc?chainId=999",
{
method: "POST",
headers: {
"x-api-key": "YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
jsonrpc: "2.0",
method: "eth_blockNumber",
params: [],
id: 1,
}),
},
);
console.log(await res.json()); // { jsonrpc: "2.0", id: 1, result: "0x..." }
```
## With a standard EVM library
Because HyperEVM speaks standard JSON-RPC, point any EVM library at the Uniblock endpoint. The `x-api-key` header travels in the transport config.
```javascript viem theme={null}
import { createPublicClient, http } from "viem";
const client = createPublicClient({
transport: http("https://api.uniblock.dev/uni/v1/json-rpc?chainId=999", {
fetchOptions: { headers: { "x-api-key": "YOUR_API_KEY" } },
}),
});
console.log(await client.getBlockNumber());
```
```javascript ethers theme={null}
import { JsonRpcProvider, FetchRequest } from "ethers";
const req = new FetchRequest(
"https://api.uniblock.dev/uni/v1/json-rpc?chainId=999",
);
req.setHeader("x-api-key", "YOUR_API_KEY");
const provider = new JsonRpcProvider(req);
console.log(await provider.getBlockNumber());
```
## Next steps
* Browse every method group in the [HyperEVM overview](/guides/hyperliquid/evm/overview).
* See the full method reference in the [Hyperliquid (HYPE) JSON-RPC docs](/reference/jsonrpc/999/hyperliquid-overview).
* Need the native order book instead of the EVM layer? Use the [Info API](/guides/hyperliquid/info-api/overview) or [WebSockets](/guides/hyperliquid/websockets/overview).
***
***
Create your free account and start building with unified blockchain infrastructure across 300+ chains.
Explore all available endpoints and interactive playgrounds
# Rate Limits, Caching & Polling
Source: https://docs.uniblock.dev/guides/hyperliquid/info-api/limits
How Uniblock's Hyperliquid Info API removes the public request-weight cap, meters usage in compute units, and how to poll and cache efficiently.
Hyperliquid's public `/info` API enforces a request-weight budget per IP address, so high-frequency polling and multi-user reads quickly hit the ceiling. Routing through Uniblock removes that constraint: usage is metered in **compute units** against your project instead of throttled per IP.
Usage is billed in compute units. See
[Compute units & pricing](/reference/resources/pricing-plans) for how metering
and plans work.
## No public request-weight cap
The public API assigns each `/info` operation a weight and limits the total weight per minute per IP. Uniblock does not apply that per-IP cap. Instead:
* Requests are metered in compute units per call, not throttled by a per-IP weight budget.
* Uniblock's provider waterfall spreads load and fails over automatically, so a single provider's limits don't become yours.
This removes the *per-IP* cap; it does not make the API unlimited. Your
project still has **plan-level rate limits**: bursts above your plan's
allowance return `429`, and backup routing does not bypass them. Keep
retry/backoff logic in place. See [Rate limits](/guides/uniblock/error-codes#rate-limits).
## Poll efficiently
Without the per-IP cap you can poll harder, but do it deliberately; you're billed per request and still bound by your plan's rate limit:
* **Match your poll interval to how fast the data changes.** Order books and mark prices move every block; account state changes far less often.
* **Batch multi-user reads.** Replace one request per user with a single synthetic batch type: `batchClearinghouseStates` or `batchPortfolioStates` (up to 50 users per request). See the [Info API overview](/guides/hyperliquid/info-api/overview).
* **Stream instead of poll for order books.** If you're polling `l2Book` on a tight loop, switch to the [WebSocket `l2BookDiff` channel](/guides/hyperliquid/websockets/l2-book-diff): you get per-block updates without repeated REST calls.
## Cache read-mostly data
Some `/info` responses change rarely and are safe to cache client-side:
| Data | Typical cache window |
| ------------------------------------------- | ---------------------------- |
| `meta`, `spotMeta` (asset universe) | minutes to hours |
| `metaAndAssetCtxs` (contexts + mark prices) | seconds |
| `clearinghouseState`, `portfolioState` | seconds |
| `l2Book` | do not cache; stream instead |
Cache the slow-moving metadata once at startup and refresh it on a long interval, rather than fetching it alongside every hot read.
## Handling errors
* A body without a supported `type` returns `400` at the HTTP boundary before reaching a provider; validate your `type` client-side.
* A `429` means your project exceeded its plan-level rate limit; retry with exponential backoff and jitter, and upgrade your plan if demand is sustained.
* Transient upstream failures are retried across the provider waterfall automatically. See [Error codes](/guides/uniblock/error-codes) for the full list.
# Info API Migration Guide
Source: https://docs.uniblock.dev/guides/hyperliquid/info-api/migration
Switch from Hyperliquid's public /info API to Uniblock by changing one URL and adding your API key: request and response shapes stay identical.
Migrating from Hyperliquid's public `/info` API to Uniblock is a two-line change: point at Uniblock's endpoint and add your API key. Because Uniblock forwards the native `/info` contract verbatim, **every request body and response shape you already use stays the same**.
Grab your API key from the
[Uniblock dashboard](https://dashboard.uniblock.dev) before you start.
## What changes
| | Public Hyperliquid | Uniblock |
| ----------------- | ------------------------------------------ | -------------------------------------------------------------- |
| **URL** | `https://api.hyperliquid.xyz/info` | `https://api.uniblock.dev/uni/v1/hyperliquid/info?chainId=999` |
| **Auth** | none | `x-api-key: YOUR_API_KEY` header |
| **Testnet** | `https://api.hyperliquid-testnet.xyz/info` | add `chainId=998` |
| **Request body** | unchanged | unchanged |
| **Response body** | unchanged | unchanged |
| **Rate limits** | request-weight cap per IP | no per-IP cap, but plan-level limits apply |
Everything else (the `type` discriminator, operation-specific fields, and the JSON you get back) is identical.
## Before and after
```bash Public /info theme={null}
curl --location 'https://api.hyperliquid.xyz/info' \
--header 'Content-Type: application/json' \
--data '{
"type": "clearinghouseState",
"user": "0x0000000000000000000000000000000000000000"
}'
```
```bash Uniblock theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/hyperliquid/info?chainId=999' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"type": "clearinghouseState",
"user": "0x0000000000000000000000000000000000000000"
}'
```
## Migrate in code
If you build requests in application code, change the base URL and inject the header once:
```javascript theme={null}
// Before
const BASE_URL = "https://api.hyperliquid.xyz/info";
async function info(body) {
const res = await fetch(BASE_URL, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(body),
});
return res.json();
}
// After
const BASE_URL = "https://api.uniblock.dev/uni/v1/hyperliquid/info?chainId=999";
async function info(body) {
const res = await fetch(BASE_URL, {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-api-key": process.env.UNIBLOCK_API_KEY, // the only new line
},
body: JSON.stringify(body),
});
return res.json();
}
```
```python Python theme={null}
import os
import requests
# Before: "https://api.hyperliquid.xyz/info"
BASE_URL = "https://api.uniblock.dev/uni/v1/hyperliquid/info"
def info(body):
res = requests.post(
BASE_URL,
params={"chainId": 999},
headers={"x-api-key": os.environ["UNIBLOCK_API_KEY"]},
json=body,
)
return res.json()
```
## After migrating
* The public per-IP request-weight cap no longer applies, but **keep your retry/backoff logic**: Uniblock enforces plan-level rate limits and returns `429` when your project exceeds them (backup routing does not bypass this). See [Rate Limits & Caching](/guides/hyperliquid/info-api/limits) and [error codes](/guides/uniblock/error-codes#rate-limits).
* Consider Uniblock's synthetic types (`portfolioState`, `batchClearinghouseStates`, `batchPortfolioStates`) to replace multiple round-trips with one request. See the [Info API overview](/guides/hyperliquid/info-api/overview).
* Using an off-the-shelf Hyperliquid SDK? See [SDK Compatibility](/guides/hyperliquid/info-api/sdk-compatibility).
# Hyperliquid Info API: drop-in /info replacement
Source: https://docs.uniblock.dev/guides/hyperliquid/info-api/overview
A drop-in replacement for Hyperliquid's public /info REST API: same request and response shapes, no per-IP request-weight cap, automatic provider failover.
The Uniblock **Hyperliquid Info API** forwards a native Hyperliquid [`/info`](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint) request (selected by its `type` field) through Uniblock's unified request lifecycle and returns the upstream response verbatim. It's a drop-in replacement for the public `/info` endpoint: the request and response shapes are identical, but requests flow through the provider waterfall, so you get automatic failover, unified billing, and observability with **no per-IP request-weight cap** (plan-level rate limits still apply).
Create your project and grab your API key from the
[Uniblock dashboard](https://dashboard.uniblock.dev).
## Endpoint
| Method | Path | Description |
| ------ | -------------------------- | --------------------------------------------------------------------------- |
| `POST` | `/uni/v1/hyperliquid/info` | Forward a native Hyperliquid `/info` request and return the upstream reply. |
### Query parameters
* `chainId`: `999` for Hyperliquid mainnet (default) or `998` for Hyperliquid testnet.
* `provider`: optionally pin a specific provider; otherwise Uniblock routes through the waterfall.
## How it works
Every request body must include a `type` discriminator that mirrors Hyperliquid's own `/info` contract (for example `clearinghouseState`, `l2Book`, `metaAndAssetCtxs`). The `type` selects the operation, and any operation-specific fields are forwarded verbatim. A request without a supported `type` fails fast with a `400` at the HTTP boundary rather than reaching a provider.
### Synthetic Uniblock types
Beyond the native Hyperliquid operations, Uniblock defines synthetic `type`s composed on Uniblock's side and dispatched through this same route:
| Type | Description |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `portfolioState` | Normalized Hyperliquid Portfolio State: a stable account-state view composed across perpetuals, spot balances, and user abstraction. |
| `batchClearinghouseStates` | Perpetual clearinghouse state for a list of users in a single request (one Info sub-request per user). |
| `batchPortfolioStates` | Full Portfolio State for a list of users in a single request. |
Batch types carry a `{ "type": ..., "users": string[] }` body and are limited to **50 users** per request.
## Available types
Every Hyperliquid Info `type` supported by at least one unified provider (Alchemy, GoldRush, Dwellir, or Chainstack). Each request body always includes the `type` field; the **Body** column lists the additional fields alongside it.
Legend: `*` marks an optional field, and `-` means no fields beyond `type`.
Tags: **GoldRush-native** types are served only by GoldRush's verbatim
passthrough; provider aliases normalize to a native type before
routing; **Uniblock synthetic** types are composed by Uniblock and don't map
to a single upstream call.
| Type | Body | Returns |
| ----------------------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `clearinghouseState` | `user`, `dex`\* | Perp account summary: open positions, margin usage, account value, withdrawable balance. |
| `activeAssetData` | `user`, `coin` | The user's leverage, available-to-trade size, and mark price for one asset. |
| `spotClearinghouseState` | `user` | The user's spot token balances. |
| `userAbstraction` | `user` | Account abstraction mode (unifiedAccount, portfolioMargin, dexAbstraction, default, or disabled). |
| `webData2` | `user` | Aggregated frontend snapshot for a user (clearinghouse state, open orders, asset contexts, meta). |
| `openOrders` | `user`, `dex`\* | The user's active orders (price, size, side, order ID, timestamp). |
| `frontendOpenOrders` | `user`, `dex`\* | Active orders plus frontend metadata (order type, original size, trigger conditions). |
| `outcomeMeta` | `-` | Metadata for prediction-market outcomes, with side specifications. |
| `settledOutcome` | `outcome` | Settlement and resolution data for one prediction-market outcome. |
| `vaultSummaries` | `-` | Summary list of all vaults (name, address, leader, TVL, status, creation time). |
| `userVaultEquities` | `user` | The user's vault deposits as vault-address / equity pairs. |
| `leadingVaults` | `user` | Vaults the user leads (address, name, TVL, share price, PnL over 1D/7D/30D/all-time, commission). |
| `userRole` | `user` | Account classification (missing, user, agent, vault, or subAccount) with metadata. |
| `extraAgents` | `user` | Approved agent wallets for the account (address, name, valid-until). |
| `approvedBuilders` | `user` | Builder addresses the user has authorized. |
| `meta` | `dex`\* | Perp asset universe and margin / leverage tables. |
| `spotMeta` | `-` | Spot token metadata and pair universe. |
| `marginTable` | `id` | Leverage / margin tier brackets for a given margin-table id. |
| `perpDexs` | `-` | All perp DEX instances (name, deployer, fee configuration). |
| `allPerpMetas` | `-` | Metadata and asset contexts for every perp DEX at once. |
| `perpAnnotation` | `coin` | Category and description for one perpetual contract. |
| `perpCategories` | `-` | Asset-to-category mappings for all perpetuals. |
| `perpConciseAnnotations` | `-` | Concise category and keyword data for perp assets. |
| `perpDexStatus` | `dex` | Total net deposits across one perp DEX. |
| `perpDexLimits` | `dex` | Total open-interest caps and per-asset limits for a builder-deployed market. |
| `exchangeStatus` | `-` | Exchange status: special-status / maintenance messages and server time. |
| `spotDeployState` | `user` | Spot token deployment auction details and genesis allocations. |
| `perpDeployAuctionStatus` | `-` | Perp deployment auction timing and gas parameters. |
| `spotPairDeployAuctionStatus` | `-` | Dutch-auction status for deploying spot pairs. |
| `allBorrowLendReserveStates` | `-` | Reserve state for every borrow/lend token. |
| `borrowLendReserveState` | `token` | Reserve metrics for one token (rates, utilization, oracle price, LTV, supplied/borrowed). |
| `borrowLendUserState` | `user` | The user's per-token borrow/lend positions and health. |
| `delegations` | `user` | Validator delegations with amounts and lock-up timestamps. |
| `delegatorSummary` | `user` | Totals for delegated, undelegated, and pending-withdrawal amounts. |
| `maxBuilderFee` | `user`, `builder` | Max fee (tenths of a basis point) the user approved for a builder. |
| `validatorL1Votes` | `-` | Active L1 governance actions and the addresses that voted. |
| `userFees` | `user` | Volume history, fee schedule, the user's current rates, and discounts. |
| `maxMarketOrderNtls` | `-` | Max market-order notional per leverage level. |
| `perpsAtOpenInterestCap` | `dex`\* | Assets currently at their open-interest cap. |
| `liquidatable` | `user` | Whether the user's positions are currently at risk of liquidation. |
| `userFills` | `user`, `aggregateByTime`\* | Up to 2000 most recent fills (price, size, PnL, fee). |
| `userFillsByTime` | `user`, `startTime`, `endTime`*, `aggregateByTime`* | Fills within a time range (10,000 most recent available). |
| `userTwapSliceFills` | `user` | Up to 2000 most recent TWAP slice fills with TWAP execution IDs. |
| `userTwapSliceFillsByTime` | `user`, `startTime`, `endTime`\* | TWAP slice fills within a time range. *(GoldRush-native.)* |
| `builderFills` | `builder`, `aggregateByTime`*, `cursor`* | Fills routed through a builder address, across every user, with builder-fee data. Each row carries the `user` it belongs to. |
| `builderFillsByTime` | `builder`, `startTime`*, `endTime`*, `aggregateByTime`*, `cursor`* | Fills routed through a builder address within a time range, across every user, with builder-fee data. Each row carries the `user` it belongs to. `startTime` is required unless `cursor` is set. *(GoldRush-native.)* |
| `userFunding` | `user`, `startTime`, `endTime`\* | Funding payments on positions within a time range. |
| `fundingHistory` | `coin`, `startTime`, `endTime`\* | Historical funding rates and premiums for one asset. |
| `userNonFundingLedgerUpdates` | `user`, `startTime`, `endTime`\* | Deposits, transfers, and withdrawals affecting the account. |
| `delegatorHistory` | `user` | Delegation / undelegation transaction history. |
| `delegatorRewards` | `user` | Staking rewards history (time, source, amount). |
| `subAccounts` | `user` | Sub-accounts with name, address, margin summary, and spot balances. |
| `candleSnapshot` | `req` `{ coin, interval, startTime, endTime }` | OHLCV candles (5000 most recent). |
| `l2Book` | `coin`, `nSigFigs`*, `mantissa`* | Order book, up to 20 levels per side (`px`, `sz`, `n`). |
| `allMids` | `dex`\* | Mid prices for all perp and spot coins. |
| `historicalOrders` | `user` | Up to 2000 most recent historical orders with final status. |
| `userDexAbstraction` | `user` | Whether HIP-3 DEX abstraction is enabled for the user. |
| `orderStatus` | `user`, `oid` | Status and details for one order (`oid` as a uint64 or hex cloid). |
| `orderStatusByOid` | `user`, `oid` | Alias for `orderStatus`, normalized before routing. *(Provider alias.)* |
| `portfolioState` | `user` | Normalized Portfolio State across perps, spot, and user abstraction. *(Uniblock synthetic.)* |
| `batchClearinghouseStates` | `users[]` (≤ 50) | `clearinghouseState` for each user in one request. *(Uniblock synthetic.)* |
| `batchPortfolioStates` | `users[]` (≤ 50) | Portfolio State for each user in one request. *(Uniblock synthetic.)* |
## Providers
The following providers serve the Hyperliquid Info API, in priority order:
* Alchemy
* Dwellir
* Chainstack
* GoldRush (Covalent)
Provider support is per-`type`: raw HyperCore-node passthroughs (Dwellir, Chainstack) forward every native node operation, while some aggregations are served only by specific providers. Uniblock routes each request to a provider that serves the requested `type`.
## Basic request
```bash cURL theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/hyperliquid/info?chainId=999' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"type": "clearinghouseState",
"user": "0x0000000000000000000000000000000000000000"
}'
```
```javascript JavaScript theme={null}
const res = await fetch(
"https://api.uniblock.dev/uni/v1/hyperliquid/info?chainId=999",
{
method: "POST",
headers: {
"x-api-key": "YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
type: "clearinghouseState",
user: "0x0000000000000000000000000000000000000000",
}),
},
);
console.log(await res.json());
```
## Next steps
Move from the public `/info` API by changing one URL and adding your key.
How Uniblock removes the public request-weight cap and how to poll efficiently.
Reuse existing Hyperliquid SDKs by overriding the base URL and auth header.
The complete Hyperliquid Info endpoint reference in the Unified API section.
# SDK Compatibility
Source: https://docs.uniblock.dev/guides/hyperliquid/info-api/sdk-compatibility
Reuse existing Hyperliquid SDKs against Uniblock's Info API by overriding the base URL and injecting your X-API-Key header, without SDK forks.
Because Uniblock forwards the native Hyperliquid `/info` contract verbatim, most existing Hyperliquid SDKs work against Uniblock unchanged: you only override the **base URL** and inject your **API key** header. The request bodies the SDK builds and the responses it parses stay identical.
Grab your API key from the
[Uniblock dashboard](https://dashboard.uniblock.dev).
## What to override
| Setting | Value |
| --------------- | -------------------------------------------------- |
| Base URL | `https://api.uniblock.dev/uni/v1/hyperliquid/info` |
| Query parameter | `chainId=999` (mainnet) or `chainId=998` (testnet) |
| Auth header | `x-api-key: YOUR_API_KEY` |
If your SDK exposes a configurable base URL and a way to attach default headers, that's all you need.
## Python (`hyperliquid-python-sdk`)
The official SDK takes a `base_url` and lets you pass a custom session. Point the base URL at Uniblock and attach your key as a default header:
```python theme={null}
import os
import requests
from hyperliquid.info import Info
session = requests.Session()
session.headers.update({"x-api-key": os.environ["UNIBLOCK_API_KEY"]})
# The SDK posts to `{base_url}/info`, so use the route prefix as the base.
info = Info(
base_url="https://api.uniblock.dev/uni/v1/hyperliquid",
skip_ws=True,
)
info.session = session # reuse the authenticated session
state = info.user_state("0x0000000000000000000000000000000000000000")
print(state)
```
The SDK appends `/info` to the base URL. Set the base to the
`.../uni/v1/hyperliquid` prefix so the final URL resolves to
`.../uni/v1/hyperliquid/info`. If your SDK version doesn't send the `chainId`
query parameter, Uniblock defaults to `999` (mainnet).
## Raw / custom clients
If you built a thin client yourself, override the endpoint and header once and leave every call site unchanged:
```javascript theme={null}
const client = {
baseUrl: "https://api.uniblock.dev/uni/v1/hyperliquid/info?chainId=999",
headers: {
"Content-Type": "application/json",
"x-api-key": process.env.UNIBLOCK_API_KEY,
},
info(body) {
return fetch(this.baseUrl, {
method: "POST",
headers: this.headers,
body: JSON.stringify(body),
}).then((r) => r.json());
},
};
await client.info({ type: "metaAndAssetCtxs" });
```
## Notes & limits
* **Synthetic types are Uniblock-only.** `portfolioState`, `batchClearinghouseStates`, and `batchPortfolioStates` aren't part of the public contract, so SDKs won't have typed helpers for them; send them as raw bodies. See the [Info API overview](/guides/hyperliquid/info-api/overview).
* **WebSocket transports differ.** SDKs that open a WebSocket to Hyperliquid's public endpoint won't reach Uniblock's stream automatically; set `skip_ws=True` (or the equivalent) and use [Uniblock's WebSockets](/guides/hyperliquid/websockets/overview) for streaming.
* **Signing is unaffected.** Uniblock only changes transport and auth; any exchange/signing flow the SDK performs is untouched.
# Hyperliquid API Overview
Source: https://docs.uniblock.dev/guides/hyperliquid/overview
Low-latency Hyperliquid data infrastructure on Uniblock: the Info API, HyperCore WebSockets, and HyperEVM JSON-RPC, all behind one API key.
Uniblock gives you complete, low-latency data infrastructure for **Hyperliquid** behind a single API key and billing account. Whether you're building a trading UI, a copy-trade bot, a portfolio tracker, or an on-chain dashboard, you connect to Uniblock instead of stitching together Hyperliquid's public `/info` endpoint, its HyperCore WebSocket, and a HyperEVM node yourself, with automatic provider failover, unified authentication, and no public-API per-IP caps to work around.
Every request is authenticated with a project API key. Create your project and
grab your key from the [Uniblock dashboard](https://dashboard.uniblock.dev).
New to Hyperliquid's architecture? Start with
[HyperCore vs. HyperEVM](/guides/quickstart-guides/hypercore-vs-hyperevm).
## What you can build
A drop-in replacement for Hyperliquid's public `/info` REST API. Same request and response shapes, routed through Uniblock's provider waterfall: no per-IP request-weight cap, automatic failover.
Real-time HyperCore order book and account streams (`l2Book`, `l2BookDiff`, `l4Book`, fills, and liquidations) over one connection, with no per-IP subscription cap.
Standard JSON-RPC access to HyperEVM (chain `999`, testnet `998`): read state, send transactions, and call contracts with familiar EVM tooling.
## Why route Hyperliquid through Uniblock
* **No per-IP caps.** The public `/info` API caps you at a request-weight budget per IP, and the public WebSocket caps you at 1000 subscriptions per IP. Uniblock lifts both; plan-level rate limits still apply (a `429` on burst; [details](/guides/uniblock/error-codes#rate-limits)).
* **One key, one bill.** Info API, WebSockets, and HyperEVM share the same project API key and are metered in compute units.
* **Automatic failover.** Requests flow through the unified provider waterfall (Alchemy, Dwellir, Chainstack, GoldRush/Covalent), so a single provider outage doesn't take you down.
* **Drop-in migration.** Request and response shapes match Hyperliquid's own contracts, so migrating usually means changing one URL and adding a header.
## The two halves of Hyperliquid
Hyperliquid is two components with different jobs, and which offering you use depends on which half you need:
| | HyperCore | HyperEVM |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------- |
| **What it is** | Native trading engine: order book, perps, spot | EVM-compatible smart contract chain |
| **How you reach it on Uniblock** | [Info API](/guides/hyperliquid/info-api/overview) (REST) and [WebSockets](/guides/hyperliquid/websockets/overview) | [HyperEVM JSON-RPC](/guides/hyperliquid/evm/overview) |
| **Node access** | Controlled by Hyperliquid; you can't run one | Permissionless |
See [HyperCore vs. HyperEVM](/guides/quickstart-guides/hypercore-vs-hyperevm) for the full breakdown.
## Get started
Three \~5-minute paths: call the Info API, connect a WebSocket, and query HyperEVM over JSON-RPC.
# Hyperliquid Quickstart
Source: https://docs.uniblock.dev/guides/hyperliquid/quickstart
Three short paths to your first Hyperliquid response on Uniblock: the Info REST API, a HyperCore WebSocket stream, and HyperEVM JSON-RPC.
Pick the path for what you're building. Each takes about five minutes and assumes you already have an Uniblock project; if not, follow the [Uniblock Quickstart Guide](/guides/getting-started/uniblock-quickstart-guide) first to create one and copy your API key.
Every example below authenticates with your project API key. Replace `YOUR_API_KEY` with the key from your [Uniblock dashboard](https://dashboard.uniblock.dev).
## Path 1: Call the Info API
Fetch a user's perpetuals clearinghouse state with a single POST. This is Hyperliquid's public `/info` contract, routed through Uniblock.
```bash cURL theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/hyperliquid/info?chainId=999' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"type": "clearinghouseState",
"user": "0x0000000000000000000000000000000000000000"
}'
```
```javascript JavaScript theme={null}
const res = await fetch(
"https://api.uniblock.dev/uni/v1/hyperliquid/info?chainId=999",
{
method: "POST",
headers: {
"x-api-key": "YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
type: "clearinghouseState",
user: "0x0000000000000000000000000000000000000000",
}),
},
);
console.log(await res.json());
```
Change the `type` to any Hyperliquid `/info` operation (`l2Book`, `spotClearinghouseState`, …) or a Uniblock synthetic type like `portfolioState`. Full details in the [Info API overview](/guides/hyperliquid/info-api/overview).
## Path 2: Connect a WebSocket
Open one connection and subscribe to per-block order book diffs for a single asset.
```javascript theme={null}
import WebSocket from "ws";
const ws = new WebSocket("wss://websocket.uniblock.dev/goldrush", {
headers: { "X-API-KEY": "YOUR_API_KEY" },
});
ws.on("open", () => {
ws.send(
JSON.stringify({
method: "subscribe",
subscription: { type: "l2BookDiff", coin: "HYPE" },
}),
);
});
ws.on("message", (raw) => console.log(JSON.parse(raw.toString())));
```
The first message per coin is a full `Snapshot`; the rest are per-block `Updates`. See the [WebSockets overview](/guides/hyperliquid/websockets/overview) for every channel and payload shape.
## Path 3: Query HyperEVM over JSON-RPC
Read the latest HyperEVM block number with a standard `eth_blockNumber` call.
```bash cURL theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/json-rpc?chainId=999' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": [],
"id": 1
}'
```
```javascript JavaScript theme={null}
const res = await fetch(
"https://api.uniblock.dev/uni/v1/json-rpc?chainId=999",
{
method: "POST",
headers: {
"x-api-key": "YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
jsonrpc: "2.0",
method: "eth_blockNumber",
params: [],
id: 1,
}),
},
);
console.log(await res.json());
```
Use `chainId=998` for testnet. Browse every method group in the [HyperEVM overview](/guides/hyperliquid/evm/overview).
***
***
Create your free account and start building with unified blockchain infrastructure across 300+ chains.
Explore all available endpoints and interactive playgrounds
# Stream Builder Liquidations
Source: https://docs.uniblock.dev/guides/hyperliquid/websockets/builder-liquidations
Stream Hyperliquid liquidation fills attributed to your builder code in real time, with builder-fee data and liquidation metadata attached.
The `builderLiquidations` channel is a GoldRush-native stream of liquidation fills attributed to a specific **builder code**. Attribution follows the liquidated user's last fill before liquidation: when that fill carried your builder code, the liquidation is emitted on your stream. Think of it as the intersection of `liquidationFills` and `builderFills`: you only receive liquidations attributed to your builder address, with the `builder` and `liquidation` metadata populated on every entry. Use it to monitor liquidations across your builder's order flow without filtering the global stream yourself.
`builderLiquidations` requires a `builder` address; there's no wildcard
subscription. It's billed at **1 credit/min** (5,000 CU/min), the same rate as
the other account streams. See
[pricing](/guides/hyperliquid/websockets/overview#pricing).
## Subscribe
```json theme={null}
{
"method": "subscribe",
"subscription": {
"type": "builderLiquidations",
"builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b"
}
}
```
| Field | Required | Meaning |
| ----------------- | -------- | ----------------------------------------------------------------------------------------- |
| `builder` | Yes | Builder address whose routed liquidation fills you want, as lowercase `0x`-prefixed hex. |
| `aggregateByTime` | No | Merge partial fills from the same liquidation within the same block. Defaults to `false`. |
| `dex` | No | Filter to a single DEX; omit to receive fills from all DEXs. |
A missing or malformed `builder` field returns an error message on the `error` channel:
```json theme={null}
{ "channel": "error", "data": "subscription builderLiquidations requires a 'builder' field" }
```
## Message format
Unlike the other channels on this connection, `builderLiquidations` messages
keep the upstream wire shape and are **not** wrapped in the `channel`/`data`
envelope: match on `msg.type === "builderLiquidations"` rather than
`msg.channel`.
Each message carries an array of `[address, fill]` tuples, where the address is the **liquidated wallet** and the fill is the liquidation attributed to your builder:
```json theme={null}
{
"type": "builderLiquidations",
"liquidations": [
[
"0x742d35cc6634c0532925a3b844bc9e7595f7f2e2",
{
"coin": "ETH",
"px": "2150.50",
"sz": "1.5",
"side": "A",
"time": 1704067200000,
"startPosition": "1.5",
"dir": "Close Long",
"closedPnl": "-125.50",
"hash": "0xabc...def",
"oid": 12345678,
"crossed": true,
"fee": "2.50",
"tid": 87654321,
"cloid": null,
"feeToken": "USDC",
"builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b",
"builderFee": null,
"deployerFee": null,
"twapId": null,
"liquidation": {
"liquidatedUser": "0x742d35cc6634c0532925a3b844bc9e7595f7f2e2",
"markPx": "2148.00",
"method": "market"
},
"user": "0x742d35cc6634c0532925a3b844bc9e7595f7f2e2"
}
]
]
}
```
Fills follow the standard Hyperliquid fill shape (`coin`, `px`, `sz`, `side`, `time`, `dir`, `closedPnl`, and so on), extended with the fields that make this stream useful:
| Field | Meaning |
| ---------------------------- | ---------------------------------------------------------------------- |
| `builder` | The builder code that routed the closing order. |
| `builderFee` | Builder fee earned on the fill, in `feeToken`; `null` if none. |
| `deployerFee` | Deployer fee attributed to the fill; `null` if none. |
| `liquidation.liquidatedUser` | The wallet that was liquidated (mirrors the tuple address and `user`). |
| `liquidation.markPx` | Mark price at liquidation time. |
| `liquidation.method` | How the position was closed: `"market"` or `"backstop"`. |
TWAP fills don't carry builder codes. If a user's last fill before liquidation
was a TWAP fill, no builder liquidation is emitted for it.
## When to use builder liquidations
Monitoring liquidations across your builder's order flow: alerting your
users when their positions are force-closed, or auditing liquidation
outcomes per DEX.
You want every liquidation on the venue regardless of builder attribution;
the global stream costs the same and needs no `builder` address.
## Pair with other streams
`builderLiquidations` tells you which of your builder's positions were force-closed; the surrounding channels fill in the rest:
* `builderFills`: every fill attributed to your builder, not just liquidations.
* `liquidationFills`: the global liquidation stream across all builders.
* `userFills` / `orderUpdates`: per-wallet fills and order lifecycle events.
See the full list in the [WebSocket overview](/guides/hyperliquid/websockets/overview#available-channels).
# Connect & Migrate
Source: https://docs.uniblock.dev/guides/hyperliquid/websockets/connect
Open your first Uniblock Hyperliquid WebSocket connection, authenticate with X-API-KEY, and migrate from the public HyperCore WebSocket by changing one URL.
This guide walks through opening a connection, subscribing, and (if you're already on Hyperliquid's public WebSocket) migrating with a one-line change.
Grab your API key from the
[Uniblock dashboard](https://dashboard.uniblock.dev).
## 1. Connect
Open a WebSocket to Uniblock's endpoint and authenticate with the `X-API-KEY` header (recommended) or an `apiKey` query parameter.
```javascript theme={null}
import WebSocket from "ws";
const ws = new WebSocket("wss://websocket.uniblock.dev/goldrush", {
headers: { "X-API-KEY": "YOUR_API_KEY" },
});
ws.on("open", () => console.log("Connected to Hyperliquid via Uniblock"));
```
Confirm your credentials before opening a stream:
`curl 'https://websocket.uniblock.dev/goldrush/validate' --header 'X-API-KEY: YOUR_API_KEY'`
## 2. Subscribe
Send a `subscribe` message once the connection is open:
```javascript theme={null}
ws.on("open", () => {
ws.send(
JSON.stringify({
method: "subscribe",
subscription: { type: "l2BookDiff", coin: "HYPE" },
}),
);
});
ws.on("message", (raw) => console.log(JSON.parse(raw.toString())));
```
See the [WebSocket overview](/guides/hyperliquid/websockets/overview) for every channel and its payload shape.
## Migrate from the public WebSocket
Switching from Hyperliquid's public HyperCore WebSocket is a one-line change: the subscribe/unsubscribe message format is the same.
| | Public Hyperliquid | Uniblock |
| -------------------- | ------------------------------ | --------------------------------------- |
| **URL** | `wss://api.hyperliquid.xyz/ws` | `wss://websocket.uniblock.dev/goldrush` |
| **Auth** | none | `X-API-KEY` header or `apiKey` query |
| **Subscription cap** | 1000 per IP | none |
| **Message format** | unchanged | unchanged |
```javascript theme={null}
// Before
const ws = new WebSocket("wss://api.hyperliquid.xyz/ws");
// After
const ws = new WebSocket("wss://websocket.uniblock.dev/goldrush", {
headers: { "X-API-KEY": process.env.UNIBLOCK_API_KEY },
});
```
Uniblock adds GoldRush-native channels the public feed doesn't have:
`l2BookDiff`, `l4Book`, and `liquidationFills`. Once migrated you can drop any
logic that worked around the 1000-subscription cap.
## 3. Keep the connection healthy
* **Keep-alive:** send a ping every 30–60 seconds to avoid idle timeouts.
* **Reconnect with backoff:** on disconnect, re-open and re-send every subscription using exponential backoff. On reconnect, discard local order book state and re-seed from the fresh snapshots rather than replaying missed updates.
* **Scope subscriptions:** subscribe per `coin` rather than the wildcard stream when you only need a few assets; wildcard is billed at a much higher rate.
## Next steps
# Build with the L2 Order Book
Source: https://docs.uniblock.dev/guides/hyperliquid/websockets/l2-book
Stream self-contained Hyperliquid HyperCore L2 order book snapshots via the l2Book channel for top-of-book quotes, spread monitoring, and depth analytics.
The `l2Book` channel streams real-time **L2 order book** data: bids and asks aggregated into price levels by significant figures. Each message is self-contained, so it's the simplest channel to consume: you don't maintain local state between messages. Use it for top-of-book quotes, spread monitoring, and depth analytics.
For high-frequency book tracking across many assets, prefer
[`l2BookDiff`](/guides/hyperliquid/websockets/l2-book-diff); it sends only
changed levels and is billed at a fraction of the per-minute rate.
## Subscribe
```json theme={null}
{
"method": "subscribe",
"subscription": { "type": "l2Book", "coin": "HYPE" }
}
```
`coin` is optional; omit it to stream **all** assets on one subscription (billed at the higher wildcard rate; see [pricing](/guides/hyperliquid/websockets/overview#pricing)).
## Message shape
Each message carries the aggregated book for a coin. Levels are a two-element array (`[bids, asks]`), and each level is `{ px, sz, n }`.
```json theme={null}
{
"channel": "l2Book",
"data": {
"coin": "HYPE",
"levels": [
[{ "px": "0.50", "sz": "100", "n": 5 }, { "px": "0.49", "sz": "250", "n": 8 }],
[{ "px": "0.51", "sz": "200", "n": 3 }, { "px": "0.52", "sz": "120", "n": 4 }]
]
}
}
```
| Field | Meaning |
| -------- | -------------------------------------------- |
| `px` | Price level, as a string. |
| `sz` | Total size resting at that level. |
| `n` | Number of individual orders at that level. |
| `levels` | Two-element array: `[bidLevels, askLevels]`. |
## Consume it
Because each message is a complete snapshot, you can read top-of-book directly; no state to maintain:
```javascript theme={null}
ws.on("message", (raw) => {
const msg = JSON.parse(raw.toString());
if (msg.channel !== "l2Book") return;
const [bids, asks] = msg.data.levels;
const bestBid = bids[0]; // highest bid
const bestAsk = asks[0]; // lowest ask
const spread = Number(bestAsk.px) - Number(bestBid.px);
console.log(`${msg.data.coin} spread: ${spread}`);
});
```
## When to use L2 vs. L2 diff
| Use `l2Book` when… | Use [`l2BookDiff`](/guides/hyperliquid/websockets/l2-book-diff) when… |
| -------------------------------------------------- | --------------------------------------------------------------------- |
| You want the simplest integration (no local state) | You track the full book at high frequency |
| You watch a few assets and care about top-of-book | You subscribe to many assets or the wildcard stream |
| Bandwidth and CU cost aren't a concern | You want bandwidth proportional to what changed |
# Build with the L2 Order Book Diff
Source: https://docs.uniblock.dev/guides/hyperliquid/websockets/l2-book-diff
Track live Hyperliquid order book state across many assets with bandwidth proportional to changes: an initial snapshot plus per-block diffs.
The `l2BookDiff` channel is a bandwidth-efficient way to track order book changes. Instead of a full book on every update, you get an **initial snapshot** per coin followed by **per-block `Updates`** carrying only the price levels that changed, the same `{ px, sz, n }` structure as [`l2Book`](/guides/hyperliquid/websockets/l2-book). It's a GoldRush-native channel, unavailable on the public Hyperliquid feed, and the cheapest way to keep a live book across many assets.
`l2BookDiff` is billed at **0.1 credits/min per coin** (500 CU/min): a fifth
of `l2Book`. See [pricing](/guides/hyperliquid/websockets/overview#pricing).
## Subscribe
```json theme={null}
{
"method": "subscribe",
"subscription": { "type": "l2BookDiff", "coin": "HYPE" }
}
```
`coin` accepts:
* a single asset: `"HYPE"`
* an array: `["HYPE", "BTC", "ETH"]`
* omitted entirely: streams all perps on one connection. When omitted, specify `marketTypes` like `["spot"]` or `["*"]` for multi-market coverage.
## Payload shapes
The first message per coin is a `Snapshot`; subsequent messages are `Updates`.
### Snapshot
```json theme={null}
{
"channel": "l2BookDiff",
"data": {
"Snapshot": {
"coin": "HYPE",
"levels": [
[{ "px": "0.50", "sz": "100", "n": 5 }],
[{ "px": "0.51", "sz": "200", "n": 3 }]
]
}
}
}
```
`levels` is `[bids, asks]`; each entry is a price object.
### Update
```json theme={null}
{
"channel": "l2BookDiff",
"data": {
"Updates": {
"book_diffs": [
{
"coin": "HYPE",
"levels": [
[{ "px": "0.50", "sz": "50", "n": 4 }],
[{ "px": "0.51", "sz": "0", "n": 0 }]
]
}
]
}
}
}
```
| Field | Meaning |
| ------------ | ----------------------------------------------------- |
| `px` | Price level, as a string. |
| `sz` | Size at that level; `"0"` means **delete** the level. |
| `n` | Number of individual orders at the level. |
| `coin` | Asset symbol (e.g. `HYPE`, `BTC`). |
| `levels` | Two-element array: `[bidLevels, askLevels]`. |
| `book_diffs` | Array of diff objects, one per affected coin. |
## Maintain a local book
1. On `Snapshot`: initialize (or reset) the coin's book with bid and ask maps.
2. On `Updates`: for each `book_diff`, apply the changed levels to the matching side.
3. When `sz === "0"`, delete that price level; otherwise set or update it.
```typescript theme={null}
type Level = { px: string; sz: string; n: number };
function applyLevels(side: Map, levels: Level[]) {
for (const lvl of levels) {
if (lvl.sz === "0") side.delete(lvl.px);
else side.set(lvl.px, lvl);
}
}
const books = new Map; asks: Map }>();
ws.on("message", (raw) => {
const msg = JSON.parse(raw.toString());
if (msg.channel !== "l2BookDiff") return;
if (msg.data.Snapshot) {
const { coin, levels } = msg.data.Snapshot;
const book = { bids: new Map(), asks: new Map() };
applyLevels(book.bids, levels[0]);
applyLevels(book.asks, levels[1]);
books.set(coin, book);
} else if (msg.data.Updates) {
for (const diff of msg.data.Updates.book_diffs) {
const book = books.get(diff.coin);
if (!book) continue; // wait for the snapshot first
applyLevels(book.bids, diff.levels[0]);
applyLevels(book.asks, diff.levels[1]);
}
}
});
```
Reconstruct top-of-book by scanning your local maps for the highest bid and lowest ask.
## Reconnection
On reconnect, resend your original subscription. Fresh snapshots arrive first: **discard local state for affected coins and re-seed from those snapshots** rather than attempting to replay missed updates.
# Build with the L4 Order Book
Source: https://docs.uniblock.dev/guides/hyperliquid/websockets/l4-book
Get per-order Hyperliquid book data (individual orders with user, order ID, and trigger metadata) for flow attribution and microstructure analysis.
The `l4Book` channel is a GoldRush-native, **order-level** book stream. Where L2 aggregates orders into price levels, L4 exposes the **individual orders** that make up each level, with the user, order ID, client order ID, time-in-force, and trigger metadata attached. Use it for per-trader flow attribution, queue-position estimation, and market microstructure analysis.
`l4Book` requires a specific `coin`; there's no wildcard subscription. It's
billed at **2 credits/min per coin** (10,000 CU/min), and **20 credits/min for
`BTC`**. See [pricing](/guides/hyperliquid/websockets/overview#pricing).
## Subscribe
```json theme={null}
{
"method": "subscribe",
"subscription": { "type": "l4Book", "coin": "HYPE" }
}
```
Like `l2BookDiff`, you receive an initial **snapshot** of the current resting orders per coin, followed by per-block **updates** containing only the orders that were added, modified, or removed.
## What each order carries
Every order in the book exposes the fields that aggregated L2 levels hide:
| Field | Meaning |
| --------- | ------------------------------------------------------------- |
| `user` | Address that placed the order. |
| `oid` | Order ID assigned by HyperCore. |
| `cloid` | Client order ID, if the placer set one. |
| `px` | Limit price, as a string. |
| `sz` | Remaining size on the order. |
| `side` | `"B"` (bid) or `"A"` (ask). |
| `tif` | Time-in-force (e.g. `Gtc`, `Ioc`, `Alo`). |
| `trigger` | Trigger metadata for stop / take-profit orders, when present. |
Snapshots and updates follow the same `Snapshot` / `Updates` envelope as [`l2BookDiff`](/guides/hyperliquid/websockets/l2-book-diff): apply added and modified orders to a local map keyed by `oid`, and remove orders as they leave the book.
## When to use L4
Attributing flow to specific wallets, estimating queue position, or reconstructing exact order-level microstructure.
You only need aggregated depth or top-of-book; [`l2Book`](/guides/hyperliquid/websockets/l2-book) or [`l2BookDiff`](/guides/hyperliquid/websockets/l2-book-diff) are far cheaper.
## Pair with account streams
L4 tells you what's resting on the book; the account channels tell you what executes. Combine `l4Book` with:
* `allFills`: every fill across the venue.
* `liquidationFills`: the global liquidation stream.
* `userFills` / `orderUpdates`: per-wallet fills and order lifecycle events.
See the full list in the [WebSocket overview](/guides/hyperliquid/websockets/overview#available-channels).
# WebSocket API Overview
Source: https://docs.uniblock.dev/guides/hyperliquid/websockets/overview
Stream Hyperliquid HyperCore order books and account activity in real time over one Uniblock connection, with no per-IP subscription cap.
Uniblock's Hyperliquid WebSocket gives you real-time access to **HyperCore** data (the native order book, perpetuals, and account event streams) over a single connection authenticated with your Uniblock API key. Because HyperCore isn't a permissionless chain you can run a node for (see [HyperCore vs. HyperEVM](/guides/quickstart-guides/hypercore-vs-hyperevm)), a WebSocket is the way to get live order book data, and routing through Uniblock lifts the public API's **1000-subscription-per-IP** cap.
Streaming is billed in compute units per active subscription per minute. Grab
your API key from the [Uniblock dashboard](https://dashboard.uniblock.dev).
## Endpoint
```plaintext theme={null}
wss://websocket.uniblock.dev/goldrush
```
A single fixed endpoint; no `chainId` query parameter is required.
## Authentication
Two ways to authenticate the connection and validation requests:
1. **Header**: include `X-API-KEY: YOUR_API_KEY` in your request headers (recommended).
2. **URL query parameter**: append `apiKey=YOUR_API_KEY` to the connection string.
Header authentication is recommended to avoid exposing your API key in URLs,
server logs, or browser history.
You can confirm your credentials before opening a stream:
```bash theme={null}
curl --location 'https://websocket.uniblock.dev/goldrush/validate' \
--header 'X-API-KEY: YOUR_API_KEY'
```
## Subscribe and unsubscribe
Once connected, send a JSON `subscribe` message. Each message targets a subscription `type`, and most types accept an optional `coin` filter.
```json theme={null}
{
"method": "subscribe",
"subscription": { "type": "l2BookDiff", "coin": "HYPE" }
}
```
* `coin` accepts a single asset (`"HYPE"`) or an array (`["HYPE", "BTC"]`).
* Omitting `coin` streams **all** assets (wildcard) for the types that support it, billed at a much higher per-minute rate.
Stop a stream by sending the matching `unsubscribe` message with the **exact** same subscription body. Billing for that subscription stops as soon as it's removed.
```json theme={null}
{
"method": "unsubscribe",
"subscription": { "type": "l2BookDiff", "coin": "HYPE" }
}
```
## Available channels
### Order book streams
| `type` | Description |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `l2Book` | Real-time L2 order book snapshots and updates: bids and asks aggregated by significant figures. `coin` optional; omit to stream all assets. |
| `l2BookDiff` | GoldRush-native: an initial snapshot per coin plus per-block updates carrying only the price/size/count levels that changed. Lighter than `l2Book`. |
| `l4Book` | GoldRush-native order-level book: snapshots plus per-block updates exposing user, order ID, client order ID, time-in-force, and trigger metadata. Requires a specific `coin`; no wildcard. |
### Wallet & account activity streams
| `type` | Description |
| ----------------------------- | -------------------------------------------------------------------------------------------------------- |
| `userFills` | Live trade fills for specified wallets, batched per block. |
| `orderUpdates` | Order lifecycle events (placements, fills, cancels, rejections) for monitored addresses. |
| `liquidationFills` | Global liquidation stream (GoldRush-native). |
| `allFills` | Complete global fill stream, with optional single-market filtering. |
| `builderFills` | Attributed fills for builder addresses, with builder-fee data. |
| `builderLiquidations` | GoldRush-native: liquidation fills routed through a specific builder code. Requires a `builder` address. |
| `userNonFundingLedgerUpdates` | Non-funding ledger events such as deposits and withdrawals. |
## Connection & rate limits
Unlike the public Hyperliquid WebSocket's 1000-subscription-per-IP cap, Uniblock imposes **no subscription limit**. Wildcard subscriptions default to perpetual markets only; specify `marketTypes` (`["spot"]`, `["*"]`, …) to widen coverage on the types that support it.
## Pricing
Streaming bills **credits per minute** for each active subscription, converted to compute units at **5,000 CU per credit**. Charges accrue for as long as a subscription stays open.
| Subscription | Credits / min | CU / min |
| --------------------------------------------------------------------------------------------------------------------------------- | ------------- | -------- |
| `l2Book` (per coin) | 0.5 | 2,500 |
| `l2Book` (all assets) | 50 | 250,000 |
| `l2BookDiff` (per coin) | 0.1 | 500 |
| `l2BookDiff` (all assets) | 10 | 50,000 |
| `l4Book` (per coin) | 2 | 10,000 |
| `l4Book` (`BTC`) | 20 | 100,000 |
| `userFills`, `orderUpdates`, `liquidationFills`, `allFills`, `builderFills`, `builderLiquidations`, `userNonFundingLedgerUpdates` | 1 | 5,000 |
## Best practices
* **Security:** use the `X-API-KEY` header where possible to avoid exposing your key.
* **Keep-alive:** send a ping every 30–60 seconds to avoid idle timeouts.
* **Reconnect with backoff:** on disconnect, re-open and re-send your subscriptions using exponential backoff.
* **Scope your subscriptions:** subscribe per `coin` instead of the wildcard stream when you only need a handful of assets; it's dramatically cheaper.
## Build with the order book
Self-contained aggregated snapshots: top-of-book quotes and depth analytics.
Snapshot plus per-block diffs: track live state with bandwidth proportional to changes.
Per-order flow with user, order ID, and trigger metadata for attribution.
## Resources
* [Connect & migrate](/guides/hyperliquid/websockets/connect): connect and move off the public WebSocket.
* [Stream builder liquidations](/guides/hyperliquid/websockets/builder-liquidations): liquidation fills attributed to your builder code.
* [GoldRush provider reference](/reference/websockets/providers/websockets-goldrush): the provider page with the full type list and CU pricing.
* [Streaming Hyperliquid with WebSockets](/guides/quickstart-guides/hyperliquid-websocket-guide): end-to-end usage guide.
# HyperCore vs. HyperEVM
Source: https://docs.uniblock.dev/guides/quickstart-guides/hypercore-vs-hyperevm
Understand the difference between HyperCore and HyperEVM, what each component does, and which one you connect to when you integrate with Hyperliquid.
Hyperliquid isn't a single chain; it's two components with different jobs. Understanding the split matters before you integrate, because it determines what you can and can't access programmatically.
## HyperCore
HyperCore is Hyperliquid's native chain, purpose-built to process trades with very low latency. It runs the on-chain order book, perpetuals, and spot markets that make Hyperliquid a trading venue in the first place.
HyperCore is **not** an open, permissionless environment in the way most L1s are. Access to it is fully controlled by Hyperliquid: you can't run your own HyperCore node, and there's no general-purpose smart contract layer to deploy to. It exists to make the exchange fast, not to be a programmable chain third parties build directly on top of.
## HyperEVM
HyperEVM is the EVM-compatible chain that bridges Hyperliquid into the broader Ethereum ecosystem. It's what lets developers deploy standard Solidity smart contracts, use familiar EVM tooling, and interact with Hyperliquid using the same JSON-RPC methods you'd use on any other EVM chain.
Unlike HyperCore, HyperEVM is the piece you can actually run infrastructure for: nodes are permissionless, and it's the layer meant for third-party integration and contract deployment.
## Key differences
| | HyperCore | HyperEVM |
| --------------------- | -------------------------------------------------- | ----------------------------------- |
| **Purpose** | Native trading engine (order book, perps, spot) | EVM-compatible smart contract chain |
| **Node access** | Controlled by Hyperliquid (you cannot run a node) | Permissionless (you can run a node) |
| **Programmability** | No general-purpose contract layer | Standard EVM smart contracts |
| **How you integrate** | Indirectly, via HyperEVM or Hyperliquid's own APIs | Directly, via standard JSON-RPC |
## Which one does Uniblock connect to?
Because HyperCore access is controlled by Hyperliquid and isn't open to node operators, Uniblock's JSON-RPC endpoint routes to **HyperEVM**, the chain you can actually query and transact against with standard EVM tooling.
See supported networks, chain IDs, and the full JSON-RPC method reference for Hyperliquid on Uniblock.
# Streaming Hyperliquid with WebSockets
Source: https://docs.uniblock.dev/guides/quickstart-guides/hyperliquid-websocket-guide
Consume Hyperliquid HyperCore order book streams in real time through the Uniblock GoldRush WebSocket with one authenticated connection.
Hyperliquid's **HyperCore** runs the native order book that powers its perps and
spot markets. You can't run a HyperCore node yourself, so the way to get
real-time order book data is over a WebSocket. Uniblock exposes this through the
**GoldRush** WebSocket: one connection, authenticated with your Uniblock API
key, streaming Hyperliquid's [GoldRush HyperCore](https://goldrush.mintlify.app/api-reference/hyperliquid-websocket/l2-book-diff)
feed.
New to Hyperliquid's architecture? Read
[HyperCore vs. HyperEVM](/guides/quickstart-guides/hypercore-vs-hyperevm)
first, since this guide covers the HyperCore side (order book data), not the
EVM JSON-RPC side.
## 1. Connect
Open a WebSocket to Uniblock's GoldRush endpoint. Authenticate with the
`X-API-KEY` header (recommended) or an `apiKey` query parameter.
```javascript theme={null}
import WebSocket from "ws";
const ws = new WebSocket("wss://websocket.uniblock.dev/goldrush", {
headers: { "X-API-KEY": "YOUR_API_KEY" },
});
ws.on("open", () => {
console.log("Connected to Hyperliquid via Uniblock");
});
```
You can confirm your credentials before opening a stream by calling the
validation endpoint:
`curl 'https://websocket.uniblock.dev/goldrush/validate' --header 'X-API-KEY: YOUR_API_KEY'`
## 2. Subscribe to the order book
Send a `subscribe` message once the connection is open. The example below
subscribes to `l2BookDiff` (lightweight per-block order book diffs) for a
single asset.
```javascript theme={null}
ws.on("open", () => {
ws.send(
JSON.stringify({
method: "subscribe",
subscription: { type: "l2BookDiff", coin: "HYPE" },
}),
);
});
```
* Pass a single asset (`"HYPE"`) or an array (`["HYPE", "BTC"]`) as `coin`.
* Omit `coin` to stream **all** assets, but note the wildcard stream is billed
at a much higher per-minute rate.
## 3. Handle snapshot and diff messages
For `l2BookDiff`, the first message per coin is a full `Snapshot`; subsequent
messages are per-block `Updates` containing only the changed levels.
```javascript theme={null}
ws.on("message", (raw) => {
const msg = JSON.parse(raw.toString());
if (msg.channel !== "l2BookDiff") return;
if (msg.data.Snapshot) {
const { coin, levels } = msg.data.Snapshot;
console.log(`Snapshot for ${coin}`, levels); // [bids, asks]
} else if (msg.data.Updates) {
for (const diff of msg.data.Updates.book_diffs) {
// Each level: { px: price, sz: size, n: order count }.
// A level with sz === "0" means that price level was removed.
console.log(`Diff for ${diff.coin}`, diff.levels);
}
}
});
```
Apply each diff on top of your local copy of the book: replace the level at `px`
with the new `sz`/`n`, and delete the level when `sz` is `"0"`.
## 4. Unsubscribe
Stop a stream by sending an `unsubscribe` message with the **exact** same
subscription body you subscribed with. Billing for that subscription stops as
soon as it's removed.
```javascript theme={null}
ws.send(
JSON.stringify({
method: "unsubscribe",
subscription: { type: "l2BookDiff", coin: "HYPE" },
}),
);
```
## Other subscription types
`l2BookDiff` is one of several HyperCore streams available on the same
connection. Swap the `type` (and, for account streams, follow GoldRush's
per-type payload) to subscribe to:
* `l2Book`: full L2 order book snapshots and updates.
* `l4Book`: full per-order (L4) book.
* `userFills`, `orderUpdates`, `liquidationFills`, `allFills`, `builderFills`,
`builderLiquidations`, `userNonFundingLedgerUpdates`: account and venue event
streams.
See the [GoldRush provider reference](/reference/websockets/providers/websockets-goldrush)
for the full type list and per-subscription CU pricing.
## Best practices
* **Keep-alive:** send a ping every 30–60 seconds to avoid idle timeouts.
* **Reconnect with backoff:** on disconnect, re-open and re-send your
subscriptions using exponential backoff.
* **Scope your subscriptions:** subscribe per `coin` instead of the wildcard
stream when you only need a handful of assets; it's dramatically cheaper.
## Resources
* [GoldRush provider reference](/reference/websockets/providers/websockets-goldrush)
* [GoldRush Hyperliquid WebSocket docs](https://goldrush.mintlify.app/api-reference/hyperliquid-websocket/l2-book-diff)
* [HyperCore vs. HyperEVM](/guides/quickstart-guides/hypercore-vs-hyperevm)
# Authenticate Uniblock API requests with your API key
Source: https://docs.uniblock.dev/guides/uniblock/authentication
Authenticate requests to the Uniblock Unified API by adding your project API key in the X-API-Key header from cURL, JavaScript, Python, and more.
# How to authenticate your Uniblock API key
Every request to the Uniblock API must include your project API key in the request header. The key identifies your project, tracks usage, and gates access to the endpoints your plan supports.
## Steps
1. **Obtain your API key:** Navigate to your [Uniblock dashboard](https://dashboard.uniblock.dev), open your project, and copy the API key shown on the Overview page.
2. **Include the key in every request:** Add an `X-API-Key` header to each HTTP request you make to the Uniblock API.
```bash cURL theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/nft/balance?chainId=1&walletAddress=0x...' \
--header 'X-API-Key: YOUR_UNIBLOCK_API_KEY'
```
```javascript JavaScript theme={null}
const options = {
method: 'GET',
headers: {
accept: 'application/json',
'X-API-Key': 'YOUR_UNIBLOCK_API_KEY'
}
};
fetch('https://api.uniblock.dev/uni/v1/nft/balance?chainId=1&walletAddress=0x...', options)
.then(res => res.json())
.then(console.log);
```
3. **Test in the API Tester:** Open the [Uniblock Explorer](https://explorer.uniblock.dev), click **Authorize**, paste your API key, and click **Authorize** again. Every endpoint in the explorer will now send requests authenticated as your project.
4. **Start calling endpoints:** With your key in place, you're ready to call any Unified API endpoint your plan supports. Usage and analytics for all authenticated calls appear in your project dashboard under **Endpoints → Analytics**.
If you switch projects in the dashboard, update the API key in your code to match the new project, since each project has its own key and its own usage metrics.
## Header-only authentication for HTTP endpoints
Uniblock HTTP endpoints accept the API key only in the `X-API-Key` header. This applies to the Unified API, the Unified JSON-RPC endpoint (`https://api.uniblock.dev/uni/v1/json-rpc`), and Direct API endpoints.
There is no URL format that embeds the API key in the path or as a query parameter. If you are migrating from a provider that uses key-in-URL endpoints, keep the URL key-free and move the key into the `X-API-Key` header:
```bash theme={null}
# Not supported: key embedded in the URL
# https://api.uniblock.dev/uni/v1/json-rpc/YOUR_UNIBLOCK_API_KEY
# Supported: key in the X-API-Key header
curl --request POST \
--url 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=1' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc": "2.0", "method": "eth_blockNumber", "params": [], "id": 1}'
```
WebSocket connections are the exception. Most WebSocket endpoints also use the `X-API-KEY` header, but some provider-specific endpoints accept an `apiKey` query parameter instead. See [Authenticating Uniblock WebSocket connections](/reference/websockets/authentication).
# Auto-routing
Source: https://docs.uniblock.dev/guides/uniblock/autorouting/uniblock-auto-routing
Uniblock auto-routing directs each API call to the best blockchain data provider on reliability, cost, and performance with automatic failover.
## What is auto-routing?
Auto-routing automatically directs your API calls to the best available blockchain data provider based on reliability, cost, and performance. Instead of managing multiple provider keys and handling failovers manually, Uniblock routes requests intelligently and switches providers seamlessly when issues occur.
**Use auto-routing when you need:**
* Guaranteed uptime with automatic failover
* Cost-optimized provider selection
* Multi-provider redundancy without manual configuration
* Verified data accuracy across providers
Auto-routing is enabled by default for all Uniblock API keys. No setup required.
***
## Quick example
See auto-routing in action with a simple API call:
```bash Standard API call with auto-routing theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/token/balances?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb' \
--header 'x-api-key: YOUR_API_KEY'
```
**Behind the scenes, Uniblock:**
1. Routes to the optimal provider (e.g., Alchemy)
2. If Alchemy fails, retries 3 times
3. If still failing, switches to backup (e.g., Infura)
4. Returns the response seamlessly
**You don't need to change anything in your code.** Auto-routing handles all provider management automatically.
***
## How it works
When you make an API call with your Uniblock key:
1. **Route selection** - Uniblock evaluates available providers for cost and reliability
2. **Primary request** - Your call is routed to the optimal provider
3. **Auto-retry** - If the call fails, it's automatically retried with the same provider
4. **Failover** - After max retries, the request routes to the next best provider
5. **Data verification** - (Pro+ plans) Response data is verified across multiple providers
***
## Core features
### Default routing
Access all Uniblock-integrated providers with a single API key. No provider selection or configuration required.
**Available on:** All plans (including free)
**Key benefits:**
* Instant access to 55+ blockchain data providers
* Pre-configured backup provider list
* Works immediately with free tier
[Learn more about default routing →](/guides/uniblock/autorouting/uniblock-default-routing)
### Backup providers
Automatic failover to backup providers when the primary provider is unavailable or rate-limited.
**Available on:** All plans (including free)
**Key benefits:**
* Zero downtime during provider outages
* Seamless failover without code changes
* Configurable priority list for custom routing
**Example scenario:**
Your app makes 1,000 requests/minute. Your primary provider (Alchemy) hits rate limits at request #500. Auto-routing automatically switches to your backup provider (Infura) for requests #501-1000 without dropping a single call.
[Learn more about backup providers →](/guides/uniblock/autorouting/uniblock-backup)
### Data consensus
Available on Pro plans and above
Verifies response data across multiple providers to ensure accuracy.
**Key benefits:**
* Eliminates incorrect data from single-provider errors
* Detects and filters outlier responses
* Ensures data consistency for critical operations
**Example scenario:**
Your app requests the current ETH price. Data consensus queries 3 providers:
* Provider A: \$2,500.00
* Provider B: \$2,501.50
* Provider C: \$25,000.00 (outlier)
The system detects Provider C's outlier and returns the consensus value of \~\$2,500, preventing a critical pricing error.
[Learn more about data consensus →](/guides/uniblock/autorouting/uniblock-data-consensus)
***
## Common use cases
Ensure 99.99% uptime with automatic failover across multiple providers.
Automatically route to the cheapest provider without sacrificing reliability.
Seamlessly switch providers when rate limits are hit.
Verify critical data across multiple sources with data consensus.
***
## Next steps
Learn how default routing works and try it without an API key.
Configure custom failover lists for maximum reliability.
Optimize for cost and performance automatically.
Verify data accuracy across multiple providers.
***
## Common pitfalls
**Free tier limitations** - Default routing on the free tier has rate limits suitable for testing only. Upgrade to Growth or higher for production use.
**Data consensus latency** - Data consensus adds \~100-200ms latency as it queries multiple providers. Only enable for critical data where accuracy is paramount.
**Retry latency** - Auto-retry adds latency to failed requests (1-7 seconds depending on configuration). Factor this into timeout settings.
***
Create your free account and start building with unified blockchain infrastructure across 300+ chains.
Explore all available endpoints and interactive playgrounds
# Backup providers
Source: https://docs.uniblock.dev/guides/uniblock/autorouting/uniblock-backup
Configure backup providers in Uniblock so requests automatically fail over when your primary provider is down, rate-limited, or returning errors.
## What are backup providers?
Backup providers help prevent failures caused by a single provider issue. When your primary provider is unavailable, hits a provider-specific rate limit, or returns errors, Uniblock automatically routes requests to backup providers in your configured priority list.
If you receive a `429` from Uniblock itself, that means your project has reached the request limit available under your current Uniblock plan. In that case, backup providers do not override the plan-level limit.
**Use backup providers when you need:**
* 99.99%+ uptime guarantees
* Protection against provider outages
* Automatic provider failover when an upstream provider is rate-limited
* Zero-downtime failover
Backup providers are enabled by default for all Uniblock users. No configuration required.
***
## How it works
Uniblock maintains a priority list (fallback list) of providers for each endpoint category. When a request fails:
1. **Primary attempt** - Request goes to your top-priority provider
2. **Failure detection** - System detects failure (timeout, rate limit, 5xx error, invalid key)
3. **Automatic failover** - Request immediately routes to next provider in list
4. **Seamless response** - Your application receives the response without knowing a failover occurred
Backup providers handle upstream provider failures and provider-specific rate limits. Uniblock plan limits still apply separately, and a `429` response from Uniblock means your project has exceeded the request rate included with your current plan.
***
## Fallback list types
### Internal fallback (default)
Uniblock's pre-configured provider list optimized for reliability and cost.
**Characteristics:**
* No setup required
* Enabled by default for all users
* Optimized based on real-time provider performance
* Includes 55+ blockchain data providers
* Automatically updated as provider performance changes
**Example internal fallback list for token balances:**
1. Covalent (lowest cost, high reliability)
2. Moralis (medium cost, high reliability)
3. Alchemy (higher cost, highest reliability)
4. QuickNode (backup)
```bash Using internal fallback (default) theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/token/balances?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb' \
--header 'x-api-key: YOUR_API_KEY'
```
If Covalent fails → automatically tries Moralis → then Alchemy → then QuickNode.
### External keys fallback (custom)
Bring your own provider API keys and configure custom priority lists.
**Characteristics:**
* Use your existing provider credits
* Full control over provider priority
* Uniblock auto-routing as final fallback
* Configure different lists per endpoint category
**Example custom fallback list:**
1. Your Alchemy key (primary)
2. Your Infura key (backup)
3. Your QuickNode key (backup)
4. Uniblock auto-routing (final fallback)
**Benefits of this approach:**
* Consume your own provider credits first
* Uniblock provides ultimate reliability as final backup
* Custom routing based on your provider relationships
* Unified management of all provider keys
[Learn how to configure custom fallback lists →](/guides/uniblock/autorouting/dashboard-integrations)
***
## Common failure scenarios
### Upstream provider rate limit exceeded
**Scenario:** Your Alchemy key hits its own provider rate limit (300 requests/second).
**What happens:**
1. Request #301 fails with rate limit error
2. Uniblock detects rate limit response
3. Request automatically routes to Infura (next in list)
4. Your app receives successful response
**Result:** Zero downtime, seamless failover for that provider-specific limit.
This is different from a Uniblock `429`. A Uniblock `429` means your project has reached the request limit included with your current plan, not that a backup provider should be tried.
### Provider outage
**Scenario:** Infura experiences a service outage.
**What happens:**
1. Request times out after 5 seconds
2. Uniblock detects timeout
3. Request automatically routes to QuickNode
4. Your app receives successful response
**Result:** Your users never notice the outage.
### Invalid API key
**Scenario:** Your provider API key expires or is invalid.
**What happens:**
1. Request fails with 401 authentication error
2. Uniblock detects invalid key
3. Request automatically routes to next provider
4. Dashboard alerts you to update the key
**Result:** Service continues while you fix the key.
### Provider-specific error
**Scenario:** Provider returns 5xx server error.
**What happens:**
1. Request fails with 500 internal server error
2. Uniblock detects server error
3. Request automatically routes to next provider
4. Your app receives successful response
**Result:** Provider issues don't affect your application.
***
## Configuration example
Here's how a custom fallback list works with your own provider keys:
In the [Uniblock dashboard](https://dashboard.uniblock.dev), add your provider API keys:
* Alchemy: `alch_abc123...`
* Infura: `infura_xyz789...`
* QuickNode: `qn_def456...`
Set your fallback order for token endpoints:
1. Alchemy (your key)
2. Infura (your key)
3. QuickNode (your key)
4. Uniblock auto-routing (final backup)
```bash theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/token/balances?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb' \
--header 'x-api-key: YOUR_UNIBLOCK_KEY'
```
If Alchemy fails, Uniblock automatically tries Infura, then QuickNode, then its own provider pool. Your code never changes.
***
## Key benefits
Achieve 99.99%+ uptime with multi-provider redundancy.
Automatic provider switching transparent to your application.
Reduce provider-specific rate limit failures by automatically switching to backup providers.
Use cheaper providers first, expensive ones as backup.
***
## Monitoring and alerts
Track failover events in the Uniblock dashboard:
* **Failover count** - How many times backup providers were used
* **Provider health** - Real-time status of each provider
* **Error breakdown** - Types of failures triggering failovers
* **Cost analysis** - Which providers are being used most
**Alerts available:**
* Provider key expiration warnings
* High failover rate notifications
* Provider performance degradation alerts
***
## Best practices
**Use Uniblock auto-routing as final fallback** - Even with your own provider keys, add Uniblock auto-routing as the last item in your priority list for ultimate reliability.
**Configure different lists per endpoint category** - Token endpoints may need different providers than NFT endpoints. Optimize each category separately.
**Monitor failover rates** - High failover rates indicate issues with your primary provider. Review and adjust your priority list.
**Test your fallback configuration** - Temporarily disable your primary provider to verify failover works as expected.
***
## Next steps
Set up custom fallback lists with your own provider keys.
Learn how auto-retry works before failover occurs.
Optimize provider selection for cost and performance.
Monitor provider health and failover events.
***
## Common pitfalls
**Don't rely on a single provider** - Even with backup providers, test your configuration to ensure failover works correctly.
**Provider key expiration** - Set up alerts for expiring provider keys. Expired keys trigger unnecessary failovers.
**Inconsistent data across providers** - Different providers may return slightly different data formats. Test thoroughly when switching providers.
**Cost implications** - Backup providers may have different pricing. Monitor which providers are being used to manage costs effectively.
***
Create your free account and start building with unified blockchain infrastructure across 300+ chains.
Explore all available endpoints and interactive playgrounds
# Data consensus
Source: https://docs.uniblock.dev/guides/uniblock/autorouting/uniblock-data-consensus
Verify blockchain response accuracy by cross-checking data across multiple providers, filtering anomalies, and picking a majority value automatically.
## What is data consensus?
Data consensus verifies API response data by querying multiple blockchain providers and comparing their responses. This ensures the data you receive is accurate, consistent, and free from provider-specific errors or anomalies.
**Use data consensus when you need:**
* Guaranteed data accuracy for critical operations
* Protection against provider data errors
* Verification of financial data (prices, balances)
* Confidence in high-stakes transactions
Data consensus is automatically enabled for all Uniblock users.
***
## How it works
When data consensus is enabled, Uniblock follows this process:
1. **Primary request** - Query your primary provider
2. **Parallel verification** - Simultaneously query 2-3 additional providers
3. **Compare responses** - Analyze data from all providers
4. **Detect outliers** - Identify responses that deviate significantly
5. **Return consensus** - Provide verified data based on majority agreement
***
## Why data consensus matters
### Without data consensus
A single provider error can cause critical issues:
```json Provider returns incorrect price theme={null}
{
"tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"symbol": "USDC",
"price": 25.0 // WRONG: should be $1.00
}
```
**Consequences:**
* Incorrect portfolio valuations
* Failed trading decisions
* User trust issues
* Financial losses
### With data consensus
Errors are detected and filtered:
```
Provider A: $1.00
Provider B: $1.01
Provider C: $25.00 (outlier detected)
Consensus result: $1.00
```
**Benefits:**
* Accurate data guaranteed
* Outliers automatically filtered
* Confidence in critical operations
* Protection against provider bugs
***
## Supported endpoints
Data consensus works with these endpoint categories:
### Token endpoints
* Token prices
* Token balances
* Token transfers
* Token allowances
### NFT endpoints
* NFT floor prices
* NFT metadata
* NFT ownership
* Collection stats
### Transaction endpoints
* Transaction receipts
* Gas prices
* Block data
### Market data endpoints
* Token prices
* Trading volume
* Market cap
Data consensus is not available for JSON-RPC endpoints or provider-specific
features.
***
## Performance impact
Data consensus adds latency as it queries multiple providers:
| Providers queried | Added latency | Use case |
| ----------------- | ------------- | --------------------- |
| **2 providers** | \~50-100ms | Low-latency needs |
| **3 providers** | \~100-200ms | Standard verification |
| **4 providers** | \~150-300ms | Maximum accuracy |
**Optimization tips:**
* Enable only for critical endpoints
* Use lower provider counts for time-sensitive operations
* Cache consensus results when appropriate
* Disable for non-critical data
***
## Key benefits
Cross-verify data across multiple sources for guaranteed accuracy.
Automatically detect and filter provider errors and anomalies.
Minimize impact of incorrect data on critical operations.
Make decisions based on verified, consensus-based data.
***
## When to use data consensus
### Use data consensus for:
* **Token prices** - Critical for trading, swaps, portfolio valuation
* **Token balances** - Important for transaction validation
* **NFT floor prices** - Essential for marketplace accuracy
* **Gas prices** - Affects transaction cost calculations
* **Financial calculations** - Any data affecting money
***
## Next steps
Learn how auto-retry works with data consensus.
Configure provider fallback lists for consensus queries.
Optimize provider selection for consensus queries.
Configure consensus settings and monitor metrics.
***
## Common pitfalls
**Using for all endpoints** - Data consensus adds latency and cost. Only
enable for critical data.
**Too strict thresholds** - Overly strict outlier detection may flag valid
variations. Use moderate settings.
**Ignoring outlier patterns** - Frequent outliers from one provider indicate
reliability issues. Investigate and adjust.
**Not accounting for latency** - Consensus adds 100-300ms. Factor this into
timeout and UX design.
***
Create your free account and start building with unified blockchain infrastructure across 300+ chains.
Explore all available endpoints and interactive playgrounds
# Data normalization
Source: https://docs.uniblock.dev/guides/uniblock/autorouting/uniblock-data-normalization
Uniblock data normalization converts provider-specific responses into a consistent unified schema so you can switch providers without changing code.
## What is data normalization?
Data normalization automatically converts provider-specific response formats into a consistent, unified schema. This eliminates the need to write provider-specific parsing logic or handle format variations across different data sources.
**Use data normalization when you need:**
* Consistent data formats regardless of provider
* Zero provider-specific parsing logic
* Seamless provider switching without code changes
* Predictable data structures across all endpoints
Data normalization is enabled by default for all Uniblock users. All responses
follow the same schema regardless of underlying provider.
***
## How it works
Different providers return blockchain data in different formats. Uniblock normalizes all responses into a consistent schema:
1. **Provider response** - Raw data received from blockchain provider
2. **Schema mapping** - Uniblock maps provider fields to unified schema
3. **Type conversion** - Converts data types (string/number/formatted)
4. **Field enrichment** - Adds missing fields with computed values
5. **Unified response** - Returns consistent format to your application
**Result:** Your code works with any provider without format-specific logic.
***
## Normalization examples
### Token balances
Different providers return token balances in incompatible formats:
| Provider | Balance format | Decimals | Formatted value |
| ------------ | ----------------------- | ----------------- | ----------------- |
| **Alchemy** | `"1000000000"` (string) | Separate field | Not included |
| **Moralis** | `1000000000` (number) | Separate field | Not included |
| **Covalent** | `"1000.00"` (formatted) | Included in value | Already formatted |
**Uniblock normalized response:**
```json theme={null}
{
"balance": "1000000000",
"decimals": 6,
"balanceFormatted": "1000.00"
}
```
**Result:** All three formats unified into single, predictable structure.
### Transaction timestamps
Providers use different timestamp formats:
| Provider | Timestamp format | Example |
| ------------ | ----------------------------- | ------------------------ |
| **Alchemy** | Unix timestamp (seconds) | `1640995200` |
| **Moralis** | ISO 8601 string | `"2022-01-01T00:00:00Z"` |
| **Covalent** | Unix timestamp (milliseconds) | `1640995200000` |
**Uniblock normalized response:**
```json theme={null}
{
"timestamp": 1640995200,
"timestampISO": "2022-01-01T00:00:00Z",
"blockNumber": 13916166
}
```
**Result:** Both Unix and ISO formats provided for flexibility.
### NFT metadata
NFT metadata structures vary significantly across providers:
**Alchemy format:**
```json theme={null}
{
"contract": { "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D" },
"id": { "tokenId": "1" },
"title": "Bored Ape #1",
"metadata": {
"image": "ipfs://QmRRPWG96cmgTn2qSzjwr2qvfNEuhunv6FNeMFGa9bx6mQ",
"attributes": [{ "trait_type": "Background", "value": "Orange" }]
}
}
```
**Moralis format:**
```json theme={null}
{
"token_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"token_id": "1",
"name": "Bored Ape #1",
"image": "ipfs://QmRRPWG96cmgTn2qSzjwr2qvfNEuhunv6FNeMFGa9bx6mQ",
"metadata": "{\"attributes\":[{\"trait_type\":\"Background\",\"value\":\"Orange\"}]}"
}
```
**Uniblock normalized response:**
```json theme={null}
{
"contractAddress": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
"tokenId": "1",
"name": "Bored Ape #1",
"description": "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs",
"image": "ipfs://QmRRPWG96cmgTn2qSzjwr2qvfNEuhunv6FNeMFGa9bx6mQ",
"imageUrl": "https://ipfs.io/ipfs/QmRRPWG96cmgTn2qSzjwr2qvfNEuhunv6FNeMFGa9bx6mQ",
"attributes": [
{
"traitType": "Background",
"value": "Orange"
}
]
}
```
**Result:** Consistent structure with both IPFS and HTTP URLs, parsed attributes, and camelCase fields.
***
## Real-world scenarios
### Scenario 1: Multi-provider portfolio tracker
**Challenge:** Building a portfolio tracker that aggregates data from multiple providers, each with different response formats.
**Without normalization:**
```javascript theme={null}
// Provider-specific parsing logic required
function parseBalance(provider, response) {
if (provider === 'alchemy') {
return {
balance: response.tokenBalance,
decimals: response.decimals,
formatted: formatBalance(response.tokenBalance, response.decimals),
};
} else if (provider === 'moralis') {
return {
balance: response.balance.toString(),
decimals: response.decimals,
formatted: formatBalance(response.balance, response.decimals),
};
} else if (provider === 'covalent') {
return {
balance: parseFormattedBalance(response.balance),
decimals: extractDecimals(response.balance),
formatted: response.balance,
};
}
}
```
**With Uniblock normalization:**
```javascript theme={null}
// Single parsing logic works for all providers
const response = await fetch('https://api.uniblock.dev/uni/v1/token/balances', {
headers: { 'x-api-key': 'YOUR_API_KEY' },
});
const data = await response.json();
// Always has: balance, decimals, formattedBalance
console.log(data.formattedBalance); // Works regardless of provider
```
**Result:** 90% less code, zero provider-specific logic.
### Scenario 2: NFT marketplace integration
**Challenge:** Displaying NFT collections from multiple providers with consistent metadata.
**Request:**
```bash theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/nft/collection?chainId=1&contractAddress=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&limit=20' \
--header 'x-api-key: YOUR_API_KEY'
```
**Normalized response:**
```json theme={null}
{
"nfts": [
{
"contractAddress": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
"tokenId": "1",
"name": "Bored Ape #1",
"description": "The Bored Ape Yacht Club...",
"image": "ipfs://QmRRPWG96cmgTn2qSzjwr2qvfNEuhunv6FNeMFGa9bx6mQ",
"imageUrl": "https://ipfs.io/ipfs/QmRRPWG96cmgTn2qSzjwr2qvfNEuhunv6FNeMFGa9bx6mQ",
"owner": "0x789...",
"attributes": [
{ "traitType": "Background", "value": "Orange" },
{ "traitType": "Eyes", "value": "Bored" }
]
}
]
}
```
**Result:** Consistent NFT structure with resolved IPFS URLs and parsed attributes.
***
## Normalized field types
Uniblock ensures consistent data types across all providers:
### Address fields
**Always returned as:**
* Checksummed Ethereum addresses
* Lowercase for consistency in comparisons
* Validated format
```json theme={null}
{
"address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
}
```
### Numeric values
**Always returned as:**
* String for large numbers (prevents precision loss)
* Formatted decimal version included
* Original decimals preserved
```json theme={null}
{
"balance": "1000000000000000000",
"formattedBalance": "1.0",
"decimals": 18
}
```
### Timestamps
**Always returned as:**
* Unix timestamp (seconds)
* ISO 8601 string
* Block number for reference
```json theme={null}
{
"timestamp": 1640995200,
"timestampISO": "2022-01-01T00:00:00Z",
"blockNumber": 13916166
}
```
### Boolean values
**Always returned as:**
* Native boolean type (not strings)
* Consistent naming (isActive, hasMetadata)
```json theme={null}
{
"isVerified": true,
"hasMetadata": false
}
```
***
## Key benefits
No provider-specific code needed. Single schema works everywhere.
Switch providers without changing your application code.
Consistent data types prevent runtime errors and type mismatches.
Build faster without handling format variations across providers.
***
## Field mapping reference
Common provider field variations and their normalized equivalents:
| Data type | Provider variations | Uniblock normalized |
| -------------------- | ---------------------------------------------- | ------------------- |
| **Token balance** | `tokenBalance`, `balance`, `value` | `balance` |
| **Decimals** | `decimals`, `decimal`, `token_decimal` | `decimals` |
| **Contract address** | `contract`, `token_address`, `contractAddress` | `contractAddress` |
| **Token ID** | `tokenId`, `token_id`, `id.tokenId` | `tokenId` |
| **Transaction hash** | `hash`, `tx_hash`, `transactionHash` | `hash` |
| **Block number** | `blockNumber`, `block_number`, `block` | `blockNumber` |
| **Timestamp** | `timestamp`, `block_timestamp`, `timeStamp` | `timestamp` |
| **Gas used** | `gasUsed`, `gas_used`, `gas` | `gasUsed` |
| **NFT image** | `image`, `image_url`, `metadata.image` | `image`, `imageUrl` |
| **NFT attributes** | `attributes`, `traits`, `metadata.attributes` | `attributes` |
***
## Handling edge cases
Uniblock normalization handles common edge cases automatically:
### Null and missing values
**Provider behavior:**
* Some providers return `null`
* Others omit the field entirely
* Some return empty strings
**Uniblock normalization:**
```json theme={null}
{
"balance": "0",
"balanceFormatted": "0.0",
"metadata": null
}
```
**Result:** Consistent null handling and default values.
### IPFS URLs
**Provider behavior:**
* Some return `ipfs://` URIs
* Others return gateway URLs
* Some return raw CIDs
**Uniblock normalization:**
```json theme={null}
{
"image": "ipfs://QmRRPWG96cmgTn2qSzjwr2qvfNEuhunv6FNeMFGa9bx6mQ",
"imageUrl": "https://ipfs.io/ipfs/QmRRPWG96cmgTn2qSzjwr2qvfNEuhunv6FNeMFGa9bx6mQ"
}
```
**Result:** Both IPFS URI and HTTP gateway URL provided.
### Large numbers
**Provider behavior:**
* Some return numbers (lose precision for large values)
* Others return strings
* Some return scientific notation
**Uniblock normalization:**
```json theme={null}
{
"balance": "1000000000000000000",
"balanceFormatted": "1.0",
"decimals": 18
}
```
**Result:** String format preserves precision, formatted version for display.
### Case sensitivity
**Provider behavior:**
* Some use camelCase
* Others use snake\_case
* Some use PascalCase
**Uniblock normalization:**
```json theme={null}
{
"contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"tokenId": "1",
"blockNumber": 13916166
}
```
**Result:** Consistent camelCase across all fields.
***
## Best practices
**Use normalized fields directly** - Don't re-parse or transform normalized
responses. They're already in optimal format.
**Rely on formatted values** - Use `balanceFormatted`, `valueFormatted` for
display instead of manual formatting.
**Trust type consistency** - Normalized responses have consistent types. No
need for type guards or conversions.
**Use both timestamp formats** - `timestamp` for calculations, `timestampISO`
for display and logging.
***
## Monitoring normalization
Track normalization metrics in the [Uniblock dashboard](https://dashboard.uniblock.dev):
* **Normalization success rate** - Percentage of responses successfully normalized
* **Field mapping coverage** - Which provider fields are being mapped
* **Type conversion errors** - Rare cases where normalization fails
* **Provider format changes** - Alerts when providers change response formats
**Use these metrics to:**
* Ensure consistent data quality
* Identify provider format changes early
* Understand which providers require most normalization
* Validate data integrity across providers
***
## Next steps
Learn how Uniblock fills data gaps across providers.
Verify data accuracy by comparing multiple providers.
Explore normalized response schemas for all endpoints.
Monitor normalization metrics and data quality.
***
## Common pitfalls
**Don't re-parse normalized data** - Normalized responses are already in
optimal format. Additional parsing adds complexity and potential errors.
**Avoid provider-specific assumptions** - Don't assume data comes from
specific provider. Normalization abstracts provider details.
**Use string types for large numbers** - JavaScript numbers lose precision for values > 2^53. Always use string `balance` field, not numeric conversions.
**Don't mix normalized and raw data** - If using Uniblock, use normalized
responses exclusively. Mixing with raw provider data creates inconsistencies.
***
Create your free account and start building with unified blockchain infrastructure across 300+ chains.
Explore all available endpoints and interactive playgrounds
# Data polyfill
Source: https://docs.uniblock.dev/guides/uniblock/autorouting/uniblock-polyfill
Uniblock data polyfill fills gaps in blockchain data by pulling from alternative providers when your primary provider has missing chains or outages.
## What is data polyfill?
Data polyfill automatically fills gaps in blockchain data when your primary provider has incomplete coverage. Uniblock detects missing data for specific chains, time periods, or data types and seamlessly retrieves it from alternative providers.
**Use data polyfill when you need:**
* Complete historical data across all chains
* Consistent data availability regardless of provider limitations
* Automatic handling of provider-specific gaps
* Zero manual provider switching
Data polyfill is enabled by default for all Uniblock users. No configuration
required.
***
## How it works
Uniblock continuously monitors data completeness across providers. When gaps are detected:
1. **Gap detection** - System identifies missing or incomplete data from primary provider
2. **Provider selection** - Automatically selects best alternative provider for the missing data
3. **Data retrieval** - Fetches complete data from backup provider
4. **Unified response** - Returns complete dataset to your application
**Result:** You always get complete data without manual provider switching.
***
## Polyfill scenarios
### Missing chain coverage
**Scenario:** Provider A has Ethereum data but missing Polygon data.
**What happens:**
1. Request for Polygon token balances sent to Provider A
2. Provider A returns no data or error
3. Uniblock detects missing Polygon coverage
4. Request automatically routes to Provider B (has Polygon data)
5. Complete Polygon data returned to your application
```bash Request with automatic chain polyfill theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/token/balances?chainId=137&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb' \
--header 'x-api-key: YOUR_API_KEY'
```
**Result:** Seamless access to Polygon data even when primary provider doesn't support it.
### Historical data gaps
**Scenario:** Provider C has recent transactions but missing historical data.
**What happens:**
1. Request for transactions from 2020 sent to Provider C
2. Provider C returns only data from 2022 onwards
3. Uniblock detects historical gap (2020-2021)
4. Backfills missing period from Provider D
5. Complete historical dataset returned
```bash Request with automatic historical backfill theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/transactions?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb&startDate=2020-01-01&endDate=2023-12-31' \
--header 'x-api-key: YOUR_API_KEY'
```
**Result:** Complete transaction history without gaps or missing periods.
### Incomplete metadata
**Scenario:** Provider E returns incomplete NFT metadata.
**What happens:**
1. Request for NFT details sent to Provider E
2. Provider E returns basic data but missing image URLs and attributes
3. Uniblock detects incomplete metadata
4. Enriches response with metadata from Provider F
5. Complete NFT data with all fields returned
```bash Request with automatic metadata enrichment theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/nft/metadata?chainId=1&contractAddress=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&tokenId=1' \
--header 'x-api-key: YOUR_API_KEY'
```
**Response with polyfilled metadata:**
```json theme={null}
{
"tokenId": "1",
"name": "Bored Ape #1",
"description": "The Bored Ape Yacht Club...",
"image": "ipfs://QmRRPWG96cmgTn2qSzjwr2qvfNEuhunv6FNeMFGa9bx6mQ",
"attributes": [
{
"trait_type": "Background",
"value": "Orange"
},
{
"trait_type": "Eyes",
"value": "Bored"
}
]
}
```
**Result:** Complete NFT metadata without manual enrichment.
***
## Unified backup
If your primary provider experiences an outage, Uniblock seamlessly switches to backup providers without returning errors to your application.
**Failover chain example:**
1. Primary: Alchemy (fastest, most reliable)
2. Backup 1: QuickNode (high reliability)
3. Backup 2: Ankr (stable fallback)
**Typical failover time:** \< 500ms
***
## Common polyfill scenarios
### Multi-chain applications
**Challenge:** Building a portfolio tracker that supports 20+ chains, but no single provider covers all chains.
**Solution:** Uniblock automatically routes each chain to the provider with best coverage:
* Ethereum → Alchemy
* Polygon → Covalent
* Arbitrum → QuickNode
* Base → Moralis
**Your code:**
```bash Single request, multiple providers behind the scenes theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/portfolio?address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb&chainIds=1,137,42161,8453' \
--header 'x-api-key: YOUR_API_KEY'
```
**Result:** Complete portfolio data across all chains from a single API call.
### Historical analytics
**Challenge:** Analyzing token transfers over 3 years, but provider only has 1 year of history.
**Solution:** Uniblock automatically:
1. Fetches recent data (last year) from primary provider
2. Backfills older data (2+ years ago) from archival provider
3. Merges datasets into single response
**Result:** Complete historical dataset without manual data stitching.
### NFT marketplaces
**Challenge:** Displaying NFT collections with complete metadata, but providers have inconsistent metadata quality.
**Solution:** Uniblock automatically:
1. Fetches basic NFT data from primary provider
2. Enriches with high-quality metadata from specialized NFT providers
3. Returns complete NFT details with images, attributes, and rarity
**Result:** Rich NFT displays without multiple API calls or manual enrichment.
***
## Key benefits
Access all chains and historical periods without provider limitations.
Missing data automatically retrieved from alternative providers.
Works automatically - no setup or manual provider management.
Always receive complete datasets regardless of provider gaps.
***
## Monitoring polyfill activity
Track polyfill events in the Uniblock dashboard:
* **Polyfill count** - How many times data was filled from backup providers
* **Gap types** - Chain coverage, historical data, or metadata gaps
* **Provider usage** - Which providers are filling which gaps
* **Data completeness** - Percentage of requests requiring polyfill
**Insights available:**
* Identify which chains require most polyfilling
* Understand historical data coverage across providers
* Optimize provider selection based on your data needs
***
## Best practices
**Request all needed data in single calls** - Uniblock handles multi-provider
routing automatically. Don't split requests unnecessarily.
**Use date ranges for historical queries** - Specify exact date ranges to help
Uniblock optimize provider selection for historical data.
**Monitor polyfill patterns** - Review dashboard to understand which data
types require most polyfilling. This helps optimize your data strategy.
**Trust the automation** - Don't manually switch providers or implement
fallback logic. Uniblock handles this more efficiently.
***
## Next steps
Learn how backup providers ensure high availability.
Understand automatic retry logic for failed requests.
Optimize provider selection for cost and performance.
Monitor polyfill activity and data completeness.
***
## Common pitfalls
**Don't assume single-provider responses** - Polyfilled responses may combine
data from multiple providers. This is expected and ensures completeness.
**Data format consistency** - While Uniblock normalizes responses, minor
differences may exist between providers. Test thoroughly with your data
models.
**Historical data limits** - Some chains have limited historical data across
all providers. Uniblock polyfills where possible but can't create data that
doesn't exist.
**Metadata quality variance** - NFT metadata quality varies by provider.
Uniblock selects best available sources but metadata completeness depends on
original sources.
***
Create your free account and start building with unified blockchain infrastructure across 300+ chains.
Explore all available endpoints and interactive playgrounds
# Waterfall routing
Source: https://docs.uniblock.dev/guides/uniblock/autorouting/uniblock-waterfall-routing
Waterfall routing overlaps provider attempts in priority order to cut failover latency and tail latency while preserving Uniblock backup behavior.
## What is waterfall routing?
Waterfall routing is the execution model Uniblock uses to reduce failover latency during provider selection. Instead of waiting for one provider to fully fail before the next provider is allowed to start, Uniblock can overlap provider attempts in a controlled sequence.
The current backend implementation uses waterfall execution as the default backup strategy for routed requests. Providers are still tried in priority order, but the system can begin the next provider before the previous one fully finishes when a timeout window is reached.
**Use waterfall routing when you need:**
* Faster recovery from slow or hanging upstream providers
* Lower tail latency during failover
* Priority-ordered backup behavior without strictly serial waiting
* Better resilience when some providers are degraded but not fully down
Waterfall routing works behind the same routed request flow you already use with Uniblock. You do not need a separate API integration to benefit from it.
***
## How it works
At a high level, Uniblock still builds a normal provider priority list first. Waterfall routing changes how that list is executed:
1. **Build execution plan** - Uniblock generates the provider list for the request, applies provider filters, removes disabled or rate-limited options, and preserves the final routing order
2. **Start provider 1** - The top provider begins processing
3. **Wait briefly for a result** - If the provider fulfills the request quickly, execution stops and the response is returned
4. **Open the next step in the waterfall** - If the provider is still pending after the waterfall timeout, Uniblock starts the next provider in the priority list
5. **Return the first fulfilled result** - As soon as one provider fulfills the request, that response wins
6. **Drain remaining work** - Any in-flight handlers are allowed to finish in the background so request history is complete
In the current implementation, the waterfall executor uses:
* A **3 second waterfall timeout**
* Up to **3 concurrent active provider handlers**
* A **first fulfilled result wins** completion rule
***
## What changes compared to standard backup failover?
Traditional backup failover is fully sequential:
1. Try provider A
2. Wait for provider A to succeed or fail
3. Then try provider B
4. Then try provider C
Waterfall routing is still ordered, but it does not force the system to wait for every slow provider to finish before moving on.
### Example timeline
Assume your routed priority list is:
1. Alchemy
2. QuickNode
3. Ankr
With waterfall routing:
1. **0s** - Alchemy starts
2. **3s** - If Alchemy is still hanging, QuickNode starts
3. **6s** - If neither has fulfilled the request, Ankr starts
4. **6.2s** - If QuickNode fulfills successfully, Uniblock returns QuickNode's response immediately
This means a slow provider can still win if it finishes first, but it no longer blocks the rest of the backup chain from starting.
***
## When Uniblock skips a provider before the waterfall
Not every provider in the priority list results in an outbound request. Before a handler is started, Uniblock checks:
* Whether the provider has a handler for that endpoint
* Whether request constraints pass
* Whether the chain is supported
* Whether the provider is allowed by `supportedProviders`
* Whether the provider was filtered out by rate-limit state
* Whether the provider key can be loaded
If any of those checks fail, the provider is skipped and the waterfall advances to the next eligible option without waiting.
***
## Fulfilled vs unfulfilled
Waterfall execution stops only when a provider **fulfills** the request.
Requests are treated as **unfulfilled** when a provider:
* Throws an unhandled handler error
* Returns a provider error
* Times out from the request's point of view
* Fails validation or transform logic
* Cannot satisfy the endpoint constraints
If no provider fulfills the request, Uniblock waits for any remaining in-flight handlers to finish and then returns the normal routed error response.
***
## Relationship to auto-routing and backup providers
Waterfall routing does not replace auto-routing or backup providers. It sits inside that system:
* **Auto-routing** decides the provider priority order
* **Backup providers** define what the next eligible options are
* **Waterfall routing** controls how quickly Uniblock advances through that ordered list
That means waterfall routing improves failover latency without changing the fact that provider order still matters.
If a request is forced to a specific provider, or filtered to a single provider through request options, the waterfall has fewer or no alternate providers to open.
***
## Rate limits and waterfall routing
Waterfall routing helps with **provider-level** failures and slowdowns, but it does not bypass Uniblock plan limits.
* If an upstream provider is unavailable or rate-limited, the waterfall can move to the next eligible provider
* If Uniblock itself returns a `429` because your project hit its plan-level limit, the waterfall does not override that limit
This is the same distinction described in the backup provider flow.
***
## Observability notes
Waterfall execution affects how provider attempts appear in analytics and logs:
* The first provider in the priority list is still the first provider started
* Later providers may begin before earlier providers have fully completed
* History entries can be recorded in **resolution order**, not strict initiation order
That means waterfall attempts may look slightly different from a purely sequential fallback chain when you inspect request history.
***
## Why this design is useful
Waterfall routing is a practical middle ground between two extremes:
* **Strict serial failover** is simple but slow when providers hang
* **Fan-out to every provider at once** is fast but expensive and wasteful
Waterfall routing keeps the cost and control benefits of an ordered backup list while reducing the latency penalty of waiting on degraded providers.
***
## Related guides
See how Uniblock chooses provider order before waterfall execution begins.
Learn how the provider priority list and failover chain are defined.
Compare same-provider retries with next-provider waterfall progression.
See how Uniblock optimizes provider order before executing the request.
***
Create your free account and start building with unified blockchain infrastructure across 300+ chains.
Explore all available endpoints and interactive playgrounds
# Error Codes & Rate Limits
Source: https://docs.uniblock.dev/guides/uniblock/error-codes
Reference for Uniblock UR- error codes covering request validation, JSON-RPC format, response processing, plan-based rate limits, and 429 handling.
This page documents the Uniblock error codes currently defined in the validation catalog. These codes cover:
* Request validation failures
* JSON-RPC request format errors
* Response processing failures
* Success and fallback classification codes
Uniblock `429` responses are plan-based rate limits, not generic validation errors. See [Rate limits](#rate-limits) below for how to handle them.
## Format
Uniblock error codes follow this pattern:
```text theme={null}
UR--
```
Examples:
* `UR-400-02` for an invalid parameter
* `UR-422-01` for an unprocessable provider response
* `UR-200-00` for a successful request classification
## Important behavior for JSON-RPC
Some JSON-RPC validation errors return HTTP `200` with a JSON-RPC error payload instead of an HTTP `4xx` status. In those cases, the Uniblock error code still tells you what went wrong.
This applies to:
* `UR-400-03` Parse Error
* `UR-400-04` Invalid Request
* `UR-400-08` Unsupported Method
* `UR-400-10` JSON-RPC Batch Size Exceeded
## Success and fallback codes
| Code | Title | HTTP Status | Retryable | Meaning |
| ----------- | ------------------ | ----------- | --------- | ------------------------------- |
| `UR-200-00` | Request Successful | `200` | No | Request completed successfully. |
## Request validation codes
| Code | Title | HTTP Status | Retryable | Meaning | Suggested action |
| ----------- | ---------------------------- | ----------- | --------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `UR-400-02` | Invalid Parameter | `400` | No | A query or body parameter is invalid. | Review your request parameters against the endpoint spec. |
| `UR-400-03` | Parse Error | `200` | No | The JSON-RPC request body is not valid JSON. | Fix JSON syntax issues such as malformed objects, trailing commas, or bad escaping. |
| `UR-400-04` | Invalid Request | `200` | No | The JSON-RPC request shape or parameters are invalid. | Ensure the request follows the JSON-RPC 2.0 format and uses valid params. |
| `UR-400-05` | Invalid Pagination | `400` | No | REST pagination exceeded the maximum limit or used an invalid cursor. | Keep page size at `1000` or below and verify the cursor is valid. |
| `UR-400-06` | Invalid Address Format | `400` | No | The blockchain address format is invalid. | Validate the address format for the target chain before sending the request. |
| `UR-400-07` | Invalid Transaction Hash | `400` | No | The transaction hash format is invalid. | Send a valid transaction hash for the target chain. |
| `UR-400-08` | Unsupported Method | `400` | No | The requested JSON-RPC method is not supported or not whitelisted. | Use a supported method for the selected network. |
| `UR-400-10` | JSON-RPC Batch Size Exceeded | `200` | No | The batch contains more than `1000` JSON-RPC calls. | Split large batches into smaller requests. |
## Response processing codes
These codes mean the provider responded successfully at the HTTP layer, but Uniblock could not safely process the response.
| Code | Title | HTTP Status | Retryable | Meaning | Suggested action |
| ----------- | ------------------------------ | ----------- | --------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------ |
| `UR-422-01` | Unprocessable Response | `422` | No | The provider returned a successful response, but the content could not be processed. | Retry later or switch providers if the issue persists. |
| `UR-422-02` | Response Parsing Failed | `422` | No | The provider returned content that could not be parsed as valid JSON. | Retry after a short delay. |
| `UR-422-03` | Response Transformation Failed | `422` | No | The provider response could not be transformed into Uniblock's expected format. | Retry or contact support if it continues. |
| `UR-422-04` | Response Validation Failed | `422` | No | The provider response did not match the expected schema or contained invalid data. | Retry or use another provider if available. |
## Common examples
### Invalid REST parameter
If you send an invalid query or body parameter, Uniblock may return:
```json theme={null}
{
"error": {
"code": "UR-400-02",
"title": "Invalid Parameter"
}
}
```
### Invalid JSON-RPC body
If your JSON-RPC body is malformed, Uniblock may return HTTP `200` with a JSON-RPC error and the matching Uniblock code:
```json theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32700,
"message": "Parse error",
"uniblockCode": "UR-400-03"
}
}
```
### Provider response could not be normalized
If an upstream provider responds in an unexpected format, Uniblock may return:
```json theme={null}
{
"error": {
"code": "UR-422-03",
"title": "Response Transformation Failed"
}
}
```
## How to troubleshoot
1. Identify the Uniblock code returned in the response.
2. Check whether the issue is a request validation problem, a rate limit, or a provider response problem.
3. Fix request formatting issues locally before retrying.
4. If the code is in the `UR-422-*` family and persists, retry later or contact support with the request ID.
## Rate limits
If you receive a `429` error, your project has reached the request limit included with your current Uniblock plan.
A `429` does **not** mean Uniblock is down. It means your traffic exceeded your
current plan window.
### Rate-limit quick reference
| Question | Short answer |
| -------------------------- | ------------------------------------------------ |
| What triggers `429`? | Request rate above your plan limit |
| Is this provider-specific? | No, this is Uniblock plan-level |
| Should I retry? | Yes, with delay/backoff |
| Do backups bypass `429`? | No, backup routing does not override plan limits |
| Long-term fix? | Reduce traffic, optimize usage, or upgrade plan |
### What should I do if I hit a rate limit?
Add exponential backoff and jitter before retrying `429` responses.
Lower polling frequency, cache stable data, and batch requests where possible.
Verify whether release changes, cron jobs, or retries increased request volume.
If sustained demand exceeds your current allowance, upgrade to a plan with more throughput.
### Retry pattern (recommended)
```javascript theme={null}
// Exponential backoff with jitter for 429 responses.
async function requestWithBackoff(fn, maxRetries = 5) {
for (let attempt = 0; attempt <= maxRetries; attempt++) {
const res = await fn();
if (res.status !== 429) return res;
if (attempt === maxRetries) return res;
const base = 250 * Math.pow(2, attempt);
const jitter = Math.floor(Math.random() * 200);
await new Promise((r) => setTimeout(r, base + jitter));
}
}
```
### Rate limit FAQ
#### Are rate limits based on my Uniblock plan?
Yes. Rate limits are based on the limits included with your Uniblock plan.
#### Does a 429 mean the API is down?
No. A `429` means your project has exceeded its allowed request rate. It does not mean the platform is unavailable.
#### Will requests start working again?
Yes. Once traffic falls back within your allowed limit window, requests will succeed again.
#### Can I increase my rate limits?
Yes. If you need more throughput, please upgrade your plan or contact us to discuss a plan that matches your usage.
#### Should I retry 429 responses?
Yes, but retries should include a short delay or exponential backoff to avoid sending another burst immediately.
#### Do backup providers avoid 429 errors?
No. Backup providers help with upstream provider failures, but they do not bypass your Uniblock plan limits.
### Example 429 response
```json theme={null}
{
"error": {
"code": 429,
"message": "Too Many Requests"
}
}
```
## Related guides
* [Authentication](/guides/uniblock/authentication)
* [Analytics & Logs](/guides/uniblock/uniblock-analytics)
# Uniblock FAQ: API keys, routing, errors, and rate limits
Source: https://docs.uniblock.dev/guides/uniblock/faq
Answers to common Uniblock questions on API keys, auto-routing, backup providers, rate limits, errors, plan pricing, and debugging in production.
This page collects the most useful answers for teams evaluating, integrating, or operating Uniblock in production.
Looking for a full product introduction? Start with [Uniblock
Overview](/guides/uniblock/overview-uniblock).
## Quick links
First API call, authentication basics, and quickstart path.
Auto-routing, backup behavior, and provider failover.
429/4xx guidance, JSON-RPC behavior, and debug flow.
APIs, chain/provider coverage, MCP, and support.
## At a glance
| Topic | Short answer |
| -------------------- | -------------------------------------------- |
| Authentication | Send API key via `x-api-key` |
| Auto-routing default | Enabled by default |
| `429` meaning | Plan-level rate limit reached |
| Normalized responses | Yes, for common Unified API endpoints |
| Backup providers | Help with provider failures, not plan limits |
## What is Uniblock?
Uniblock is a blockchain infrastructure layer that gives you one unified API across many chains and providers. Instead of integrating directly with providers like Alchemy, QuickNode, Infura, Moralis, or Covalent one by one, you send requests through Uniblock and get:
* One API key
* Auto-routing across providers
* Backup failover when providers have issues
* Normalized response formats
* Access to many supported chains through the same interface
If you are just getting started, use the [Unified API Quickstart](/guides/uniblock/unified-api-quickstart).
## Why use Uniblock instead of integrating with a single provider directly?
Use Uniblock when you want to reduce provider management overhead and improve reliability. A direct provider integration can be simpler if you only need one chain and one provider, but Uniblock is usually more valuable when you need:
* Multi-chain coverage
* Automatic failover
* Consistent schemas across providers
* Centralized analytics and logs
* One integration instead of managing multiple provider APIs and keys
## How do I make my first API call?
1. Create a project in the dashboard.
2. Copy your Uniblock API key.
3. Send the key in the request header.
4. Call a Unified API endpoint.
Example:
```bash theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/token/balances?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb' \
--header 'x-api-key: YOUR_API_KEY'
```
For a step-by-step walkthrough, see [Unified API Quickstart](/guides/uniblock/unified-api-quickstart).
## How do I authenticate requests?
Include your Uniblock API key in the request header as `x-api-key`. Every request to the Unified API should include a valid project key.
If you need more detail, see [Authentication](/guides/uniblock/authentication).
## Is auto-routing enabled by default?
Yes. Auto-routing is enabled by default for all Uniblock API keys. You do not need to manually choose a provider for standard usage.
Uniblock evaluates providers for reliability, latency, and cost, routes to the best available option, retries failures, and fails over to backups when needed.
See [Auto-routing](/guides/uniblock/autorouting/uniblock-auto-routing) for the full flow.
## Do backup providers prevent all failures?
No. Backup providers help when an upstream provider is unavailable, returns errors, or hits its own provider-specific limit. They do not override Uniblock plan-level limits.
If Uniblock returns a `429`, that means your project has reached the request limit included with your current plan. That is different from a provider-specific failure inside the routing layer.
See:
* [Backup Providers](/guides/uniblock/autorouting/uniblock-backup)
* [Error Codes & Rate Limits](/guides/uniblock/error-codes#rate-limits)
## What does a 429 mean?
A `429` means your project has reached the request limit available under your current Uniblock plan.
It does not mean:
* The API is down
* A provider outage occurred
* Backup routing failed
In most cases, you should reduce request frequency, retry with backoff, or move to a plan with more throughput.
## Does Uniblock normalize provider responses?
Yes. Uniblock transforms provider-specific responses into a unified format so your application does not need provider-specific parsing logic for common Unified API endpoints.
This is one of the main reasons to use Uniblock for multi-provider and multi-chain applications.
## Can I bring my own provider keys?
Yes. Uniblock supports custom fallback lists with external provider keys, which lets you consume your own provider credits first and keep Uniblock auto-routing as a final fallback.
This is useful if you already have relationships or spend commitments with specific providers.
See [Backup Providers](/guides/uniblock/autorouting/uniblock-backup).
## What is data consensus, and when should I use it?
Data consensus queries multiple providers and compares results to improve confidence in the returned data. It is most useful for critical reads where correctness matters more than the extra latency and cost.
Use it selectively for things like:
* Critical balance checks
* Pricing-sensitive workflows
* Auditing or verification flows
## Why did I get a 403?
Common reasons include:
* Your API key or project credentials are missing or invalid
* The API key has been disabled
* Your project does not have permission for the requested endpoint
* Your project does not have access to the requested blockchain network
If the response includes a Uniblock error code, check [Error Codes & Rate Limits](/guides/uniblock/error-codes) first and then verify your project configuration in the dashboard.
Fast triage for `403`: verify API key validity, endpoint access, and chain
permissions in the dashboard before retrying.
## Why did I get a 400?
A `400` usually means the request itself is invalid. Common examples include:
* Invalid query or body parameters
* Invalid blockchain address format
* Invalid transaction hash format
* Unsupported JSON-RPC method
* Pagination or cursor errors
These are usually not retryable until you fix the request.
## Why did I get a 422?
A `422` means the upstream provider returned a successful HTTP response, but Uniblock could not safely parse, transform, or validate the content.
This usually points to a provider response problem rather than a malformed request from your application.
If it persists:
1. Retry after a short delay.
2. Check API logs and request details.
3. Contact support with the request ID if the issue continues.
Persistent `UR-422-*` errors usually indicate an upstream response issue.
Include request ID and endpoint when contacting support.
## Why do I see "gas required exceeds" on `eth_call` or `eth_estimateGas`?
Public JSON-RPC providers apply a gas cap to `eth_call` and `eth_estimateGas` to protect shared infrastructure. The most common cap is `16777216` (2^24, roughly 16.7 million), which produces errors like:
```text theme={null}
gas required exceeds allowance (16777216)
```
This cap is enforced by the upstream provider that Uniblock routed the request to, not by Uniblock itself. It applies to simulation and gas-estimation calls, and to large contract deployments that would exceed the cap during estimation.
To work around it:
1. **Bring your own provider key.** Add an API key from a provider whose plan allows a higher gas cap and route through it via [Add Your Own API Key](/guides/uniblock/autorouting/add-your-own-api-key). Requests then consume your provider's quota with its configured limits.
2. **Use a direct provider integration.** For provider-specific behavior that the shared RPC does not expose, use a [Direct Provider](/reference/direct/direct-providers/overview) endpoint tied to a provider account you control.
3. **Set an explicit `gas` value.** If your client is calling `eth_estimateGas` before a transaction, pass a known-good `gas` value in the transaction to skip estimation.
4. **Contact support.** If none of the above work for a deployment or simulation you need to run, reach out with the request ID and target chain so the team can advise on the right routing.
## Why do some JSON-RPC errors return HTTP 200?
JSON-RPC errors can be returned inside a valid JSON-RPC response body while the HTTP layer still returns `200`. In those cases, the transport succeeded, but the JSON-RPC request itself failed.
That is why you may see things like:
* Parse error
* Invalid request
* Batch size exceeded
with an HTTP `200` plus a JSON-RPC error payload.
## How do I debug failed requests?
Start with these steps:
1. Check the HTTP status code.
2. Check the Uniblock error code if present.
3. Review the request parameters and headers.
4. Inspect API logs in the dashboard.
5. Look at provider attempts and failures if failover occurred.
The most useful docs are:
* [Analytics & Logs](/guides/uniblock/uniblock-analytics)
* [Error Codes & Rate Limits](/guides/uniblock/error-codes)
## Debug checklist
Determine whether the failure is auth/permissions (`403`), request-shape (`400`), rate-limit (`429`), or response-processing (`422`).
Confirm headers, params, chain ID, and endpoint path. Keep the request ID for escalation.
Use dashboard API logs to inspect latency, provider attempts, and failover paths.
Share request ID, endpoint, time window, and sample payload with support.
## Where can I see which provider handled my request?
Use the API logs in the dashboard. Logs help you inspect request status, endpoint, response time, and provider activity, including failover attempts where applicable.
## Which APIs does Uniblock support?
Uniblock provides unified access across multiple API categories, including:
* Token APIs
* NFT APIs
* Transaction APIs
* Market data APIs
* Scans APIs
* JSON-RPC
The exact endpoint list is available in the API reference and explorer.
## Which chains and providers are supported?
Uniblock supports many blockchains and integrates with many blockchain data providers. The docs describe support for 300+ blockchains and 55+ providers.
For chain-by-chain details, check the supported chains and API reference sections in the docs.
## Does Uniblock support MCP?
Yes. Uniblock provides an MCP server that can be connected to compatible AI clients. This exposes Uniblock tools and Unified API endpoints through MCP.
See [MCP Setup](/reference/unified-api/uniblock-mcp-setup).
## What are Uniblock's official domains?
Uniblock operates across multiple domains for marketing and outreach. Use the list below to verify you're interacting with an official Uniblock property.
| Domain | What it's used for |
| -------------------------------------------------------- | ------------------------------------- |
| [uniblock.dev](https://uniblock.dev) | Main website and product entry points |
| [getuniblock.com](https://getuniblock.com) | Outreach and campaign landing pages |
| [docs.uniblock.dev](https://docs.uniblock.dev) | Documentation (you are here) |
| [dashboard.uniblock.dev](https://dashboard.uniblock.dev) | Dashboard (projects, API keys, usage) |
## When should I contact support?
Contact support when:
* You continue seeing the same `UR-422-*` response-processing issue
* Your project appears misconfigured but the dashboard does not explain why
* Your API key was disabled unexpectedly
* You need higher limits or custom access
* You have a request ID tied to a persistent internal or unclassified error
## What should I read next?
* [Overview](/guides/uniblock/overview-uniblock)
* [Unified API Quickstart](/guides/uniblock/unified-api-quickstart)
* [Auto-routing](/guides/uniblock/autorouting/uniblock-auto-routing)
* [Authentication](/guides/uniblock/authentication)
* [Analytics & Logs](/guides/uniblock/uniblock-analytics)
* [Error Codes & Rate Limits](/guides/uniblock/error-codes)
***
Create your free account and start building with unified blockchain infrastructure across 300+ chains.
Explore all available endpoints and interactive playgrounds
# Uniblock overview: unified APIs and auto-routing
Source: https://docs.uniblock.dev/guides/uniblock/overview-uniblock
How Uniblock simplifies multi-chain development with a unified API, auto-routing across 55+ providers, and normalized data across 300+ blockchains.
## What Uniblock does
Uniblock is a blockchain infrastructure layer that abstracts away the complexity of working with multiple data providers and chains. Instead of managing dozens of API keys, handling provider outages, and normalizing inconsistent data formats, you get one unified interface that works everywhere.
**Core value proposition:**
* **One API key** replaces 55+ provider integrations
* **Auto-routing** ensures requests always succeed via intelligent failover
* **Normalized data** provides consistent formats across all providers
* **Multi-chain support** for 300+ blockchains with identical API patterns
New to Uniblock? Start with the [Quickstart
Guide](/guides/getting-started/uniblock-quickstart-guide) to make your first
API call in 5 minutes.
***
## How it works
When you make a request to Uniblock:
1. **Request received** - Your API call hits Uniblock's routing layer
2. **Provider selection** - Auto-routing picks the optimal provider based on reliability, latency, and cost
3. **Data retrieval** - Request is sent to the selected provider (e.g., Alchemy, QuickNode, Covalent)
4. **Normalization** - Response is transformed into Uniblock's unified format
5. **Validation** - Data is verified for completeness and accuracy
6. **Failover** - If the provider fails, request automatically retries with backup providers
7. **Response** - You receive consistent, reliable data
```bash Example: Token balance request theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/token/balances?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb' \
--header 'x-api-key: YOUR_API_KEY'
```
```json Response: Normalized across all providers theme={null}
{
"data": [
{
"tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"symbol": "USDC",
"balance": "1000000000",
"decimals": 6,
"balanceFormatted": "1000.00",
"valueUsd": "1000.00"
}
]
}
```
***
## Key features
### Auto-routing
Uniblock automatically routes requests to the best available provider based on real-time performance metrics. If a provider is down or slow, requests instantly failover to backup providers.
**Benefits:**
* **99.9% uptime** - No single point of failure
* **Optimized latency** - Routes to fastest provider for your region
* **Cost efficiency** - Balances requests across providers to minimize costs
* **Zero configuration** - Works automatically, no manual setup required
**How it works:**
* Monitors provider health in real-time
* Tracks latency, error rates, and success rates
* Maintains fallback chains for every endpoint
* Retries failed requests automatically
[Learn more about auto-routing →](/guides/uniblock/autorouting/uniblock-auto-routing)
### Data normalization
Different providers return data in different formats. Uniblock normalizes all responses into a consistent schema, so you never have to write provider-specific parsing logic.
**Example: Token balance formats**
| Provider | Balance format | Decimals |
| -------- | ----------------------- | -------------- |
| Alchemy | `"1000000000"` (string) | Separate field |
| Moralis | `1000000000` (number) | Separate field |
| Covalent | `"1000.00"` (formatted) | Included |
**Uniblock normalized:**
```json theme={null}
{
"balance": "1000000000",
"decimals": 6,
"balanceFormatted": "1000.00"
}
```
All three formats are unified, so your code works regardless of which provider is used.
[Learn more about data normalization →](/guides/uniblock/autorouting/uniblock-data-normalization)
### Data consensus
For critical queries, Uniblock can query multiple providers simultaneously and return consensus data. This ensures accuracy and catches provider-specific bugs or stale data.
**When to use:**
* High-value transactions requiring verification
* Auditing and compliance scenarios
* Critical balance checks before transfers
**How it works:**
* Queries 2-3 providers in parallel
* Compares responses for consistency
* Returns data only if providers agree
* Flags discrepancies for investigation
Data consensus increases latency and costs. Use it selectively for critical
operations.
### Polyfilled data
Some providers have incomplete data for certain chains or time periods. Uniblock automatically detects gaps and fills them using alternative providers.
**Example scenarios:**
* Provider A has Ethereum data but missing Polygon data → Uniblock uses Provider B for Polygon
* Provider C has recent transactions but missing historical data → Uniblock backfills from Provider D
* Provider E returns incomplete NFT metadata → Uniblock enriches from Provider F
**Result:** You always get complete data without manual provider switching.
[Learn more about data polyfill →](/guides/uniblock/autorouting/uniblock-polyfill)
### Unified backup
If your primary provider experiences an outage, Uniblock seamlessly switches to backup providers without returning errors to your application.
**Failover chain example:**
1. Primary: Alchemy (fastest, most reliable)
2. Backup 1: QuickNode (high reliability)
3. Backup 2: Ankr (stable fallback)
**Typical failover time:** \< 500ms
***
## Supported APIs
Uniblock provides unified access to multiple API categories:
Balances, transfers, prices, allowances, and token metadata across all
chains.
Collections, metadata, floor prices, ownership, and transfer history.
Transaction history, receipts, gas estimation, and status tracking.
Real-time prices, historical charts, volume, and trending tokens.
Block explorer data, contract verification, and source code access.
Direct node access with auto-routing for all supported chains.
[View all API endpoints →](/reference/unified-api-reference-overview)
***
## Supported providers
Uniblock integrates with 55+ blockchain data providers to ensure comprehensive coverage and reliability, including: Alchemy, QuickNode, Infura, Ankr, Covalent, Moralis, Blockdaemon, Chainstack, TonAPI, Helius, and more.
***
## When to use Uniblock
### Use Uniblock when you need:
* **Multi-chain support** - Building apps that work across multiple blockchains
* **High reliability** - Production apps that can't tolerate provider outages
* **Consistent data** - Normalized formats across all providers and chains
* **Fast integration** - One API key instead of managing multiple providers
* **Cost optimization** - Automatic routing to most cost-effective providers
### Consider alternatives when:
* **Single provider is sufficient** - If you only need one chain and one provider, direct integration may be simpler
* **Extreme latency requirements** - Direct provider connections may be 50-100ms faster (though less reliable)
***
## Common use cases
### Wallet applications
Display token balances, NFTs, and transaction history across multiple chains with a single integration.
[Use-case guide: Wallets and portfolio trackers ->](/guides/use-cases/wallets-and-portfolio-trackers)
```bash Get all token balances theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/token/balances?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb' \
--header 'x-api-key: YOUR_API_KEY'
```
### NFT marketplaces
Query NFT metadata, floor prices, and ownership across all major chains.
[Use-case guide: NFT marketplaces and discovery ->](/guides/use-cases/nft-marketplaces-and-discovery)
```bash Get NFT collection floor price theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/nft/collection/floor-price?chainId=1&contractAddress=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D' \
--header 'x-api-key: YOUR_API_KEY'
```
### DeFi dashboards
Track token prices, liquidity, and trading activity in real-time.
[Use-case guide: DeFi dashboards and analytics ->](/guides/use-cases/defi-dashboards-and-analytics)
```bash Get token price theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/market-data/token/price?chainId=1&tokenAddress=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' \
--header 'x-api-key: YOUR_API_KEY'
```
### Analytics platforms
Aggregate transaction data and on-chain metrics across multiple chains.
[Use-case guide: DeFi dashboards and analytics ->](/guides/use-cases/defi-dashboards-and-analytics)
```bash Get transaction history theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/transaction/history?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb&limit=50' \
--header 'x-api-key: YOUR_API_KEY'
```
***
## Next steps
Create your first project and make API calls in 5 minutes.
Explore all available endpoints with interactive playgrounds.
Learn how auto-routing works and how to configure it.
View the complete list of supported blockchains.
***
## Common pitfalls
**Provider-specific features** - Some provider-specific endpoints or features
may not be available through the unified API. Use [Direct
API](/reference/direct/direct-providers/overview) for provider-specific
functionality.
**Rate limits** - Rate limits apply per API key, not per provider. Monitor
your usage in the [dashboard](https://dashboard.uniblock.dev) to avoid
throttling.
**Chain ID consistency** - Always use numeric chain IDs (e.g., `1` for
Ethereum) or official string identifiers (e.g., `solana`). Inconsistent chain
IDs cause routing errors.
***
## Need help?
* **Documentation** - Search these docs for detailed guides and API references
* **Support** - Contact us at [uniblock.dev/support](https://uniblock.dev/support)
* **Dashboard** - Monitor usage and manage projects at [dashboard.uniblock.dev](https://dashboard.uniblock.dev)
***
Create your free account and start building with unified blockchain infrastructure across 300+ chains.
Explore all available endpoints and interactive playgrounds
# Analytics & Logs
Source: https://docs.uniblock.dev/guides/uniblock/uniblock-analytics
Monitor Uniblock project performance, latency, request volume, per-endpoint trends, per-API-key analytics, and detailed logs in the dashboard.
**Endpoints → Analytics** is your hub for understanding project performance and usage. It shows response times, request volume, endpoint trends, and detailed logs for every call.
## Project statistics
Uniblock Analytics provides the following data for your project:
* **Average latency**: average API response time; lower is better for user experience
* **Successful requests**: count of completed requests
* **Failed requests**: count of requests that returned an error or did not complete
* **Total requests**: cumulative request count for activity and usage patterns
* **Endpoint calls over time**: chart of successful, failed, and total requests over time
## API key analytics
In addition to project-wide analytics, Uniblock provides the same metrics broken down per API key: average response time, failed requests, total requests, and total usage. Use this to spot anomalies tied to a specific key or environment (for example, a staging key spiking in errors while production stays clean).
## API logs
Scroll to **See Detailed Logs** at the bottom of the Analytics tab for a per-request table showing: method, endpoint, status code, provider used, response time, and timestamp.
### Why logs matter
API logs show how your application behaves in production. Use them to:
* Identify and diagnose issues as they happen
* Monitor API health and response-time trends
* Track request patterns across endpoints
* Detect unexpected or suspicious activity
### Reading the logs table
Each row in the logs table summarizes one outbound call, including any provider fallback attempts that occurred:
* **Method**: HTTP method (`GET` or `POST`)
* **Endpoint**: API endpoint accessed (e.g. `/v1/token/metadata`)
* **Status**: success or error status code
* **Provider**: provider that returned the final response
* **Response**: provider response(s) attempted for the call (multiple when fallback routing fired)
* **Response time**: end-to-end latency for the request
* **Date**: exact timestamp when the request was made
### Detailed request logs
Click any log row to expand the full request detail, which includes every fallback attempt across providers:
* **HTTP method**: e.g. `GET`
* **Endpoint name**: e.g. `TokenMetadata`
* **Endpoint path**: e.g. `/v1/token/metadata`
* **Timestamp**: exact request time
* **Response time**: server processing duration
* **Headers**: request metadata (`Host`, `User-Agent`, `Accept`, and others)
* **Query parameters**: additional request context
* **Request body**: payload for `POST` or `PUT` requests
* **Response headers & body**: provider response data (multiple entries appear when fallback routing was used)
### Filtering and searching
Use the filter controls at the top of the logs table to narrow by provider, status code, endpoint, or time range. The search bar matches keywords or error messages across all log fields.
***
Create your free account and start building with unified blockchain infrastructure across 300+ chains.
Explore all available endpoints and interactive playgrounds
# Unified API Quickstart
Source: https://docs.uniblock.dev/guides/uniblock/unified-api-quickstart
Make your first Uniblock Unified API call in under two minutes with the API Tester, using your project API key and the /token/metadata endpoint.
Estimated time: under 2 minutes. This guide assumes you already have an Uniblock project. If not, follow the [Uniblock Quickstart Guide](/guides/getting-started/uniblock-quickstart-guide) first.
Open your [Uniblock dashboard](https://dashboard.uniblock.dev) and navigate to your project. Your API key is displayed on the **Overview** page; click the copy icon next to it.
In the left sidebar of your project, go to **Endpoints → API Tester**. This opens the Uniblock Explorer in a new tab.
On the Explorer page, click the **Authorize** button at the top. Paste your Uniblock API key into the `X-API-Key` field and click **Authorize**, then **Close**. All subsequent requests in this session will use your key.
Find and expand the `/token/metadata` endpoint. Click **Try it out** to enable the input fields.
Example values are pre-filled in the required fields. You can use them as-is or enter your own `chainId` and token address. Click **Execute** to send the request.
The response body appears below the Execute button with a `200` status code and the token metadata JSON. That's it: you've made your first authenticated Unified API call.
***
Continue on to the other guides in the Unified API section for more detail on authentication, analytics, and auto-routing features.
***
Create your free account and start building with unified blockchain infrastructure across 300+ chains.
Explore all available endpoints and interactive playgrounds
# Airdrops and Growth Campaigns
Source: https://docs.uniblock.dev/guides/use-cases/airdrops-and-growth-campaigns
Use Uniblock to monitor airdrop eligibility, distribution activity, NFT campaigns, holder wallets, and on-chain growth events across chains.
Uniblock does not replace your claim contract or distribution logic, but it can cover a large part of the surrounding campaign data layer: holder checks, transfer tracking, event monitoring, NFT ownership checks, and post-launch reporting.
## Best-fit workflows
* Monitor token or NFT distribution progress
* Verify recipient activity and holdings
* Trigger internal workflows from transfer or contract events
* Build campaign dashboards for launch teams and community ops
***
## Recommended APIs
* `GET /token/transfers`
* `GET /token/activity`
* `GET /token/balance`
* `GET /nft/is-airdrop`
* `GET /nft/is-nft-holder`
* `GET /nft/transfers`
* [Webhook quickstart](/reference/webhook/webhook-quickstart)
***
## Suggested implementation flow
### 1. Define the eligibility read path
Depending on the campaign, eligibility can come from:
* token balances
* NFT ownership
* historical wallet activity
* contract interactions
Use the unified read layer to centralize those checks before users ever reach the claim flow.
### 2. Monitor campaign movement
Once distribution begins, use token, NFT, and transaction endpoints to track:
* how many wallets received assets
* which wallets moved or sold immediately
* whether claim activity is still active
### 3. Add webhook-driven operations
Webhooks are useful for:
* internal notifications when claims happen
* syncing campaign databases
* triggering CRM or growth workflows
* detecting large movement from campaign wallets
### 4. Close the loop with analytics and logs
After launch, use:
* [Analytics & Logs](/guides/uniblock/uniblock-analytics) to understand request usage during campaign spikes and debug malformed requests
***
## Common pitfalls
Eligibility logic is application-specific. Keep your business rules in your
own backend even if Uniblock powers the underlying reads.
Campaign traffic is bursty. Load-test your own systems and watch Uniblock rate
limits before a public launch.
***
## Related docs
* [NFT API overview](/reference/unified-api/api-overview-nft)
* [Token API overview](/reference/unified-api/api-overview-token)
* [Rate limits](/guides/uniblock/error-codes#rate-limits)
# DAO Dashboards and Governance
Source: https://docs.uniblock.dev/guides/use-cases/dao-dashboards-and-governance
Build DAO dashboards on Uniblock with treasury visibility, governance-token monitoring, proposal activity, and event-driven contract tracking.
DAO tooling usually needs visibility into treasury wallets, governance-token movement, and contract events rather than a single endpoint category. Uniblock works well as a read and monitoring layer across those requirements.
## Best-fit workflows
* Treasury dashboards
* Governance token monitoring
* Contract-event monitoring for voting or execution contracts
* Contributor and wallet activity tracking
***
## Recommended APIs
* [Token API overview](/reference/unified-api/api-overview-token)
* [Transaction API overview](/reference/unified-api/api-overview-transaction)
* [Webhooks overview](/reference/webhook/webhooks-overview)
* [JSON-RPC overview](/reference/unified-api/overview-jsonrpc)
Useful starting points:
* `GET /token/balance`
* `GET /token/activity`
* `GET /token/allowances`
* `GET /transactions`
* contract-event webhooks
***
## Suggested implementation flow
### 1. Build treasury visibility
Start by indexing known treasury and operational wallets. Use token balances and transactions to create:
* treasury composition views
* outflow and inflow reports
* multisig activity summaries
### 2. Track governance token movement
Use token activity and transfer data to monitor:
* whale movement
* delegate or contributor wallet changes
* unusual governance-token concentration shifts
### 3. Monitor governance contracts
Use contract-event webhooks for:
* proposal creation
* execution events
* protocol-specific governance actions
This is especially useful when the DAO runs custom contracts and you want event-driven automation around them.
### 4. Use JSON-RPC where contract-level detail matters
If the governance flow depends on contract state reads that are not modeled in the Unified API, use JSON-RPC for contract calls while keeping Uniblock as the shared routing layer.
***
## Common pitfalls
Governance data is often split between token movement and contract state. Do
not assume one source alone is enough for a full DAO dashboard.
Allowance data can be important for operational wallets. If your DAO uses
treasury automation, include approvals and permissions in reviews.
***
## Related docs
* [Contract event webhook type](/reference/webhook/webhook-types/event-trigger-contract-event)
* [Token API overview](/reference/unified-api/api-overview-token)
* [Authentication guide](/guides/uniblock/authentication)
# DeFi Dashboards and Analytics
Source: https://docs.uniblock.dev/guides/use-cases/defi-dashboards-and-analytics
Use Uniblock to build DeFi dashboards and analytics with token price, transaction history, liquidity, and market activity data across chains.
DeFi products usually need a mix of wallet state, market data, and event monitoring. Uniblock helps by combining normalized token and transaction data with market-data endpoints and optional provider-specific access through Direct API.
## Best-fit use cases
* Token watchlists and market overview pages
* Treasury dashboards for protocol-owned assets
* Yield, LP, or vault monitoring tools
* Internal analytics for on-chain protocol activity
***
## Recommended APIs
* [Market Data API overview](/reference/unified-api/api-overview-market-data)
* [Token API overview](/reference/unified-api/api-overview-token)
* [Transaction API overview](/reference/unified-api/api-overview-transaction)
* [Direct API overview](/reference/direct/direct-providers/overview)
Key endpoints to start with:
* `GET /market-data/price`
* `GET /market-data/history`
* `GET /market-data/chart-range`
* `GET /market-data/trending`
* `GET /token/balance`
* `GET /token/transfers`
* `GET /transactions`
***
## Suggested implementation flow
### 1. Build the market layer
Use market-data endpoints to power:
* spot prices
* 24 hour volume
* historical charts
* trending or top-moving token lists
```bash theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/market-data/price?chainId=1&tokenAddress=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' \
--header 'x-api-key: YOUR_API_KEY'
```
### 2. Add protocol and treasury positions
Use token balance and transaction endpoints to monitor wallets tied to:
* protocol treasuries
* reward distribution wallets
* multisigs
* liquidity management accounts
### 3. Add event-driven workflows
If a dashboard needs to react quickly to transfers or contract activity, add:
* [Address activity webhooks](/reference/webhook/webhook-types/event-trigger-address-activity)
* [Contract event webhooks](/reference/webhook/webhook-types/event-trigger-contract-event)
These are useful for vault deposits, treasury movements, and settlement events.
### 4. Use Direct API when you need provider-specific depth
Some DeFi products eventually need provider-native features or niche datasets. That is where [Direct API](/reference/direct/direct-providers/overview) is the right extension point.
Start with Unified API for portability. Move into Direct API only when the
unified schema does not expose the specific provider feature you need.
***
## Where JSON-RPC fits
Use [JSON-RPC](/reference/unified-api/overview-jsonrpc) for:
* contract reads with `eth_call`
* pending state inspection
* gas estimation
* raw transaction submission from backend services
This is useful when your DeFi backend must interact with contracts directly rather than just read indexed data.
***
## Common pitfalls
DeFi apps often mix indexed data and node data. Be explicit about which layer
is used for pricing, balances, and execution-critical reads.
If a view is latency-sensitive, avoid over-fetching multiple chart and balance
endpoints in the same render path. Split summary views from detailed panels.
***
## Related docs
* [Market Data API overview](/reference/unified-api/api-overview-market-data)
* [Direct API categories](/reference/direct/direct-providers/overview)
* [JSON-RPC overview](/reference/unified-api/overview-jsonrpc)
* [Analytics & Logs](/guides/uniblock/uniblock-analytics)
# Gaming and In-App Assets
Source: https://docs.uniblock.dev/guides/use-cases/gaming-and-in-app-assets
Use Uniblock to track player wallets, NFT item ownership, token rewards, and gameplay-related on-chain activity in games and in-app economies.
Games and consumer apps often need a fast asset layer more than they need chain-specific infrastructure. Uniblock is useful here because the same integration can expose fungible rewards, NFT inventory, transfer history, and event-driven updates across multiple chains.
## Best-fit workflows
* Player inventory views
* Reward token balance displays
* NFT item ownership checks
* Real-time notifications for item or reward transfers
* Backend services that read contract state or submit transactions
***
## Recommended APIs
* [Token API overview](/reference/unified-api/api-overview-token)
* [NFT API overview](/reference/unified-api/api-overview-nft)
* [Transaction API overview](/reference/unified-api/api-overview-transaction)
* [Webhooks overview](/reference/webhook/webhooks-overview)
* [JSON-RPC overview](/reference/unified-api/overview-jsonrpc)
***
## Suggested implementation flow
### 1. Build the player asset view
Use token and NFT balance endpoints to show:
* soft currency balances
* premium token balances
* inventory items and collectibles
If players can own assets on multiple chains, normalize them into one account view in your backend.
### 2. Track gameplay-related movement
Transfer and transaction endpoints are useful for:
* reward claim history
* marketplace purchases
* item transfers between wallets
* contract interactions tied to gameplay
### 3. Use webhooks for live state changes
Games benefit from event-driven updates more than most app categories. Use webhooks to trigger:
* inventory refreshes
* reward claim confirmations
* contract event processing for on-chain game logic
### 4. Use JSON-RPC for game-specific contract reads
If your backend needs custom contract methods, use JSON-RPC for direct reads and writes while keeping the Unified API for account and asset views.
***
## Why this pattern works
For most games, the hardest part is not a single chain integration. It is keeping asset state, user-facing balance views, and event processing coherent as the product grows. Uniblock reduces that surface area by giving you a single data layer for the read path.
***
## Common pitfalls
Do not make the gameplay loop depend on a single polling endpoint. Use
webhooks or queued refresh jobs for state changes that matter to the user
experience.
Separate display balances from execution-critical contract reads. Your UI can
use normalized APIs while your write path can still use JSON-RPC where needed.
***
## Related docs
* [Webhooks overview](/reference/webhook/webhooks-overview)
* [Solana address activity webhook type](/reference/webhook/webhook-types/event-trigger-solana-address-activity)
# NFT Marketplaces and Discovery
Source: https://docs.uniblock.dev/guides/use-cases/nft-marketplaces-and-discovery
Build NFT marketplaces, discovery feeds, and collection experiences with Uniblock NFT APIs, metadata endpoints, and real-time webhook events.
Uniblock can cover most of the read-heavy data layer for NFT products: collection metadata, item metadata, wallet holdings, floor prices, sales, listings, and ownership. That makes it a practical fit for marketplace frontends, collector dashboards, and collection discovery tools.
## Best-fit workflows
* Collection landing pages
* NFT detail pages
* Wallet ownership and portfolio views
* Sales and floor-price monitors
* Real-time event streams for transfers and contract events
***
## Recommended APIs
* `GET /nft/collection-metadata`
* `GET /nft/nft-in-collection`
* `GET /nft/metadata`
* `GET /nft/floor-price`
* `GET /nft/sales`
* `GET /nft/owners/nft`
* `GET /nft/owners/contract`
* `GET /nft/transfers`
* `GET /nft/transfers/nft`
Start from the [NFT API overview](/reference/unified-api/api-overview-nft) for endpoint coverage.
***
## Suggested implementation flow
### 1. Build the collection page
At minimum, load:
* collection metadata
* a paginated list of NFTs in the collection
* floor price
* recent sales
That gives you the baseline marketplace browsing experience.
### 2. Build the asset page
For each NFT detail page, combine:
* `GET /nft/metadata`
* `GET /nft/transfers/nft`
* `GET /nft/owners/nft`
This gives you provenance, owner state, and transfer history.
### 3. Build the owner experience
For user profiles and portfolio views, combine:
* `GET /nft/balance`
* `GET /nft/owned-collections`
* token endpoints if the same app also shows fungible positions
### 4. Add event-driven updates
Use contract-event webhooks or NFT-focused templates from the webhook flow to:
* refresh collection activity feeds
* notify on transfers
* track popular contracts and major sales activity
***
## Where Direct API fits
NFT products often need marketplace-specific or provider-specific capabilities. When the unified schema is not enough, use [Direct API](/reference/direct/direct-providers/overview) for deeper marketplace or provider integrations while keeping Unified API as the default read layer.
***
## Common pitfalls
NFT metadata can change over time. Refresh metadata and floor-price data on
separate schedules instead of treating them as equally fresh.
Ownership for ERC-1155 assets can involve multiple holders. Do not model all
NFT ownership as single-owner ERC-721 behavior.
***
## Related docs
* [NFT API overview](/reference/unified-api/api-overview-nft)
* [Webhook quickstart](/reference/webhook/webhook-quickstart)
* [Contract event webhook type](/reference/webhook/webhook-types/event-trigger-contract-event)
* [Address activity webhook type](/reference/webhook/webhook-types/event-trigger-address-activity)
# Uniblock use cases: wallets, DeFi, NFTs, gaming, and DAOs
Source: https://docs.uniblock.dev/guides/use-cases/overview
Pick a Uniblock use-case guide for wallets, DeFi dashboards, NFT marketplaces, gaming, airdrops, DAOs, and token launch workflows across chains.
The old use-cases page mixed current platform capabilities with older product references. This section replaces it with guides that map directly to what Uniblock documents today: Unified APIs, webhooks, JSON-RPC, Direct API access, analytics, and logs.
Use these guides when you want a practical starting point for a specific product shape rather than a feature-by-feature overview.
Aggregate balances, NFTs, transfers, and activity across chains.
Build token, price, liquidity, and market monitoring workflows.
Power collection pages, ownership views, floor-price tracking, and sales feeds.
Track player assets, rewards, inventory changes, and game-related activity.
Monitor claims, token movement, NFT distribution, and campaign health.
Track treasury flows, governance token movement, and contract events.
Support launch operations with pricing, holder, transfer, and event data.
***
## How to use these guides
Each guide follows the same pattern:
1. Start with the product shape you are building.
2. Use the recommended APIs and webhook types for that workflow.
3. Validate the response shape in the API tester or JSON-RPC tester.
4. Move into production with your own API key and monitor usage in analytics and logs.
If you are completely new to the platform, start with the [Uniblock Quickstart
Guide](/guides/getting-started/uniblock-quickstart-guide) first.
***
## Shared building blocks
* [Token API](/reference/unified-api/api-overview-token) for balances, metadata, transfers, allowances, and token activity
* [NFT API](/reference/unified-api/api-overview-nft) for collection metadata, ownership, floor prices, sales, and transfers
* [Transaction API](/reference/unified-api/api-overview-transaction) for wallet and block transaction history
* [Market Data API](/reference/unified-api/api-overview-market-data) for price, volume, history, and trending data
* [Webhooks](/reference/webhook/webhook-quickstart) for event-driven workflows
* [JSON-RPC](/reference/unified-api/overview-jsonrpc) for lower-level node access when your app needs chain-native methods
* [Direct API](/reference/direct/direct-providers/overview) when you need provider-specific functionality beyond the unified schema
***
## Next steps
Create a project, get an API key, and make your first request.
Learn how routing, normalization, and failover work across the platform.
Monitor usage, request volume, and debug failed calls with detailed logs.
# Token Launches and Monitoring
Source: https://docs.uniblock.dev/guides/use-cases/token-launches-and-monitoring
Support token launches with Uniblock pricing endpoints, holder and transfer tracking, real-time webhooks, and post-launch analytics dashboards.
The older use-cases page described token creation and launch tooling that is not part of the current docs set. Today, the documented Uniblock fit for token launches is the data and monitoring layer around a launch: token metadata, balances, transfers, market data, transaction tracking, and event monitoring.
## Where Uniblock helps
* Launch dashboards for internal teams
* Public token pages with price and transfer activity
* Holder and treasury monitoring after launch
* Real-time alerts for important launch-related events
***
## Recommended APIs
* [Token API overview](/reference/unified-api/api-overview-token)
* [Market Data API overview](/reference/unified-api/api-overview-market-data)
* [Transaction API overview](/reference/unified-api/api-overview-transaction)
* [Webhooks quickstart](/reference/webhook/webhook-quickstart)
Suggested starting endpoints:
* `GET /token/metadata`
* `GET /token/price`
* `GET /token/transfers`
* `GET /token/activity`
* `GET /transactions`
***
## Suggested implementation flow
### 1. Launch the public token page
Use token metadata and market-data endpoints to expose:
* token basics
* current price
* recent performance
* trending status where relevant
### 2. Monitor treasury and operational wallets
Use token balances, activity, and transactions to watch:
* deployer wallets
* treasury wallets
* liquidity or operational addresses
### 3. Track launch events in real time
Set up webhooks to detect:
* major transfer activity
* contract events tied to token movement
* important wallet interactions after launch
### 4. Use analytics and logs during launch week
Traffic and operational load tend to spike around launches. Keep:
* [Analytics & Logs](/guides/uniblock/uniblock-analytics) for throughput, request trends, and debugging
***
## Common pitfalls
Uniblock can support launch monitoring, but token deployment and sale logic
still belong to your own contracts and launch infrastructure.
Separate public market views from operational monitoring. The read patterns,
refresh intervals, and failure tolerance are usually different.
***
## Related docs
* [Market Data API overview](/reference/unified-api/api-overview-market-data)
* [Webhooks overview](/reference/webhook/webhooks-overview)
* [Analytics & Logs](/guides/uniblock/uniblock-analytics)
# Wallets and Portfolio Trackers
Source: https://docs.uniblock.dev/guides/use-cases/wallets-and-portfolio-trackers
Use Uniblock to build multi-chain wallet views, portfolio dashboards, token balance summaries, and per-address account activity feeds.
Wallet products need one thing more than anything else: a consistent account view across many chains. Uniblock is a strong fit when you want token balances, NFT holdings, transfer history, and transaction activity without maintaining separate provider integrations per network.
## What to build with Uniblock
* A wallet home screen with balances across supported chains
* A portfolio tracker with token, NFT, and transaction views
* A recent activity feed for sends, receives, swaps, and NFT transfers
* Real-time alerts for monitored addresses using webhooks
***
## Recommended APIs
* [Token API overview](/reference/unified-api/api-overview-token) for balances, metadata, transfers, allowances, and token activity
* [NFT API overview](/reference/unified-api/api-overview-nft) for wallet holdings and collection-level enrichment
* [Transaction API overview](/reference/unified-api/api-overview-transaction) for account history
* [Webhook quickstart](/reference/webhook/webhook-quickstart) for real-time address monitoring
***
## Suggested implementation flow
### 1. Build the portfolio snapshot
Start with token balances, NFT balances, and the latest transactions for a wallet address. That gives you the minimum useful wallet experience.
```bash theme={null}
curl --location \
'https://api.uniblock.dev/uni/v1/token/balance?chainId=1&walletAddress=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb' \
--header 'x-api-key: YOUR_API_KEY'
```
### 2. Add valuation and metadata
Once balances load reliably, enrich those positions with:
* `GET /token/metadata`
* `GET /token/price`
* `GET /nft/metadata`
* `GET /nft/collection-metadata`
This is the point where a plain balance checker becomes a portfolio tracker.
### 3. Layer in account activity
Use the transaction and transfer endpoints to build an activity tab with clearer event labeling:
* incoming and outgoing token transfers
* NFT transfers
* contract interactions
* chain-specific transaction details
### 4. Add real-time updates
For wallets with notifications, use address activity webhooks so the UI updates from events instead of repeated polling.
Use webhooks for notifications and use Unified API reads for the canonical UI
refresh after an event arrives.
***
## Where JSON-RPC fits
Use [JSON-RPC](/reference/unified-api/overview-jsonrpc) when you need chain-native methods such as:
* `eth_getBalance` for direct native balance checks
* `eth_call` for contract state reads
* `eth_sendRawTransaction` when your product also broadcasts signed transactions
For most wallet dashboard views, the Unified API is the faster starting point. Use JSON-RPC when you need lower-level control.
***
## Monitoring and debugging
When wallet traffic scales up, watch:
* [Analytics & Logs](/guides/uniblock/uniblock-analytics) for usage patterns, request volume, and debugging
* [Rate Limits](/guides/uniblock/error-codes#rate-limits) if the app performs aggressive polling
***
## Common pitfalls
Avoid assuming all chains use the same address format. EVM and Solana addresses
should be validated differently before you submit requests.
Do not rely on price data alone for portfolio state. Keep balances and pricing
as separate refresh layers so stale market data does not block balance updates.
***
## Related docs
* [Token API overview](/reference/unified-api/api-overview-token)
* [NFT API overview](/reference/unified-api/api-overview-nft)
* [Transaction API overview](/reference/unified-api/api-overview-transaction)
* [Authentication guide](/guides/uniblock/authentication)
# Uniblock quickstart overview: from sign-up to first API call
Source: https://docs.uniblock.dev/quickstart
Get from Uniblock sign-up to your first API call in minutes. Start here, then pick the quickstart for the product you are building with.
New to Uniblock? This is the fastest path from zero to your first response. Create a free account, grab an API key, and make a call; most developers are up and running in under 10 minutes.
Every request is authenticated with a project API key. Create your project and
get your key from the [Uniblock dashboard](https://dashboard.uniblock.dev).
## Start here
If this is your first time, set up your account and make your first request. Then jump to the quickstart for whichever product you're building with.
Create a project, generate an API key, and make your first request. Start here if you're new to Uniblock.
## Quickstart by product
One API across 55+ providers and 300+ chains. Authorize your key in the API Tester and call your first endpoint in \~2 minutes.
Receive real-time, signed notifications for on-chain events (transactions, transfers, NFTs, and new blocks) without polling.
Provider-specific endpoints exactly as the upstream exposes them, for methods not yet in the Unified API.
Subscribe to streaming data over a persistent connection for low-latency, push-based updates.
## Next steps
Authenticate requests with API keys and understand how project access works.
Browse the 300+ blockchains available across Uniblock products.
See how usage is metered and choose the plan that fits your workload.
Reference architectures for wallets, dashboards, NFT apps, and more.
# Chains reference: JSON-RPC docs by chain ID
Source: https://docs.uniblock.dev/reference/chains/overview-chains
Browse Uniblock's JSON-RPC reference docs for every supported chain, with per-chain endpoints, method groups, and worked cURL examples across 300+ networks.
Use Uniblock's unified JSON-RPC endpoint to read chain state, send transactions, and build multi-chain apps through one API key. Pick a chain below to open its method reference.
# Alchemy direct API on Uniblock: NFT, market data, tokens
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-alchemy
Access Alchemy's 29 direct API endpoints on Uniblock across NFT metadata and ownership, market data, DeFi prices, token pricing, and wallet lookups.
# Alchemy: Direct API Endpoints
Alchemy provides 29 unique direct API endpoints across the following categories:
* DeFi (3 endpoints)
* Market Data (4 endpoints)
* NFT (24 endpoints)
* Other (1 endpoint)
* Token (4 endpoints)
* Wallets (5 endpoints)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
> **Learn more:** [Alchemy Documentation](https://www.alchemy.com/docs/data)
## Prefix and Example
**Prefix:** No prefix is required for Alchemy, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/Alchemy + /[Alchemy_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/Alchemy/prices/v1/tokens/by-symbol \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## DeFi
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/prices/v1/tokens/by-symbol](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-symbol) | 80 | Fetches current prices for multiple tokens using their symbols. Returns a list of token prices, each containing the symbol, prices, and an optional error field. |
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/prices/v1/tokens/by-address](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-address) | 80 | Fetches current prices for multiple tokens using network and address pairs. Returns a list of token prices, each containing the network, address, prices, and an optional error field. |
| [direct/v1/Alchemy/prices/v1/tokens/historical](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-historical-token-prices) | 80 | Provides historical price data for a single token over a time range. You can identify the token by symbol or by network and contract address. |
## Market Data
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/prices/v1/tokens/by-symbol](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-symbol) | 80 | Fetches current prices for multiple tokens using their symbols. Returns a list of token prices, each containing the symbol, prices, and an optional error field. |
| [direct/v1/Alchemy/\{chain}/nft/v3/getFloorPrice](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-sales-endpoints/get-floor-price-v-3) | 160 | Retrieves the floor prices of an NFT collection across different marketplaces. |
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/prices/v1/tokens/by-address](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-address) | 80 | Fetches current prices for multiple tokens using network and address pairs. Returns a list of token prices, each containing the network, address, prices, and an optional error field. |
| [direct/v1/Alchemy/prices/v1/tokens/historical](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-historical-token-prices) | 80 | Provides historical price data for a single token over a time range. You can identify the token by symbol or by network and contract address. |
## NFT
### GET
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/\{chain}/nft/v3 /getCollectionMetadata](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-collection-metadata-v-3) | 480 | Retrieves high-level collection or contract-level information for an NFT collection. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /getCollectionsForOwner](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-collections-for-owner-v-3) | 720 | Retrieves all NFT collections held by a specified owner address. |
| [direct/v1/Alchemy/\{chain}/nft/v3/computeRarity](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/compute-rarity-v-3) | 160 | Calculates the rarity of each attribute within an NFT. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /getContractMetadata](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-contract-metadata-v-3) | 320 | Retrieves high-level collection or contract-level information for an NFT. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /getContractsForOwner](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-contracts-for-owner-v-3) | 640 | Retrieves all NFT contracts held by a specified owner address. |
| [direct/v1/Alchemy/\{chain}/nft/v3/getFloorPrice](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-sales-endpoints/get-floor-price-v-3) | 160 | Retrieves the floor prices of an NFT collection across different marketplaces. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /invalidateContract](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/invalidate-contract-v-3) | 160 | Marks all cached tokens for the specified contract as stale, ensuring the next query fetches live data instead of cached data. |
| [direct/v1/Alchemy/\{chain}/nft/v3/isAirdropNFT](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-spam-endpoints/is-airdrop-nft-v-3) | 160 | Determines whether a specific token is marked as an airdrop. Airdrops are defined as NFTs minted to a user address in a transaction sent by a different address. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /isHolderOfContract](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/is-holder-of-contract-v-3) | 160 | Determines whether a specific wallet holds any NFT from a given contract. |
| [direct/v1/Alchemy/\{chain}/nft/v3/isSpamContract](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-spam-endpoints/is-spam-contract-v-3) | 160 | Determines whether a specific contract is marked as spam by Alchemy. |
| [direct/v1/Alchemy/\{chain}/nft/v3/getNFTMetadata](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-nft-metadata-v-3) | 160 | Retrieves the metadata associated with a specific NFT. |
| [direct/v1/Alchemy/\{chain}/nft/v3/getNFTSales](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-sales-endpoints/get-nft-sales-v-3) | 320 | Retrieves NFT sales that have occurred through on-chain marketplaces. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /getNFTsForCollection](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-nf-ts-for-collection-v-3) | 100 | Retrieves all NFTs associated with a specific NFT collection. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /getNFTsForContract](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-nf-ts-for-contract-v-3) | 1200 | Retrieves all NFTs associated with a specific NFT contract. |
| [direct/v1/Alchemy/\{chain}/nft/v3/getNFTsForOwner](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-nf-ts-for-owner-v-3) | 960 | Retrieves all NFTs currently owned by a specified address. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /getOwnersForContract](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-owners-for-contract-v-3) | 960 | Retrieves all owners associated with a specific NFT contract. |
| [direct/v1/Alchemy/\{chain}/nft/v3/getOwnersForNFT](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-owners-for-nft-v-3) | 160 | Retrieves the owner(s) for a specific token. |
| [direct/v1/Alchemy/\{chain}/nft/v3/reportSpam](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-spam-endpoints/report-spam-v-3) | 100 | Reports a specific address to the API if it is suspected to be spam. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /searchContractMetadata](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/search-contract-metadata-v-3) | 960 | Searches for a keyword across metadata of all ERC-721 and ERC-1155 smart contracts. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /getSpamContracts](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-spam-endpoints/get-spam-contracts-v-3) | 960 | Returns a list of all spam contracts marked by Alchemy. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /summarizeNFTAttributes](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/summarize-nft-attributes-v-3) | 160 | Generates a summary of attribute prevalence for a specific NFT collection. |
### POST
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/\{chain}/nft/v3 /getContractMetadataBatch](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-contract-metadata-batch-v-3) | 960 | Retrieves metadata for a list of specified contract addresses in a single request. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /getNFTMetadataBatch](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-nft-metadata-batch-v-3) | 960 | Retrieves metadata for up to 100 specified NFT contracts in a single request. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /refreshNftMetadata](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/refresh-nft-metadata-v-3) | 80 | Submits a request for Alchemy to refresh the cached metadata of a specific NFT token. |
## Other
### POST
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/hyperliquid/info](https://www.alchemy.com/docs/chains/hyperliquid/hyperliquid-info-endpoint) | 100 | Alchemy Hyperliquid info endpoint. Use the `type` field in the request body to specify the operation. |
## Token
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/prices/v1/tokens/by-symbol](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-symbol) | 80 | Fetches current prices for multiple tokens using their symbols. Returns a list of token prices, each containing the symbol, prices, and an optional error field. |
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| direct/v1/Alchemy/\{chain}/v2 | 100 | |
| [direct/v1/Alchemy/prices/v1/tokens/by-address](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-address) | 80 | Fetches current prices for multiple tokens using network and address pairs. Returns a list of token prices, each containing the network, address, prices, and an optional error field. |
| [direct/v1/Alchemy/prices/v1/tokens/historical](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-historical-token-prices) | 80 | Provides historical price data for a single token over a time range. You can identify the token by symbol or by network and contract address. |
## Wallets
### GET
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------- |
| [direct/v1/Alchemy/\{chain}/nft/v3 /getCollectionsForOwner](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-collections-for-owner-v-3) | 720 | Retrieves all NFT collections held by a specified owner address. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /getContractsForOwner](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-contracts-for-owner-v-3) | 640 | Retrieves all NFT contracts held by a specified owner address. |
| [direct/v1/Alchemy/\{chain}/nft/v3 /isHolderOfContract](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/is-holder-of-contract-v-3) | 160 | Determines whether a specific wallet holds any NFT from a given contract. |
| [direct/v1/Alchemy/\{chain}/nft/v3/getNFTsForOwner](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-nf-ts-for-owner-v-3) | 960 | Retrieves all NFTs currently owned by a specified address. |
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/prices/v1/tokens/by-address](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-address) | 80 | Fetches current prices for multiple tokens using network and address pairs. Returns a list of token prices, each containing the network, address, prices, and an optional error field. |
# Allium direct API on Uniblock: DeFi, stablecoins, tokens
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-allium
Query Allium's 44 direct API endpoints on Uniblock for DeFi, stablecoin flows, token analytics, wallet activity, scan lookups, and prediction markets.
# Allium: Direct API Endpoints
Allium provides 44 unique direct API endpoints across the following categories:
* DeFi (10 endpoints)
* Market Data (11 endpoints)
* Prediction Markets (5 endpoints)
* Scan (16 endpoints)
* Stablecoins (22 endpoints)
* Token (17 endpoints)
* Transaction (3 endpoints)
* Wallets (12 endpoints)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
> **Learn more:** [Allium Documentation](https://docs.allium.so/api)
## Prefix and Example
**Prefix:** No prefix is required for Allium, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/Allium + /[Allium_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/Allium/api/v1/developer/assets \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## DeFi
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------ | ------: | --------------------------------------------- |
| [direct/v1/Allium/api/v1/developer/defi/positions](https://docs.allium.so/api/developer/overview) | 100 | Fetch DeFi positions. |
| [direct/v1/Allium/api/v1/developer/defi /account-health](https://docs.allium.so/api/developer/overview) | 100 | Get DeFi account health. |
| [direct/v1/Allium/api/v1/developer/defi/nav](https://docs.allium.so/api/developer/overview) | 100 | Get DeFi net asset value. |
| [direct/v1/Allium/api/v1/developer/hyperliquid /fills](https://docs.allium.so/api/developer/overview) | 100 | Fetch Hyperliquid fills. |
| [direct/v1/Allium/api/v1/developer/hyperliquid /info](https://docs.allium.so/api/developer/overview) | 100 | Fetch Hyperliquid account information. |
| [direct/v1/Allium/api/v1/developer/hyperliquid /orderbook-snapshot](https://docs.allium.so/api/developer/overview) | 100 | Fetch a Hyperliquid orderbook snapshot. |
| [direct/v1/Allium/api/v1/developer/hyperliquid /order-history](https://docs.allium.so/api/developer/overview) | 100 | Fetch Hyperliquid order history. |
| [direct/v1/Allium/api/v1/developer/hyperliquid /order-status](https://docs.allium.so/api/developer/overview) | 100 | Fetch Hyperliquid order status. |
| [direct/v1/Allium/api/v1/developer/hyperliquid /user-funding](https://docs.allium.so/api/developer/overview) | 100 | Fetch Hyperliquid user funding. |
| [direct/v1/Allium/api/v1/developer/hyperliquid /user-non-funding-ledger-updates](https://docs.allium.so/api/developer/overview) | 100 | Fetch Hyperliquid non-funding ledger updates. |
## Market Data
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------- | ------: | ---------------------- |
| [direct/v1/Allium/api/v1/developer/assets](https://docs.allium.so/api/developer/overview) | 100 | List supported assets. |
### POST
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------- |
| [direct/v1/Allium/api/v1/developer/holdings/pnl](https://docs.allium.so/api/developer/overview) | 100 | Fetch current wallet PnL. |
| [direct/v1/Allium/api/v1/developer/holdings /pnl-by-token](https://docs.allium.so/api/developer/overview) | 100 | Fetch current wallet and token PnL. |
| [direct/v1/Allium/api/v1/developer/holdings/pnl /history](https://docs.allium.so/api/developer/overview) | 100 | Fetch historical wallet PnL. |
| [direct/v1/Allium/api/v1/developer/holdings /pnl-by-token/history](https://docs.allium.so/api/developer/overview) | 100 | Fetch historical wallet and token PnL. |
| [direct/v1/Allium/api/v1/developer/prices](https://docs.allium.so/api/developer/overview) | 100 | Fetch latest token prices. |
| [direct/v1/Allium/api/v1/developer/prices /at-timestamp](https://docs.allium.so/api/developer/overview) | 100 | Fetch token prices at a timestamp. |
| [direct/v1/Allium/api/v1/developer/prices/history](https://docs.allium.so/api/developer/overview) | 100 | Fetch token price history. |
| [direct/v1/Allium/api/v1/developer/prices/stats](https://docs.allium.so/api/developer/overview) | 100 | Fetch token price statistics. |
| [direct/v1/Allium/api/v1/developer/assets/batch](https://docs.allium.so/api/developer/overview) | 100 | Get multiple assets in one request. |
| [direct/v1/Allium/api/v1/developer/hyperliquid /orderbook-snapshot](https://docs.allium.so/api/developer/overview) | 100 | Fetch a Hyperliquid orderbook snapshot. |
## Prediction Markets
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------- |
| [direct/v1/Allium/api/v1/explorer/queries /\{query\_id}/runs/latest](https://docs.allium.so/api/explorer/overview) | 100 | Fetch the latest query run. |
| [direct/v1/Allium/api/v1/explorer/query-runs /\{run\_id}/results](https://docs.allium.so/api/explorer/overview) | 100 | Fetch query run results. |
### PATCH
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------- | ------: | ------------------------- |
| [direct/v1/Allium/api/v1/explorer/queries /\{query\_id}](https://docs.allium.so/api/explorer/overview) | 100 | Update an Explorer query. |
### POST
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------- |
| [direct/v1/Allium/api/v1/explorer/queries](https://docs.allium.so/api/explorer/overview) | 100 | Create an Explorer query. |
| [direct/v1/Allium/api/v1/explorer/queries /\{query\_id}/run-async](https://docs.allium.so/api/explorer/overview) | 100 | Run an Explorer query asynchronously. |
## Scan
### DELETE
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------- |
| [direct/v1/Allium/api/v1/datastreams/data-sources /\{data\_source\_id}](https://docs.allium.so/api/overview) | 100 | Delete a datastream data source. |
| [direct/v1/Allium/api/v1/datastreams/filters /\{filter\_id}](https://docs.allium.so/api/overview) | 100 | Delete a datastream filter. |
| [direct/v1/Allium/api/v1/datastreams/workflows /\{workflow\_id}](https://docs.allium.so/api/overview) | 100 | Delete a datastream workflow. |
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------ | ------: | ------------------------------------ |
| [direct/v1/Allium/api/v1/datastreams/data-sources /\{data\_source\_id}/values](https://docs.allium.so/api/overview) | 100 | Fetch datastream data source values. |
| [direct/v1/Allium/api/v1/explorer/queries /\{query\_id}/runs/latest](https://docs.allium.so/api/explorer/overview) | 100 | Fetch the latest query run. |
| [direct/v1/Allium/api/v1/explorer/query-runs /\{run\_id}/results](https://docs.allium.so/api/explorer/overview) | 100 | Fetch query run results. |
| [direct/v1/Allium/api/v1/explorer/query-runs /\{run\_id}/status](https://docs.allium.so/api/explorer/overview) | 100 | Fetch query run status. |
| [direct/v1/Allium/api/v1/developer/availability](https://docs.allium.so/api/developer/overview) | 100 | Get chain endpoint availability. |
| [direct/v1/Allium/api/v1/account/organization /usage](https://docs.allium.so/api/overview) | 100 | Get organization API usage. |
### PATCH
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------- | ------: | ------------------------- |
| [direct/v1/Allium/api/v1/explorer/queries /\{query\_id}](https://docs.allium.so/api/explorer/overview) | 100 | Update an Explorer query. |
### POST
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------- |
| [direct/v1/Allium/api/v1/explorer/query-runs /\{run\_id}/cancel](https://docs.allium.so/api/explorer/overview) | 100 | Cancel a query run. |
| [direct/v1/Allium/api/v1/datastreams/data-sources](https://docs.allium.so/api/overview) | 100 | Create a datastream data source. |
| [direct/v1/Allium/api/v1/datastreams/filters](https://docs.allium.so/api/overview) | 100 | Create a datastream filter. |
| [direct/v1/Allium/api/v1/explorer/queries](https://docs.allium.so/api/explorer/overview) | 100 | Create an Explorer query. |
| [direct/v1/Allium/api/v1/datastreams/workflows](https://docs.allium.so/api/overview) | 100 | Create a datastream workflow. |
| [direct/v1/Allium/api/v1/explorer/queries /\{query\_id}/run-async](https://docs.allium.so/api/explorer/overview) | 100 | Run an Explorer query asynchronously. |
## Stablecoins
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------- |
| [direct/v1/Allium/api/v1/explorer/queries /\{query\_id}/runs/latest](https://docs.allium.so/api/explorer/overview) | 100 | Fetch the latest query run. |
| [direct/v1/Allium/api/v1/explorer/query-runs /\{run\_id}/results](https://docs.allium.so/api/explorer/overview) | 100 | Fetch query run results. |
| [direct/v1/Allium/api/v1/developer/assets](https://docs.allium.so/api/developer/overview) | 100 | List supported assets. |
| [direct/v1/Allium/api/v1/developer/tokens](https://docs.allium.so/api/developer/overview) | 100 | List tokens. |
| [direct/v1/Allium/api/v1/developer/tokens/search](https://docs.allium.so/api/developer/overview) | 100 | Search tokens. |
### PATCH
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------- | ------: | ------------------------- |
| [direct/v1/Allium/api/v1/explorer/queries /\{query\_id}](https://docs.allium.so/api/explorer/overview) | 100 | Update an Explorer query. |
### POST
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------- |
| [direct/v1/Allium/api/v1/explorer/queries](https://docs.allium.so/api/explorer/overview) | 100 | Create an Explorer query. |
| [direct/v1/Allium/api/v1/developer/holdings/pnl](https://docs.allium.so/api/developer/overview) | 100 | Fetch current wallet PnL. |
| [direct/v1/Allium/api/v1/developer/holdings /pnl-by-token](https://docs.allium.so/api/developer/overview) | 100 | Fetch current wallet and token PnL. |
| [direct/v1/Allium/api/v1/developer/tokens /transfers](https://docs.allium.so/api/developer/overview) | 100 | Fetch fungible token transfers. |
| [direct/v1/Allium/api/v1/developer/wallet /balances/history](https://docs.allium.so/api/developer/overview) | 100 | Fetch historical fungible token balances. |
| [direct/v1/Allium/api/v1/developer/holdings/pnl /history](https://docs.allium.so/api/developer/overview) | 100 | Fetch historical wallet PnL. |
| [direct/v1/Allium/api/v1/developer/holdings /pnl-by-token/history](https://docs.allium.so/api/developer/overview) | 100 | Fetch historical wallet and token PnL. |
| [direct/v1/Allium/api/v1/developer/holdings /history](https://docs.allium.so/api/developer/overview) | 100 | Fetch holdings history. |
| [direct/v1/Allium/api/v1/developer/wallet /balances](https://docs.allium.so/api/developer/overview) | 100 | Fetch latest fungible token balances. |
| [direct/v1/Allium/api/v1/developer/prices](https://docs.allium.so/api/developer/overview) | 100 | Fetch latest token prices. |
| [direct/v1/Allium/api/v1/developer/tokens /chain-address](https://docs.allium.so/api/developer/overview) | 100 | Fetch a token by chain and address. |
| [direct/v1/Allium/api/v1/developer/prices /at-timestamp](https://docs.allium.so/api/developer/overview) | 100 | Fetch token prices at a timestamp. |
| [direct/v1/Allium/api/v1/developer/prices/history](https://docs.allium.so/api/developer/overview) | 100 | Fetch token price history. |
| [direct/v1/Allium/api/v1/developer/prices/stats](https://docs.allium.so/api/developer/overview) | 100 | Fetch token price statistics. |
| [direct/v1/Allium/api/v1/developer/assets/batch](https://docs.allium.so/api/developer/overview) | 100 | Get multiple assets in one request. |
| [direct/v1/Allium/api/v1/explorer/queries /\{query\_id}/run-async](https://docs.allium.so/api/explorer/overview) | 100 | Run an Explorer query asynchronously. |
## Token
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------ | ------: | ---------------------- |
| [direct/v1/Allium/api/v1/developer/assets](https://docs.allium.so/api/developer/overview) | 100 | List supported assets. |
| [direct/v1/Allium/api/v1/developer/tokens](https://docs.allium.so/api/developer/overview) | 100 | List tokens. |
| [direct/v1/Allium/api/v1/developer/tokens/search](https://docs.allium.so/api/developer/overview) | 100 | Search tokens. |
### POST
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------- |
| [direct/v1/Allium/api/v1/developer/holdings/pnl](https://docs.allium.so/api/developer/overview) | 100 | Fetch current wallet PnL. |
| [direct/v1/Allium/api/v1/developer/holdings /pnl-by-token](https://docs.allium.so/api/developer/overview) | 100 | Fetch current wallet and token PnL. |
| [direct/v1/Allium/api/v1/developer/tokens /transfers](https://docs.allium.so/api/developer/overview) | 100 | Fetch fungible token transfers. |
| [direct/v1/Allium/api/v1/developer/wallet /balances/history](https://docs.allium.so/api/developer/overview) | 100 | Fetch historical fungible token balances. |
| [direct/v1/Allium/api/v1/developer/holdings/pnl /history](https://docs.allium.so/api/developer/overview) | 100 | Fetch historical wallet PnL. |
| [direct/v1/Allium/api/v1/developer/holdings /pnl-by-token/history](https://docs.allium.so/api/developer/overview) | 100 | Fetch historical wallet and token PnL. |
| [direct/v1/Allium/api/v1/developer/holdings /history](https://docs.allium.so/api/developer/overview) | 100 | Fetch holdings history. |
| [direct/v1/Allium/api/v1/developer/wallet /balances](https://docs.allium.so/api/developer/overview) | 100 | Fetch latest fungible token balances. |
| [direct/v1/Allium/api/v1/developer/prices](https://docs.allium.so/api/developer/overview) | 100 | Fetch latest token prices. |
| [direct/v1/Allium/api/v1/developer/tokens /chain-address](https://docs.allium.so/api/developer/overview) | 100 | Fetch a token by chain and address. |
| [direct/v1/Allium/api/v1/developer/prices /at-timestamp](https://docs.allium.so/api/developer/overview) | 100 | Fetch token prices at a timestamp. |
| [direct/v1/Allium/api/v1/developer/prices/history](https://docs.allium.so/api/developer/overview) | 100 | Fetch token price history. |
| [direct/v1/Allium/api/v1/developer/prices/stats](https://docs.allium.so/api/developer/overview) | 100 | Fetch token price statistics. |
| [direct/v1/Allium/api/v1/developer/assets/batch](https://docs.allium.so/api/developer/overview) | 100 | Get multiple assets in one request. |
## Transaction
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------ | ------: | --------------------------------------------- |
| [direct/v1/Allium/api/v1/developer/tokens /transfers](https://docs.allium.so/api/developer/overview) | 100 | Fetch fungible token transfers. |
| [direct/v1/Allium/api/v1/developer/wallet /transactions](https://docs.allium.so/api/developer/overview) | 100 | Fetch wallet transactions. |
| [direct/v1/Allium/api/v1/developer/hyperliquid /user-non-funding-ledger-updates](https://docs.allium.so/api/developer/overview) | 100 | Fetch Hyperliquid non-funding ledger updates. |
## Wallets
### POST
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------- |
| [direct/v1/Allium/api/v1/developer/holdings/pnl](https://docs.allium.so/api/developer/overview) | 100 | Fetch current wallet PnL. |
| [direct/v1/Allium/api/v1/developer/holdings /pnl-by-token](https://docs.allium.so/api/developer/overview) | 100 | Fetch current wallet and token PnL. |
| [direct/v1/Allium/api/v1/developer/defi/positions](https://docs.allium.so/api/developer/overview) | 100 | Fetch DeFi positions. |
| [direct/v1/Allium/api/v1/developer/wallet /balances/history](https://docs.allium.so/api/developer/overview) | 100 | Fetch historical fungible token balances. |
| [direct/v1/Allium/api/v1/developer/holdings/pnl /history](https://docs.allium.so/api/developer/overview) | 100 | Fetch historical wallet PnL. |
| [direct/v1/Allium/api/v1/developer/holdings /pnl-by-token/history](https://docs.allium.so/api/developer/overview) | 100 | Fetch historical wallet and token PnL. |
| [direct/v1/Allium/api/v1/developer/holdings /history](https://docs.allium.so/api/developer/overview) | 100 | Fetch holdings history. |
| [direct/v1/Allium/api/v1/developer/wallet /balances](https://docs.allium.so/api/developer/overview) | 100 | Fetch latest fungible token balances. |
| [direct/v1/Allium/api/v1/developer/wallet /transactions](https://docs.allium.so/api/developer/overview) | 100 | Fetch wallet transactions. |
| [direct/v1/Allium/api/v1/developer/defi /account-health](https://docs.allium.so/api/developer/overview) | 100 | Get DeFi account health. |
| [direct/v1/Allium/api/v1/developer/defi/nav](https://docs.allium.so/api/developer/overview) | 100 | Get DeFi net asset value. |
| [direct/v1/Allium/api/v1/developer/hyperliquid /info](https://docs.allium.so/api/developer/overview) | 100 | Fetch Hyperliquid account information. |
# Birdeye direct API on Uniblock: Solana market and token data
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-birdeye
Query Birdeye's 83 direct API endpoints on Uniblock for token pricing, market data, DeFi analytics, wallet activity, and transaction history on Solana.
# Birdeye: Direct API Endpoints
Birdeye provides 83 unique direct API endpoints across the following categories:
* DeFi (16 endpoints)
* Market Data (59 endpoints)
* Scan (1 endpoint)
* Token (62 endpoints)
* Transaction (19 endpoints)
* Wallets (20 endpoints)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
> **Learn more:** [Birdeye Documentation](https://docs.birdeye.so/reference)
## Prefix and Example
**Prefix:** No prefix is required for Birdeye, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/Birdeye + /[Birdeye_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/Birdeye/defi/ohlcv/pair \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## DeFi
### GET
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------- |
| [direct/v1/Birdeye/defi/ohlcv/pair](https://docs.birdeye.so/reference/get-defi-ohlcv-pair) | 2825 | OHLCV - Pair |
| [direct/v1/Birdeye/defi/txs/pair](https://docs.birdeye.so/reference/get-defi-txs-pair) | 705 | Trades - Pair |
| [direct/v1/Birdeye/defi/txs/pair/seek\_by\_time](https://docs.birdeye.so/reference/get-defi-txs-pair-seek_by_time) | 1060 | Trades - Pair Seek By Time |
| [direct/v1/Birdeye/defi/v2/markets](https://docs.birdeye.so/reference/get-defi-v2-markets) | 3535 | Token - All Market List |
| [direct/v1/Birdeye/defi/v3/ohlcv/pair](https://docs.birdeye.so/reference/get-defi-v3-ohlcv-pair) | 6360 | OHLCV V3 - Pair |
| [direct/v1/Birdeye/defi/v3/pair/overview/multiple](https://docs.birdeye.so/reference/get-defi-v3-pair-overview-multiple) | 8920 | Pair - Pair Overview (Multiple) |
| [direct/v1/Birdeye/defi/v3/pair/overview/single](https://docs.birdeye.so/reference/get-defi-v3-pair-overview-single) | 1415 | Pair - Pair Overview (Single) |
| [direct/v1/Birdeye/defi/v3/token/exit-liquidity](https://docs.birdeye.so/reference/get-defi-v3-token-exit-liquidity) | 2120 | Token - Liquidity (Single) |
| [direct/v1/Birdeye/defi/v3/token/exit-liquidity /multiple](https://docs.birdeye.so/reference/get-defi-v3-token-exit-liquidity-multiple) | 13375 | Token - Liquidity (Multiple) |
| [direct/v1/Birdeye/perps/v1/token/liquidation\_map](https://docs.birdeye.so/reference/get-perps-v1-token-liquidation_map) | 70 | Perps - Token Liquidation Map |
| [direct/v1/Birdeye/perps/v1/token/list](https://docs.birdeye.so/reference/get-perps-v1-token-list) | 1415 | Perps - Token List |
| [direct/v1/Birdeye/perps/v1/token/open\_positions](https://docs.birdeye.so/reference/get-perps-v1-token-open_positions) | 70 | Perps - Token Open Positions |
| [direct/v1/Birdeye/perps/v1/token/overview](https://docs.birdeye.so/reference/get-perps-v1-token-overview) | 70 | Perps - Token Overview |
| [direct/v1/Birdeye/perps/v1/wallet/list](https://docs.birdeye.so/reference/get-perps-v1-wallet-list) | 70 | Perps - Wallet List |
| [direct/v1/Birdeye/perps/v1/wallet/open\_positions](https://docs.birdeye.so/reference/get-perps-v1-wallet-open_positions) | 70 | Perps - Wallet Open Positions |
| [direct/v1/Birdeye/perps/v1/wallet/overview](https://docs.birdeye.so/reference/get-perps-v1-wallet-overview) | 70 | Perps - Wallet Overview |
## Market Data
### GET
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------- |
| [direct/v1/Birdeye/defi/historical\_price\_unix](https://docs.birdeye.so/reference/get-defi-historical_price_unix) | 705 | Price - Historical by unix time |
| [direct/v1/Birdeye/defi/history\_price](https://docs.birdeye.so/reference/get-defi-history_price) | 4240 | Price - Historical |
| [direct/v1/Birdeye/defi/networks](https://docs.birdeye.so/reference/get-defi-networks) | 70 | Supported Networks |
| [direct/v1/Birdeye/defi/ohlcv](https://docs.birdeye.so/reference/get-defi-ohlcv) | 2825 | OHLCV |
| [direct/v1/Birdeye/defi/ohlcv/base\_quote](https://docs.birdeye.so/reference/get-defi-ohlcv-base_quote) | 2825 | OHLCV - Base/Quote |
| [direct/v1/Birdeye/defi/ohlcv/pair](https://docs.birdeye.so/reference/get-defi-ohlcv-pair) | 2825 | OHLCV - Pair |
| [direct/v1/Birdeye/defi/price](https://docs.birdeye.so/reference/get-defi-price) | 705 | Price |
| [direct/v1/Birdeye/defi/price\_volume/single](https://docs.birdeye.so/reference/get-defi-price_volume-single) | 1060 | Price Volume - Single |
| [direct/v1/Birdeye/defi/token\_overview](https://docs.birdeye.so/reference/get-defi-token_overview) | 2120 | Token - Overview |
| [direct/v1/Birdeye/defi/token\_trending](https://docs.birdeye.so/reference/get-defi-token_trending) | 3535 | Token - Trending List |
| [direct/v1/Birdeye/defi/txs/pair](https://docs.birdeye.so/reference/get-defi-txs-pair) | 705 | Trades - Pair |
| [direct/v1/Birdeye/defi/txs/pair/seek\_by\_time](https://docs.birdeye.so/reference/get-defi-txs-pair-seek_by_time) | 1060 | Trades - Pair Seek By Time |
| [direct/v1/Birdeye/defi/txs/token](https://docs.birdeye.so/reference/get-defi-txs-token) | 705 | Trades - Token |
| [direct/v1/Birdeye/defi/txs/token/seek\_by\_time](https://docs.birdeye.so/reference/get-defi-txs-token-seek_by_time) | 1060 | Trades - Token Seek By Time |
| [direct/v1/Birdeye/defi/v2/markets](https://docs.birdeye.so/reference/get-defi-v2-markets) | 3535 | Token - All Market List |
| [direct/v1/Birdeye/defi/v2/tokens/new\_listing](https://docs.birdeye.so/reference/get-defi-v2-tokens-new_listing) | 5655 | Token - New listing |
| [direct/v1/Birdeye/defi/v2/tokens/top\_traders](https://docs.birdeye.so/reference/get-defi-v2-tokens-top_traders) | 2120 | Token - Top traders |
| [direct/v1/Birdeye/defi/v3/all-time-trades/single](https://docs.birdeye.so/reference/get-defi-v3-all-time-trades-single) | 1765 | All Time Trades (Single) |
| [direct/v1/Birdeye/defi/v3/ohlcv](https://docs.birdeye.so/reference/get-defi-v3-ohlcv) | 6360 | OHLCV V3 |
| [direct/v1/Birdeye/defi/v3/ohlcv/pair](https://docs.birdeye.so/reference/get-defi-v3-ohlcv-pair) | 6360 | OHLCV V3 - Pair |
| [direct/v1/Birdeye/defi/v3/pair/overview/multiple](https://docs.birdeye.so/reference/get-defi-v3-pair-overview-multiple) | 8920 | Pair - Pair Overview (Multiple) |
| [direct/v1/Birdeye/defi/v3/pair/overview/single](https://docs.birdeye.so/reference/get-defi-v3-pair-overview-single) | 1415 | Pair - Pair Overview (Single) |
| [direct/v1/Birdeye/defi/v3/price/stats/single](https://docs.birdeye.so/reference/get-defi-v3-price-stats-single) | 1415 | Price stats (Single) |
| [direct/v1/Birdeye/defi/v3/search](https://docs.birdeye.so/reference/get-defi-v3-search) | 3535 | Search - Token, market Data |
| [direct/v1/Birdeye/defi/v3/token/exit-liquidity](https://docs.birdeye.so/reference/get-defi-v3-token-exit-liquidity) | 2120 | Token - Liquidity (Single) |
| [direct/v1/Birdeye/defi/v3/token/exit-liquidity /multiple](https://docs.birdeye.so/reference/get-defi-v3-token-exit-liquidity-multiple) | 13375 | Token - Liquidity (Multiple) |
| [direct/v1/Birdeye/defi/v3/token/list](https://docs.birdeye.so/reference/get-defi-v3-token-list) | 7065 | Token - List (V3) |
| [direct/v1/Birdeye/defi/v3/token/list/scroll](https://docs.birdeye.so/reference/get-defi-v3-token-list-scroll) | 35335 | Token - List (V3) Scroll |
| [direct/v1/Birdeye/defi/v3/token/market-data](https://docs.birdeye.so/reference/get-defi-v3-token-market-data) | 1060 | Token - Market Data (Single) |
| [direct/v1/Birdeye/defi/v3/token/market-data /multiple](https://docs.birdeye.so/reference/get-defi-v3-token-market-data-multiple) | 6690 | Token - Market Data (Multiple) |
| [direct/v1/Birdeye/defi/v3/token/meme/detail /single](https://docs.birdeye.so/reference/get-defi-v3-token-meme-detail-single) | 2120 | Meme Token Detail - Single |
| [direct/v1/Birdeye/defi/v3/token/meme/list](https://docs.birdeye.so/reference/get-defi-v3-token-meme-list) | 7065 | Meme Token - List |
| [direct/v1/Birdeye/defi/v3/token/trade-data /multiple](https://docs.birdeye.so/reference/get-defi-v3-token-trade-data-multiple) | 6690 | Token - Trade Data (Multiple) |
| [direct/v1/Birdeye/defi/v3/token/trade-data /single](https://docs.birdeye.so/reference/get-defi-v3-token-trade-data-single) | 1060 | Token - Trade Data (Single) |
| [direct/v1/Birdeye/defi/v3/token/txs](https://docs.birdeye.so/reference/get-defi-v3-token-txs) | 1415 | Trades - Token (V3) |
| [direct/v1/Birdeye/defi/v3/token/txs-by-volume](https://docs.birdeye.so/reference/get-defi-v3-token-txs-by-volume) | 1415 | Trades - Token Filtered By Volume (V3) |
| [direct/v1/Birdeye/defi/v3/txs](https://docs.birdeye.so/reference/get-defi-v3-txs) | 1765 | Trades - All (V3) |
| [direct/v1/Birdeye/defi/v3/txs/latest-block](https://docs.birdeye.so/reference/get-defi-v3-txs-latest-block) | 355 | Trades - Latest Block Number |
| [direct/v1/Birdeye/defi/v3/txs/recent](https://docs.birdeye.so/reference/get-defi-v3-txs-recent) | 6360 | Trades - Recent (V3) |
| [direct/v1/Birdeye/perps/v1/token/liquidation\_map](https://docs.birdeye.so/reference/get-perps-v1-token-liquidation_map) | 70 | Perps - Token Liquidation Map |
| [direct/v1/Birdeye/perps/v1/token/list](https://docs.birdeye.so/reference/get-perps-v1-token-list) | 1415 | Perps - Token List |
| [direct/v1/Birdeye/perps/v1/token/open\_positions](https://docs.birdeye.so/reference/get-perps-v1-token-open_positions) | 70 | Perps - Token Open Positions |
| [direct/v1/Birdeye/perps/v1/token/overview](https://docs.birdeye.so/reference/get-perps-v1-token-overview) | 70 | Perps - Token Overview |
| [direct/v1/Birdeye/perps/v1/wallet/list](https://docs.birdeye.so/reference/get-perps-v1-wallet-list) | 70 | Perps - Wallet List |
| [direct/v1/Birdeye/perps/v1/wallet/open\_positions](https://docs.birdeye.so/reference/get-perps-v1-wallet-open_positions) | 70 | Perps - Wallet Open Positions |
| [direct/v1/Birdeye/perps/v1/wallet/overview](https://docs.birdeye.so/reference/get-perps-v1-wallet-overview) | 70 | Perps - Wallet Overview |
| [direct/v1/Birdeye/smart-money/v1/token/list](https://docs.birdeye.so/reference/get-smart-money-v1-token-list) | 1415 | Smart Money - Token List |
| [direct/v1/Birdeye/trader/gainers-losers](https://docs.birdeye.so/reference/get-trader-gainers-losers) | 2120 | Trader - Gainers/Losers |
| [direct/v1/Birdeye/trader/txs/seek\_by\_time](https://docs.birdeye.so/reference/get-trader-txs-seek_by_time) | 1060 | Trader - Trades Seek By Time |
| [direct/v1/Birdeye/utils/v1/credits](https://docs.birdeye.so/reference/get-utils-v1-credits) | 70 | Utils - Credits Usage of current account |
| [direct/v1/Birdeye/wallet/v2/pnl](https://docs.birdeye.so/reference/get-wallet-v2-pnl) | 17835 | Wallet - PnL (Per Token) |
| [direct/v1/Birdeye/wallet/v2/pnl/multiple](https://docs.birdeye.so/reference/get-wallet-v2-pnl-multiple) | 17835 | Wallet - PnL (Per Wallet) |
| [direct/v1/Birdeye/wallet/v2/pnl/summary](https://docs.birdeye.so/reference/get-wallet-v2-pnl-summary) | 2825 | Wallet - PnL |
### POST
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------- |
| [direct/v1/Birdeye/defi/multi\_price](https://docs.birdeye.so/reference/post-defi-multi_price) | 2230 | Price - Multiple |
| [direct/v1/Birdeye/defi/price\_volume/multi](https://docs.birdeye.so/reference/post-defi-price_volume-multi) | 6690 | Price Volume - Multi |
| [direct/v1/Birdeye/defi/v3/all-time-trades /multiple](https://docs.birdeye.so/reference/post-defi-v3-all-time-trades-multiple) | 11145 | All Time Trades (Multiple) |
| [direct/v1/Birdeye/defi/v3/price/stats/multiple](https://docs.birdeye.so/reference/post-defi-v3-price-stats-multiple) | 8920 | Price stats (Multiple) |
| [direct/v1/Birdeye/defi/v3/tokens/list](https://docs.birdeye.so/reference/get-defi-v3-token-list) | 70 | Token - List (V3) |
| [direct/v1/Birdeye/wallet/v2/pnl/details](https://docs.birdeye.so/reference/post-wallet-v2-pnl-details) | 2825 | Wallet - PnL Details |
## Scan
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------- | ------: | ---------------- |
| [direct/v1/Birdeye/defi/token\_security](https://docs.birdeye.so/reference/get-defi-token_security) | 3535 | Token - Security |
## Token
### GET
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------- |
| [direct/v1/Birdeye/defi/historical\_price\_unix](https://docs.birdeye.so/reference/get-defi-historical_price_unix) | 705 | Price - Historical by unix time |
| [direct/v1/Birdeye/defi/history\_price](https://docs.birdeye.so/reference/get-defi-history_price) | 4240 | Price - Historical |
| [direct/v1/Birdeye/defi/ohlcv](https://docs.birdeye.so/reference/get-defi-ohlcv) | 2825 | OHLCV |
| [direct/v1/Birdeye/defi/ohlcv/base\_quote](https://docs.birdeye.so/reference/get-defi-ohlcv-base_quote) | 2825 | OHLCV - Base/Quote |
| [direct/v1/Birdeye/defi/price](https://docs.birdeye.so/reference/get-defi-price) | 705 | Price |
| [direct/v1/Birdeye/defi/price\_volume/single](https://docs.birdeye.so/reference/get-defi-price_volume-single) | 1060 | Price Volume - Single |
| [direct/v1/Birdeye/defi/token\_creation\_info](https://docs.birdeye.so/reference/get-defi-token_creation_info) | 5655 | Token - Creation Token Info |
| [direct/v1/Birdeye/defi/tokenlist](https://docs.birdeye.so/reference/get-defi-tokenlist) | 2120 | Token - List (V1) |
| [direct/v1/Birdeye/defi/token\_overview](https://docs.birdeye.so/reference/get-defi-token_overview) | 2120 | Token - Overview |
| [direct/v1/Birdeye/defi/token\_security](https://docs.birdeye.so/reference/get-defi-token_security) | 3535 | Token - Security |
| [direct/v1/Birdeye/defi/token\_trending](https://docs.birdeye.so/reference/get-defi-token_trending) | 3535 | Token - Trending List |
| [direct/v1/Birdeye/defi/txs/token](https://docs.birdeye.so/reference/get-defi-txs-token) | 705 | Trades - Token |
| [direct/v1/Birdeye/defi/txs/token/seek\_by\_time](https://docs.birdeye.so/reference/get-defi-txs-token-seek_by_time) | 1060 | Trades - Token Seek By Time |
| [direct/v1/Birdeye/defi/v2/tokens/new\_listing](https://docs.birdeye.so/reference/get-defi-v2-tokens-new_listing) | 5655 | Token - New listing |
| [direct/v1/Birdeye/defi/v2/tokens/top\_traders](https://docs.birdeye.so/reference/get-defi-v2-tokens-top_traders) | 2120 | Token - Top traders |
| [direct/v1/Birdeye/defi/v3/all-time-trades/single](https://docs.birdeye.so/reference/get-defi-v3-all-time-trades-single) | 1765 | All Time Trades (Single) |
| [direct/v1/Birdeye/defi/v3/ohlcv](https://docs.birdeye.so/reference/get-defi-v3-ohlcv) | 6360 | OHLCV V3 |
| [direct/v1/Birdeye/defi/v3/price/stats/single](https://docs.birdeye.so/reference/get-defi-v3-price-stats-single) | 1415 | Price stats (Single) |
| [direct/v1/Birdeye/defi/v3/search](https://docs.birdeye.so/reference/get-defi-v3-search) | 3535 | Search - Token, market Data |
| [direct/v1/Birdeye/defi/v3/token/exit-liquidity](https://docs.birdeye.so/reference/get-defi-v3-token-exit-liquidity) | 2120 | Token - Liquidity (Single) |
| [direct/v1/Birdeye/defi/v3/token/exit-liquidity /multiple](https://docs.birdeye.so/reference/get-defi-v3-token-exit-liquidity-multiple) | 13375 | Token - Liquidity (Multiple) |
| [direct/v1/Birdeye/defi/v3/token/holder](https://docs.birdeye.so/reference/get-defi-v3-token-holder) | 3535 | Token - Top Holders |
| [direct/v1/Birdeye/defi/v3/token/list](https://docs.birdeye.so/reference/get-defi-v3-token-list) | 7065 | Token - List (V3) |
| [direct/v1/Birdeye/defi/v3/token/list/scroll](https://docs.birdeye.so/reference/get-defi-v3-token-list-scroll) | 35335 | Token - List (V3) Scroll |
| [direct/v1/Birdeye/defi/v3/token/market-data](https://docs.birdeye.so/reference/get-defi-v3-token-market-data) | 1060 | Token - Market Data (Single) |
| [direct/v1/Birdeye/defi/v3/token/market-data /multiple](https://docs.birdeye.so/reference/get-defi-v3-token-market-data-multiple) | 6690 | Token - Market Data (Multiple) |
| [direct/v1/Birdeye/defi/v3/token/meme/detail /single](https://docs.birdeye.so/reference/get-defi-v3-token-meme-detail-single) | 2120 | Meme Token Detail - Single |
| [direct/v1/Birdeye/defi/v3/token/meme/list](https://docs.birdeye.so/reference/get-defi-v3-token-meme-list) | 7065 | Meme Token - List |
| [direct/v1/Birdeye/defi/v3/token/meta-data /multiple](https://docs.birdeye.so/reference/get-defi-v3-token-meta-data-multiple) | 2230 | Token - Metadata (Multiple) |
| [direct/v1/Birdeye/defi/v3/token/meta-data/single](https://docs.birdeye.so/reference/get-defi-v3-token-meta-data-single) | 355 | Token - Metadata (Single) |
| [direct/v1/Birdeye/defi/v3/token/mint-burn-txs](https://docs.birdeye.so/reference/get-defi-v3-token-mint-burn-txs) | 3535 | Token - Mint/Burn |
| [direct/v1/Birdeye/defi/v3/token/trade-data /multiple](https://docs.birdeye.so/reference/get-defi-v3-token-trade-data-multiple) | 6690 | Token - Trade Data (Multiple) |
| [direct/v1/Birdeye/defi/v3/token/trade-data /single](https://docs.birdeye.so/reference/get-defi-v3-token-trade-data-single) | 1060 | Token - Trade Data (Single) |
| [direct/v1/Birdeye/defi/v3/token/txs](https://docs.birdeye.so/reference/get-defi-v3-token-txs) | 1415 | Trades - Token (V3) |
| [direct/v1/Birdeye/defi/v3/token/txs-by-volume](https://docs.birdeye.so/reference/get-defi-v3-token-txs-by-volume) | 1415 | Trades - Token Filtered By Volume (V3) |
| [direct/v1/Birdeye/holder/v1/distribution](https://docs.birdeye.so/reference/get-holder-v1-distribution) | 70 | Token - Holder Distribution |
| [direct/v1/Birdeye/perps/v1/token/liquidation\_map](https://docs.birdeye.so/reference/get-perps-v1-token-liquidation_map) | 70 | Perps - Token Liquidation Map |
| [direct/v1/Birdeye/perps/v1/token/list](https://docs.birdeye.so/reference/get-perps-v1-token-list) | 1415 | Perps - Token List |
| [direct/v1/Birdeye/perps/v1/token/open\_positions](https://docs.birdeye.so/reference/get-perps-v1-token-open_positions) | 70 | Perps - Token Open Positions |
| [direct/v1/Birdeye/perps/v1/token/overview](https://docs.birdeye.so/reference/get-perps-v1-token-overview) | 70 | Perps - Token Overview |
| [direct/v1/Birdeye/smart-money/v1/token/list](https://docs.birdeye.so/reference/get-smart-money-v1-token-list) | 1415 | Smart Money - Token List |
| [direct/v1/Birdeye/trader/gainers-losers](https://docs.birdeye.so/reference/get-trader-gainers-losers) | 2120 | Trader - Gainers/Losers |
| [direct/v1/Birdeye/v1/wallet/token\_balance](https://docs.birdeye.so/reference/get-v1-wallet-token_balance) | 1060 | Wallet - Token Balance |
| [direct/v1/Birdeye/v1/wallet/token\_list](https://docs.birdeye.so/reference/get-v1-wallet-token_list) | 1060 | Wallet Portfolio |
| [direct/v1/Birdeye/wallet/v2/balance-change](https://docs.birdeye.so/reference/get-wallet-v2-balance-change) | 1415 | Wallet - Balance Change |
| [direct/v1/Birdeye/wallet/v2/current-net-worth](https://docs.birdeye.so/reference/get-wallet-v2-current-net-worth) | 7065 | Wallet - Current Net Worth |
| [direct/v1/Birdeye/wallet/v2/net-worth](https://docs.birdeye.so/reference/get-wallet-v2-net-worth) | 4240 | Wallet - Net Worth Chart |
| [direct/v1/Birdeye/wallet/v2/net-worth-details](https://docs.birdeye.so/reference/get-wallet-v2-net-worth-details) | 4240 | Wallet - Net Worth Details |
| [direct/v1/Birdeye/wallet/v2/pnl](https://docs.birdeye.so/reference/get-wallet-v2-pnl) | 17835 | Wallet - PnL (Per Token) |
| [direct/v1/Birdeye/wallet/v2/pnl/multiple](https://docs.birdeye.so/reference/get-wallet-v2-pnl-multiple) | 17835 | Wallet - PnL (Per Wallet) |
| [direct/v1/Birdeye/wallet/v2/pnl/summary](https://docs.birdeye.so/reference/get-wallet-v2-pnl-summary) | 2825 | Wallet - PnL |
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------- |
| [direct/v1/Birdeye/defi/multi\_price](https://docs.birdeye.so/reference/post-defi-multi_price) | 2230 | Price - Multiple |
| [direct/v1/Birdeye/defi/price\_volume/multi](https://docs.birdeye.so/reference/post-defi-price_volume-multi) | 6690 | Price Volume - Multi |
| [direct/v1/Birdeye/defi/v3/all-time-trades /multiple](https://docs.birdeye.so/reference/post-defi-v3-all-time-trades-multiple) | 11145 | All Time Trades (Multiple) |
| [direct/v1/Birdeye/defi/v3/price/stats/multiple](https://docs.birdeye.so/reference/post-defi-v3-price-stats-multiple) | 8920 | Price stats (Multiple) |
| [direct/v1/Birdeye/defi/v3/tokens/list](https://docs.birdeye.so/reference/get-defi-v3-token-list) | 70 | Token - List (V3) |
| [direct/v1/Birdeye/token/v1/holder/batch](https://docs.birdeye.so/reference/post-token-v1-holder-batch) | 70 | Token - Holder (Batch) |
| [direct/v1/Birdeye/token/v1/transfer](https://docs.birdeye.so/reference/post-token-v1-transfer) | 70 | Token - Transfer List |
| [direct/v1/Birdeye/token/v1/transfer/total](https://docs.birdeye.so/reference/post-token-v1-transfer-total) | 70 | Token - Transfer Total |
| [direct/v1/Birdeye/wallet/v2/net-worth-summary /multiple](https://docs.birdeye.so/reference/post-wallet-v2-net-worth-summary-multiple) | 22295 | Wallet - Current Net Worth Summary (Multiple) |
| [direct/v1/Birdeye/wallet/v2/pnl/details](https://docs.birdeye.so/reference/post-wallet-v2-pnl-details) | 2825 | Wallet - PnL Details |
| [direct/v1/Birdeye/wallet/v2/token-balance](https://docs.birdeye.so/reference/post-wallet-v2-token-balance) | 355 | Wallet - Tokens Balance |
## Transaction
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------ | ------: | -------------------------------------- |
| [direct/v1/Birdeye/defi/txs/pair](https://docs.birdeye.so/reference/get-defi-txs-pair) | 705 | Trades - Pair |
| [direct/v1/Birdeye/defi/txs/pair/seek\_by\_time](https://docs.birdeye.so/reference/get-defi-txs-pair-seek_by_time) | 1060 | Trades - Pair Seek By Time |
| [direct/v1/Birdeye/defi/txs/token](https://docs.birdeye.so/reference/get-defi-txs-token) | 705 | Trades - Token |
| [direct/v1/Birdeye/defi/txs/token/seek\_by\_time](https://docs.birdeye.so/reference/get-defi-txs-token-seek_by_time) | 1060 | Trades - Token Seek By Time |
| [direct/v1/Birdeye/defi/v3/all-time-trades/single](https://docs.birdeye.so/reference/get-defi-v3-all-time-trades-single) | 1765 | All Time Trades (Single) |
| [direct/v1/Birdeye/defi/v3/token/mint-burn-txs](https://docs.birdeye.so/reference/get-defi-v3-token-mint-burn-txs) | 3535 | Token - Mint/Burn |
| [direct/v1/Birdeye/defi/v3/token/txs](https://docs.birdeye.so/reference/get-defi-v3-token-txs) | 1415 | Trades - Token (V3) |
| [direct/v1/Birdeye/defi/v3/token/txs-by-volume](https://docs.birdeye.so/reference/get-defi-v3-token-txs-by-volume) | 1415 | Trades - Token Filtered By Volume (V3) |
| [direct/v1/Birdeye/defi/v3/txs](https://docs.birdeye.so/reference/get-defi-v3-txs) | 1765 | Trades - All (V3) |
| [direct/v1/Birdeye/defi/v3/txs/latest-block](https://docs.birdeye.so/reference/get-defi-v3-txs-latest-block) | 355 | Trades - Latest Block Number |
| [direct/v1/Birdeye/defi/v3/txs/recent](https://docs.birdeye.so/reference/get-defi-v3-txs-recent) | 6360 | Trades - Recent (V3) |
| [direct/v1/Birdeye/trader/txs/seek\_by\_time](https://docs.birdeye.so/reference/get-trader-txs-seek_by_time) | 1060 | Trader - Trades Seek By Time |
| [direct/v1/Birdeye/v1/wallet/tx\_list](https://docs.birdeye.so/reference/get-v1-wallet-tx_list) | 70 | Wallet Transaction History |
### POST
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------- |
| [direct/v1/Birdeye/defi/v3/all-time-trades /multiple](https://docs.birdeye.so/reference/post-defi-v3-all-time-trades-multiple) | 11145 | All Time Trades (Multiple) |
| [direct/v1/Birdeye/token/v1/transfer](https://docs.birdeye.so/reference/post-token-v1-transfer) | 70 | Token - Transfer List |
| [direct/v1/Birdeye/token/v1/transfer/total](https://docs.birdeye.so/reference/post-token-v1-transfer-total) | 70 | Token - Transfer Total |
| [direct/v1/Birdeye/wallet/v2/transfer](https://docs.birdeye.so/reference/post-wallet-v2-transfer) | 1415 | Wallet - Transfer |
| [direct/v1/Birdeye/wallet/v2/transfer/total](https://docs.birdeye.so/reference/post-wallet-v2-transfer-total) | 1415 | Wallet - Transfer total |
| [direct/v1/Birdeye/wallet/v2/tx/first-funded](https://docs.birdeye.so/reference/post-wallet-v2-tx-first-funded) | 1415 | Wallet - First Tx Funded |
## Wallets
### GET
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------- |
| [direct/v1/Birdeye/perps/v1/wallet/list](https://docs.birdeye.so/reference/get-perps-v1-wallet-list) | 70 | Perps - Wallet List |
| [direct/v1/Birdeye/perps/v1/wallet/open\_positions](https://docs.birdeye.so/reference/get-perps-v1-wallet-open_positions) | 70 | Perps - Wallet Open Positions |
| [direct/v1/Birdeye/perps/v1/wallet/overview](https://docs.birdeye.so/reference/get-perps-v1-wallet-overview) | 70 | Perps - Wallet Overview |
| [direct/v1/Birdeye/v1/wallet/list\_supported\_chain](https://docs.birdeye.so/reference/get-v1-wallet-list_supported_chain) | 70 | Supported Networks |
| [direct/v1/Birdeye/v1/wallet/token\_balance](https://docs.birdeye.so/reference/get-v1-wallet-token_balance) | 1060 | Wallet - Token Balance |
| [direct/v1/Birdeye/v1/wallet/token\_list](https://docs.birdeye.so/reference/get-v1-wallet-token_list) | 1060 | Wallet Portfolio |
| [direct/v1/Birdeye/v1/wallet/tx\_list](https://docs.birdeye.so/reference/get-v1-wallet-tx_list) | 70 | Wallet Transaction History |
| [direct/v1/Birdeye/wallet/v2/balance-change](https://docs.birdeye.so/reference/get-wallet-v2-balance-change) | 1415 | Wallet - Balance Change |
| [direct/v1/Birdeye/wallet/v2/current-net-worth](https://docs.birdeye.so/reference/get-wallet-v2-current-net-worth) | 7065 | Wallet - Current Net Worth |
| [direct/v1/Birdeye/wallet/v2/net-worth](https://docs.birdeye.so/reference/get-wallet-v2-net-worth) | 4240 | Wallet - Net Worth Chart |
| [direct/v1/Birdeye/wallet/v2/net-worth-details](https://docs.birdeye.so/reference/get-wallet-v2-net-worth-details) | 4240 | Wallet - Net Worth Details |
| [direct/v1/Birdeye/wallet/v2/pnl](https://docs.birdeye.so/reference/get-wallet-v2-pnl) | 17835 | Wallet - PnL (Per Token) |
| [direct/v1/Birdeye/wallet/v2/pnl/multiple](https://docs.birdeye.so/reference/get-wallet-v2-pnl-multiple) | 17835 | Wallet - PnL (Per Wallet) |
| [direct/v1/Birdeye/wallet/v2/pnl/summary](https://docs.birdeye.so/reference/get-wallet-v2-pnl-summary) | 2825 | Wallet - PnL |
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------- |
| [direct/v1/Birdeye/wallet/v2/net-worth-summary /multiple](https://docs.birdeye.so/reference/post-wallet-v2-net-worth-summary-multiple) | 22295 | Wallet - Current Net Worth Summary (Multiple) |
| [direct/v1/Birdeye/wallet/v2/pnl/details](https://docs.birdeye.so/reference/post-wallet-v2-pnl-details) | 2825 | Wallet - PnL Details |
| [direct/v1/Birdeye/wallet/v2/token-balance](https://docs.birdeye.so/reference/post-wallet-v2-token-balance) | 355 | Wallet - Tokens Balance |
| [direct/v1/Birdeye/wallet/v2/transfer](https://docs.birdeye.so/reference/post-wallet-v2-transfer) | 1415 | Wallet - Transfer |
| [direct/v1/Birdeye/wallet/v2/transfer/total](https://docs.birdeye.so/reference/post-wallet-v2-transfer-total) | 1415 | Wallet - Transfer total |
| [direct/v1/Birdeye/wallet/v2/tx/first-funded](https://docs.birdeye.so/reference/post-wallet-v2-tx-first-funded) | 1415 | Wallet - First Tx Funded |
# Codex direct API on Uniblock: tokens, NFTs, and market data
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-codex
Query Codex's 61 direct API endpoints on Uniblock for real-time token pricing, NFT metadata, DeFi charts, wallet activity, and cross-chain market data.
# Codex: Direct API Endpoints
Codex provides 61 unique direct API endpoints across the following categories:
* DeFi (20 endpoints)
* Market Data (6 endpoints)
* NFT (22 endpoints)
* Token (25 endpoints)
* Transaction (1 endpoint)
* Wallets (4 endpoints)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
> **Learn more:** [Codex Documentation](https://docs.codex.io/reference)
## Prefix and Example
**Prefix:** No prefix is required for Codex, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/Codex + /[Codex_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request POST \
--url https://api.uniblock.dev/direct/v1/Codex/filterNftPoolCollections \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## Request format: GraphQL over POST
Codex's underlying API is GraphQL. Uniblock exposes each Codex query as a REST-style `POST` endpoint whose path segment matches the Codex operation name exactly. For example, batch pricing is `direct/v1/Codex/getTokenPrices`, not `tokenPrices`. Use the paths listed in the tables below.
Every Codex endpoint accepts a standard GraphQL HTTP body with two fields:
* `query`: the GraphQL document as a string, using the arguments and fields from the linked Codex reference page
* `variables`: an object with values for any variables in the query (use `{}` if there are none)
**Example:** Look up a single token with `direct/v1/Codex/token`, which takes an `input` object of `address` and `networkId`:
```bash theme={null}
curl --request POST \
--url https://api.uniblock.dev/direct/v1/Codex/token \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{
"query": "{ token(input: { address: \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\", networkId: 1 }) { id address networkId name symbol decimals isScam } }",
"variables": {}
}'
```
Authenticate with your Uniblock API key in the `x-api-key` header. You do not need a Codex API key. The full schema for each query (arguments, response fields, network IDs) is documented on the linked Codex reference pages.
## DeFi
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------ | ------: | --------------------------------------------------------------------------------------- |
| [direct/v1/Codex/filterNftPoolCollections](https://docs.codex.io/reference/filternftpoolcollections) | 100 | Returns a list of NFT collections based on a variety of filters. |
| [direct/v1/Codex/filterNftPools](https://docs.codex.io/reference/filternftpools) | 100 | Returns a list of NFT pools based on a variety of filters. |
| [direct/v1/Codex/getDetailedPairsStats](https://docs.codex.io/reference/getdetailedpairsstats) | 100 | Returns bucketed stats for a given token within a list of pairs. |
| [direct/v1/Codex/getDetailedPairStats](https://docs.codex.io/reference/getdetailedpairstats) | 100 | Returns bucketed stats for a given token within a pair. |
| [direct/v1/Codex/getDetailedStats](https://docs.codex.io/reference/getdetailedstats) | 100 | Returns bucketed stats for a given token within a pair. |
| [direct/v1/Codex/getExchanges](https://docs.codex.io/reference/getexchanges) | 100 | Returns a list of decentralized exchange metadata. |
| [direct/v1/Codex/getLatestPairs](https://docs.codex.io/reference/getlatestpairs) | 100 | Returns new tokens listed over the last three days. |
| [direct/v1/Codex/getNftPool](https://docs.codex.io/reference/getnftpool) | 100 | Returns an NFT pool. |
| [direct/v1/Codex/getNftPoolCollection](https://docs.codex.io/reference/getnftpoolcollection) | 100 | Returns an NFT pool collection with pool stats for a given AMM NFT marketplace. |
| [direct/v1/Codex/getNftPoolCollectionsByExchange](https://docs.codex.io/reference/getnftpoolcollectionsbyexchange) | 100 | Returns an NFT collection with pool stats for a given AMM NFT marketplace. |
| [direct/v1/Codex/getNftPoolEvents](https://docs.codex.io/reference/getnftpoolevents) | 100 | Returns transactions for an NFT collection across all NFT pools or within a given pool. |
| [direct/v1/Codex /getNftPoolsByCollectionAndExchange](https://docs.codex.io/reference/getnftpoolsbycollectionandexchange) | 100 | Returns NFT pools for a given collection and AMM NFT marketplace. |
| [direct/v1/Codex/getNftPoolsByOwner](https://docs.codex.io/reference/getnftpoolsbyowner) | 100 | Returns a list of NFT pools for a given owner. |
| [direct/v1/Codex/getNftPoolStats](https://docs.codex.io/reference/getnftpoolstats) | 100 | Returns aggregated NFT pool/collection stats for a given time frame. |
| [direct/v1/Codex/getPrimePoolAssets](https://docs.codex.io/reference/getprimepoolassets) | 100 | Returns a list of Prime pool cached assets. |
| [direct/v1/Codex/getPrimePoolEvents](https://docs.codex.io/reference/getprimepoolevents) | 100 | Returns a list of Prime pool events. |
| [direct/v1/Codex/getPrimePools](https://docs.codex.io/reference/getprimepools) | 100 | Returns a list of Prime pools. |
| [direct/v1/Codex/getUniV3Ticks](https://docs.codex.io/reference/getuniv3ticks) | 100 | Returns tick data for a given Uniswap V3-style pool. |
| [direct/v1/Codex/pairMetadata](https://docs.codex.io/reference/pairmetadata) | 100 | Returns metadata for a pair of tokens. |
| [direct/v1/Codex/primeHolders](https://docs.codex.io/reference/primeholders) | 100 | Returns a list of holders of the PRIME token on ethereum. |
## Market Data
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------ | ------: | -------------------------------------------------------------------------------- |
| [direct/v1/Codex/filterExchanges](https://docs.codex.io/reference/filterexchanges) | 100 | Returns a list of exchanges based on a variety of filters. |
| [direct/v1/Codex/filterPairs](https://docs.codex.io/reference/filterpairs) | 100 | Returns a list of pairs based on a variety of filters. |
| [direct/v1/Codex/getBars](https://docs.codex.io/reference/getbars) | 100 | Returns bar chart data to track price changes over time. |
| [direct/v1/Codex/getDetailedStats](https://docs.codex.io/reference/getdetailedstats) | 100 | Returns bucketed stats for a given token within a pair. |
| [direct/v1/Codex/getTokenPrices](https://docs.codex.io/reference/gettokenprices) | 100 | Returns real-time or historical prices for a list of tokens, fetched in batches. |
| [direct/v1/Codex/tokenSparklines](https://docs.codex.io/reference/tokensparklines) | 100 | Returns a list of token simple chart data (sparklines) for the given tokens. |
## NFT
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------ | ------: | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Codex/filterNftCollections](https://docs.codex.io/reference/filternftcollections) | 100 | Returns a list of NFT collection based on a variety of filters. |
| [direct/v1/Codex/filterNftParallelAssets](https://docs.codex.io/reference/filternftparallelassets) | 100 | Returns a list of Parallel assets based on a variety of filters. |
| [direct/v1/Codex/filterNftPoolCollections](https://docs.codex.io/reference/filternftpoolcollections) | 100 | Returns a list of NFT collections based on a variety of filters. |
| [direct/v1/Codex/filterNftPools](https://docs.codex.io/reference/filternftpools) | 100 | Returns a list of NFT pools based on a variety of filters. |
| [direct/v1/Codex/getDetailedNftStats](https://docs.codex.io/reference/getdetailednftstats) | 100 | Returns bucketed stats for a given NFT collection. |
| [direct/v1/Codex/getNftAssets](https://docs.codex.io/reference/getnftassets) | 100 | Returns a list of NFT assets in a given collection. |
| [direct/v1/Codex/getNftCollectionMetadata](https://docs.codex.io/reference/getnftcollectionmetadata) | 100 | Returns stats for an NFT collection across different time frames. |
| [direct/v1/Codex/getNftContracts](https://docs.codex.io/reference/getnftcontracts) | 100 | Returns a list of NFT collection metadata. |
| [direct/v1/Codex/getNftEvents](https://docs.codex.io/reference/getnftevents) | 100 | Returns transactions for an NFT collection across any marketplace(s). |
| [direct/v1/Codex/getNftPool](https://docs.codex.io/reference/getnftpool) | 100 | Returns an NFT pool. |
| [direct/v1/Codex/getNftPoolCollection](https://docs.codex.io/reference/getnftpoolcollection) | 100 | Returns an NFT pool collection with pool stats for a given AMM NFT marketplace. |
| [direct/v1/Codex/getNftPoolCollectionsByExchange](https://docs.codex.io/reference/getnftpoolcollectionsbyexchange) | 100 | Returns an NFT collection with pool stats for a given AMM NFT marketplace. |
| [direct/v1/Codex/getNftPoolEvents](https://docs.codex.io/reference/getnftpoolevents) | 100 | Returns transactions for an NFT collection across all NFT pools or within a given pool. |
| [direct/v1/Codex /getNftPoolsByCollectionAndExchange](https://docs.codex.io/reference/getnftpoolsbycollectionandexchange) | 100 | Returns NFT pools for a given collection and AMM NFT marketplace. |
| [direct/v1/Codex/getNftPoolsByOwner](https://docs.codex.io/reference/getnftpoolsbyowner) | 100 | Returns a list of NFT pools for a given owner. |
| [direct/v1/Codex/getNftPoolStats](https://docs.codex.io/reference/getnftpoolstats) | 100 | Returns aggregated NFT pool/collection stats for a given time frame. |
| [direct/v1/Codex/getParallelAssets](https://docs.codex.io/reference/getparallelassets) | 100 | Returns transactions for an NFT collection across any marketplace(s). |
| [direct/v1/Codex/getParallelCardChanges](https://docs.codex.io/reference/getparallelcardchanges) | 100 | Returns changes made to Parallel card metadata over time. |
| [direct/v1/Codex/nftHolders](https://docs.codex.io/reference/nftholders) | 100 | Returns list of wallets that hold a given collection, ordered by holdings descending. Also has the unique count of holders for that collection |
| [direct/v1/Codex/searchNfts](https://docs.codex.io/reference/searchnfts) | 100 | Returns a list of NFT collections matching a given query string. |
| [direct/v1/Codex/walletNftCollectionAssets](https://docs.codex.io/reference/walletnftcollectionassets) | 100 | Returns list of NFT assets held by a given wallet for a single collection. |
| [direct/v1/Codex/walletNftCollections](https://docs.codex.io/reference/walletnftcollections) | 100 | Returns list of collections and quantity of NFTs held by a given wallet. |
## Token
### POST
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------------------------------------------------------ |
| [direct/v1/Codex/balances](https://docs.codex.io/reference/balances) | 100 | Returns list of token balances that a wallet has |
| [direct/v1/Codex/chartUrls](https://docs.codex.io/reference/charturls) | 100 | Returns a URL for a pair chart. |
| [direct/v1/Codex/filterTokens](https://docs.codex.io/reference/filtertokens) | 100 | Returns a list of tokens based on a variety of filters. |
| [direct/v1/Codex/getBars](https://docs.codex.io/reference/getbars) | 100 | Returns bar chart data to track price changes over time. |
| [direct/v1/Codex/getCommunityNotes](https://docs.codex.io/reference/getcommunitynotes) | 100 | Returns community gathered notes. |
| [direct/v1/Codex/getDetailedStats](https://docs.codex.io/reference/getdetailedstats) | 100 | Returns bucketed stats for a given token within a pair. |
| [direct/v1/Codex/getLatestTokens](https://docs.codex.io/reference/getlatesttokens) | 100 | Returns new tokens listed over the last three days. |
| [direct/v1/Codex/getNetworks](https://docs.codex.io/reference/getnetworks) | 100 | Returns a list of all networks supported on Codex. |
| [direct/v1/Codex/getNetworkStatus](https://docs.codex.io/reference/getnetworkstatus) | 100 | Returns the status of a list of networks supported on Codex. |
| [direct/v1/Codex/getSimulateTokenContractResults](https://docs.codex.io/reference/simulatetokencontractresults) | 100 | Simulates a token contract call. |
| [direct/v1/Codex/getSymbol](https://docs.codex.io/reference/getsymbol) | 100 | Returns metadata for a given pair. |
| [direct/v1/Codex/getTokenCount](https://docs.codex.io/reference/gettokencount) | 100 | Returns the total count of tokens on Codex. This value is updated approximately every 6 hours. |
| [direct/v1/Codex/getTokenEvents](https://docs.codex.io/reference/gettokenevents) | 100 | Returns transactions for a pair. |
| [direct/v1/Codex/getTokenInfo](https://docs.codex.io/reference/gettokeninfo) | 100 | Returns metadata for a given token. |
| [direct/v1/Codex/getTokenPrices](https://docs.codex.io/reference/gettokenprices) | 100 | Returns real-time or historical prices for a list of tokens, fetched in batches. |
| [direct/v1/Codex/getTokensInfo](https://docs.codex.io/reference/gettokensinfo) | 100 | Returns metadata for a list of given tokens. |
| [direct/v1/Codex/holders](https://docs.codex.io/reference/holders) | 100 | Returns list of wallets that hold a given token, ordered by holdings descending. Also has the unique count of holders for that token |
| [direct/v1/Codex/listFavoriteTokens](https://docs.codex.io/reference/listfavoritetokens) | 100 | Returns a list of token metadata. |
| [direct/v1/Codex/listPairsForToken](https://docs.codex.io/reference/listpairsfortoken) | 100 | Returns a list of pairs containing a given token. |
| [direct/v1/Codex/listPairsWithMetadataForToken](https://docs.codex.io/reference/listpairswithmetadatafortoken) | 100 | Returns a list of pair metadata for a token. |
| [direct/v1/Codex/listTopTokens](https://docs.codex.io/reference/listtoptokens) | 100 | Returns a list of trending tokens across any given network(s). |
| [direct/v1/Codex/searchTokens](https://docs.codex.io/reference/searchtokens) | 100 | Returns a list of tokens matching a given query string. |
| [direct/v1/Codex/token](https://docs.codex.io/reference/token) | 100 | Find a single token by its address & network id. |
| [direct/v1/Codex/tokens](https://docs.codex.io/reference/tokens) | 100 | Find a list of tokens by their addresses & network id, with pagination. |
| [direct/v1/Codex/tokenSparklines](https://docs.codex.io/reference/tokensparklines) | 100 | Returns a list of token simple chart data (sparklines) for the given tokens. |
## Transaction
### POST
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------- | ------: | ------------------------------------------ |
| [direct/v1/Codex/getEventLabels](https://docs.codex.io/reference/geteventlabels) | 100 | Returns a list of event labels for a pair. |
## Wallets
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------ | ------: | -------------------------------------------------------------------------- |
| [direct/v1/Codex/balances](https://docs.codex.io/reference/balances) | 100 | Returns list of token balances that a wallet has |
| [direct/v1/Codex/primeBalance](https://docs.codex.io/reference/primebalance) | 100 | Fetch the balance of a wallet holding PRIME on ethereum |
| [direct/v1/Codex/walletNftCollectionAssets](https://docs.codex.io/reference/walletnftcollectionassets) | 100 | Returns list of NFT assets held by a given wallet for a single collection. |
| [direct/v1/Codex/walletNftCollections](https://docs.codex.io/reference/walletnftcollections) | 100 | Returns list of collections and quantity of NFTs held by a given wallet. |
# CoinGecko direct API on Uniblock: prices, market data, DeFi
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-coingecko
Query CoinGecko's 79 direct API endpoints on Uniblock for coin prices, market caps, historical charts, DeFi metrics, NFT floors, and token metadata.
# CoinGecko: Direct API Endpoints
CoinGecko provides 79 unique direct API endpoints across the following categories:
* DeFi (37 endpoints)
* Market Data (71 endpoints)
* NFT (7 endpoints)
* Other (8 endpoints)
* SocialFi (3 endpoints)
* Token (26 endpoints)
* Wallets (8 endpoints)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
> **Learn more:** [CoinGecko Documentation](https://docs.coingecko.com/reference)
## Prefix and Example
**Prefix:** No prefix is required for CoinGecko, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/CoinGecko + /[CoinGecko_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/CoinGecko/coins/{id} \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## DeFi
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------- |
| [direct/v1/CoinGecko/coins/\{id}](https://docs.coingecko.com/reference/coins-id) | 2600 | Coin Data by ID |
| [direct/v1/CoinGecko/coins/\{id}/contract /\{contract\_address}](https://docs.coingecko.com/reference/coins-contract-address) | 2600 | Coin Data by Token Address |
| [direct/v1/CoinGecko/coins/\{id}/history](https://docs.coingecko.com/reference/coins-id-history) | 2600 | Coin Historical Data by ID |
| [direct/v1/CoinGecko/coins/list/new](https://docs.coingecko.com/reference/coins-list-new) | 2600 | 💼 Recently Added Coins |
| [direct/v1/CoinGecko/coins/\{id}/market\_chart](https://docs.coingecko.com/reference/coins-id-market-chart) | 2600 | Coin Historical Chart Data by ID |
| [direct/v1/CoinGecko/coins/\{id}/market\_chart /range](https://docs.coingecko.com/reference/coins-id-market-chart-range) | 2600 | Coin Historical Chart Data within Time Range by ID |
| [direct/v1/CoinGecko/coins/markets](https://docs.coingecko.com/reference/coins-markets) | 2600 | Coins List with Market Data |
| [direct/v1/CoinGecko/coins/\{id}/ohlc](https://docs.coingecko.com/reference/coins-id-ohlc) | 2600 | Coin OHLC Chart by ID |
| [direct/v1/CoinGecko/coins/\{id}/ohlc/range](https://docs.coingecko.com/reference/coins-id-ohlc-range) | 2600 | 💼 Coin OHLC Chart within Time Range by ID |
| [direct/v1/CoinGecko/coins/top\_gainers\_losers](https://docs.coingecko.com/reference/coins-top-gainers-losers) | 2600 | 💼 Top Gainers & Losers |
| [direct/v1/CoinGecko/derivatives](https://docs.coingecko.com/reference/derivatives-tickers) | 2600 | Derivatives Tickers List |
| [direct/v1/CoinGecko/derivatives/exchanges](https://docs.coingecko.com/reference/derivatives-exchanges) | 2600 | Derivatives Exchanges List with Data |
| [direct/v1/CoinGecko/derivatives/exchanges/\{id}](https://docs.coingecko.com/reference/derivatives-exchanges-id) | 2600 | Derivatives Exchange Data by ID |
| [direct/v1/CoinGecko/derivatives/exchanges/list](https://docs.coingecko.com/reference/derivatives-exchanges-list) | 2600 | Derivatives Exchanges List (ID Map) |
| [direct/v1/CoinGecko/exchanges](https://docs.coingecko.com/reference/exchanges) | 2600 | Exchanges List with data |
| [direct/v1/CoinGecko/exchanges/\{id}](https://docs.coingecko.com/reference/exchanges-id) | 2600 | Exchange Data by ID |
| [direct/v1/CoinGecko/exchanges/list](https://docs.coingecko.com/reference/exchanges-list) | 2600 | Exchanges List (ID Map) |
| [direct/v1/CoinGecko/exchanges/\{id}/tickers](https://docs.coingecko.com/reference/exchanges-id-tickers) | 2600 | Exchange Tickers by ID |
| [direct/v1/CoinGecko/exchanges/\{id}/volume\_chart](https://docs.coingecko.com/reference/exchanges-id-volume-chart) | 2600 | Exchange Volume Chart by ID |
| [direct/v1/CoinGecko/exchanges/\{id}/volume\_chart /range](https://docs.coingecko.com/reference/exchanges-id-volume-chart-range) | 2600 | 💼 Exchange Volume Chart within Time Range by ID |
| [direct/v1/CoinGecko/nfts/\{id}/market\_chart](https://docs.coingecko.com/reference/nfts-id-market-chart) | 2600 | 💼 NFTs Collection Historical Chart Data by ID |
| [direct/v1/CoinGecko/onchain/networks/\{network} /dexes/\{dex}/pools](https://docs.coingecko.com/reference/top-pools-dex) | 2600 | Top Pools by Dex |
| [direct/v1/CoinGecko/onchain/networks/new\_pools](https://docs.coingecko.com/reference/latest-pools-list) | 2600 | New Pools List |
| [direct/v1/CoinGecko/onchain/networks/\{network} /new\_pools](https://docs.coingecko.com/reference/latest-pools-network) | 2600 | New Pools by Network |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools](https://docs.coingecko.com/reference/top-pools-network) | 2600 | Top Pools by Network |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools/\{address}](https://docs.coingecko.com/reference/pool-address) | 2600 | Specific Pool Data by Pool Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools/\{pool\_address}/info](https://docs.coingecko.com/reference/pool-token-info-contract-address) | 2600 | Pool Tokens Info by Pool Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools/multi/\{addresses}](https://docs.coingecko.com/reference/pools-addresses) | 2600 | Multiple Pools Data by Pool Addresses |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools/\{pool\_address}/ohlcv/\{timeframe}](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) | 2600 | Pool OHLCV chart by Pool Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools/\{pool\_address}/trades](https://docs.coingecko.com/reference/pool-trades-contract-address) | 2600 | Past 24 Hour Trades by Pool Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /tokens/\{token\_address}/pools](https://docs.coingecko.com/reference/top-pools-contract-address) | 2600 | Top Pools by Token Address |
| direct/v1/CoinGecko/onchain/networks /trending\_pools | 2600 | Trending Pools List |
| [direct/v1/CoinGecko/onchain/networks/\{network} /trending\_pools](https://docs.coingecko.com/reference/trending-pools-list) | 2600 | Trending Pools by Network |
| [direct/v1/CoinGecko/onchain/search/pools](https://docs.coingecko.com/reference/search-pools) | 2600 | Search Pools |
| direct/v1/CoinGecko/simple/price | 2600 | Coin Price by IDs |
| [direct/v1/CoinGecko/simple /supported\_vs\_currencies](https://docs.coingecko.com/reference/simple-supported-currencies) | 2600 | Supported Currencies List |
| [direct/v1/CoinGecko/simple/token\_price/\{id}](https://docs.coingecko.com/reference/simple-price) | 2600 | Coin Price by Token Addresses |
## Market Data
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------- |
| [direct/v1/CoinGecko/asset\_platforms](https://docs.coingecko.com/reference/asset-platforms) | 2600 | Asset Platforms List (ID Map) |
| [direct/v1/CoinGecko/coins/\{id}](https://docs.coingecko.com/reference/coins-id) | 2600 | Coin Data by ID |
| [direct/v1/CoinGecko/coins/categories](https://docs.coingecko.com/reference/coins-categories) | 2600 | Coins Categories List with Market Data |
| [direct/v1/CoinGecko/coins/categories/list](https://docs.coingecko.com/reference/coins-categories-list) | 2600 | Coins Categories List (ID Map) |
| [direct/v1/CoinGecko/coins/\{id} /circulating\_supply\_chart](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart) | 2600 | 👑 Circulating Supply Chart by ID |
| [direct/v1/CoinGecko/coins/\{id} /circulating\_supply\_chart/range](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart-range) | 2600 | 👑 Circulating Supply chart within Time Range by ID |
| [direct/v1/CoinGecko/coins/\{id}/contract /\{contract\_address}](https://docs.coingecko.com/reference/coins-contract-address) | 2600 | Coin Data by Token Address |
| [direct/v1/CoinGecko/coins/\{id}/contract /\{contract\_address}/market\_chart](https://docs.coingecko.com/reference/contract-address-market-chart) | 2600 | Coin Historical Chart Data by Token Address |
| [direct/v1/CoinGecko/coins/\{id}/contract /\{contract\_address}/market\_chart/range](https://docs.coingecko.com/reference/contract-address-market-chart-range) | 2600 | Coin Historical Chart Data within Time Range by Token Address |
| [direct/v1/CoinGecko/coins/\{id}/history](https://docs.coingecko.com/reference/coins-id-history) | 2600 | Coin Historical Data by ID |
| [direct/v1/CoinGecko/coins/list](https://docs.coingecko.com/reference/coins-list) | 2600 | Coins List (ID Map) |
| [direct/v1/CoinGecko/coins/list/new](https://docs.coingecko.com/reference/coins-list-new) | 2600 | 💼 Recently Added Coins |
| [direct/v1/CoinGecko/coins/\{id}/market\_chart](https://docs.coingecko.com/reference/coins-id-market-chart) | 2600 | Coin Historical Chart Data by ID |
| [direct/v1/CoinGecko/coins/\{id}/market\_chart /range](https://docs.coingecko.com/reference/coins-id-market-chart-range) | 2600 | Coin Historical Chart Data within Time Range by ID |
| [direct/v1/CoinGecko/coins/markets](https://docs.coingecko.com/reference/coins-markets) | 2600 | Coins List with Market Data |
| [direct/v1/CoinGecko/coins/\{id}/ohlc](https://docs.coingecko.com/reference/coins-id-ohlc) | 2600 | Coin OHLC Chart by ID |
| [direct/v1/CoinGecko/coins/\{id}/ohlc/range](https://docs.coingecko.com/reference/coins-id-ohlc-range) | 2600 | 💼 Coin OHLC Chart within Time Range by ID |
| [direct/v1/CoinGecko/coins/\{id}/tickers](https://docs.coingecko.com/reference/coins-id-tickers) | 2600 | Coin Tickers by ID |
| [direct/v1/CoinGecko/coins/top\_gainers\_losers](https://docs.coingecko.com/reference/coins-top-gainers-losers) | 2600 | 💼 Top Gainers & Losers |
| [direct/v1/CoinGecko/coins/\{id} /total\_supply\_chart](https://docs.coingecko.com/reference/coins-id-total-supply-chart) | 2600 | 👑 Total Supply Chart by ID |
| [direct/v1/CoinGecko/coins/\{id} /total\_supply\_chart/range](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range) | 2600 | 👑 Total Supply chart within time range by ID |
| [direct/v1/CoinGecko/companies/public\_treasury /\{coin\_id}](https://docs.coingecko.com/reference/companies-public-treasury) | 2600 | Public Companies Holdings |
| [direct/v1/CoinGecko/derivatives](https://docs.coingecko.com/reference/derivatives-tickers) | 2600 | Derivatives Tickers List |
| [direct/v1/CoinGecko/derivatives/exchanges](https://docs.coingecko.com/reference/derivatives-exchanges) | 2600 | Derivatives Exchanges List with Data |
| [direct/v1/CoinGecko/derivatives/exchanges/\{id}](https://docs.coingecko.com/reference/derivatives-exchanges-id) | 2600 | Derivatives Exchange Data by ID |
| [direct/v1/CoinGecko/derivatives/exchanges/list](https://docs.coingecko.com/reference/derivatives-exchanges-list) | 2600 | Derivatives Exchanges List (ID Map) |
| [direct/v1/CoinGecko/exchange\_rates](https://docs.coingecko.com/reference/exchange-rates) | 2600 | BTC-to-Currency Exchange Rates |
| [direct/v1/CoinGecko/exchanges](https://docs.coingecko.com/reference/exchanges) | 2600 | Exchanges List with data |
| [direct/v1/CoinGecko/exchanges/\{id}](https://docs.coingecko.com/reference/exchanges-id) | 2600 | Exchange Data by ID |
| [direct/v1/CoinGecko/exchanges/list](https://docs.coingecko.com/reference/exchanges-list) | 2600 | Exchanges List (ID Map) |
| [direct/v1/CoinGecko/exchanges/\{id}/tickers](https://docs.coingecko.com/reference/exchanges-id-tickers) | 2600 | Exchange Tickers by ID |
| [direct/v1/CoinGecko/exchanges/\{id}/volume\_chart](https://docs.coingecko.com/reference/exchanges-id-volume-chart) | 2600 | Exchange Volume Chart by ID |
| [direct/v1/CoinGecko/exchanges/\{id}/volume\_chart /range](https://docs.coingecko.com/reference/exchanges-id-volume-chart-range) | 2600 | 💼 Exchange Volume Chart within Time Range by ID |
| [direct/v1/CoinGecko/global](https://docs.coingecko.com/reference/crypto-global) | 2600 | Crypto Global Market Data |
| [direct/v1/CoinGecko/global /decentralized\_finance\_defi](https://docs.coingecko.com/reference/global-defi) | 2600 | Global De-Fi Market Data |
| [direct/v1/CoinGecko/global/market\_cap\_chart](https://docs.coingecko.com/reference/global-market-cap-chart) | 2600 | 💼 Global Market Cap Chart Data |
| [direct/v1/CoinGecko/key](https://docs.coingecko.com/reference/api-usage) | 2600 | 💼 API Usage |
| [direct/v1/CoinGecko/nfts/\{id}](https://docs.coingecko.com/reference/nfts-id) | 2600 | NFTs Collection Data by ID |
| [direct/v1/CoinGecko/nfts/\{asset\_platform\_id} /contract/\{contract\_address}](https://docs.coingecko.com/reference/nfts-contract-address) | 2600 | NFTs Collection Data by Contract Address |
| [direct/v1/CoinGecko/nfts/\{asset\_platform\_id} /contract/\{contract\_address}/market\_chart](https://docs.coingecko.com/reference/nfts-contract-address-market-chart) | 2600 | 💼 NFTs Collection Historical Chart Data by Contract Address |
| [direct/v1/CoinGecko/nfts/list](https://docs.coingecko.com/reference/nfts-list) | 2600 | NFTs List (ID Map) |
| [direct/v1/CoinGecko/nfts/\{id}/market\_chart](https://docs.coingecko.com/reference/nfts-id-market-chart) | 2600 | 💼 NFTs Collection Historical Chart Data by ID |
| [direct/v1/CoinGecko/nfts/markets](https://docs.coingecko.com/reference/nfts-markets) | 2600 | 💼 NFTs List with Market Data |
| [direct/v1/CoinGecko/nfts/\{id}/tickers](https://docs.coingecko.com/reference/nfts-id-tickers) | 2600 | 💼 NFTs Collection Tickers by ID |
| [direct/v1/CoinGecko/onchain/networks](https://docs.coingecko.com/reference/networks-list) | 2600 | Supported Networks List (ID Map) |
| [direct/v1/CoinGecko/onchain/networks/\{network} /dexes](https://docs.coingecko.com/reference/dexes-list) | 2600 | Supported Dexes List by Network (ID Map) |
| [direct/v1/CoinGecko/onchain/networks/\{network} /dexes/\{dex}/pools](https://docs.coingecko.com/reference/top-pools-dex) | 2600 | Top Pools by Dex |
| [direct/v1/CoinGecko/onchain/networks/new\_pools](https://docs.coingecko.com/reference/latest-pools-list) | 2600 | New Pools List |
| [direct/v1/CoinGecko/onchain/networks/\{network} /new\_pools](https://docs.coingecko.com/reference/latest-pools-network) | 2600 | New Pools by Network |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools](https://docs.coingecko.com/reference/top-pools-network) | 2600 | Top Pools by Network |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools/\{address}](https://docs.coingecko.com/reference/pool-address) | 2600 | Specific Pool Data by Pool Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools/\{pool\_address}/info](https://docs.coingecko.com/reference/pool-token-info-contract-address) | 2600 | Pool Tokens Info by Pool Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools/multi/\{addresses}](https://docs.coingecko.com/reference/pools-addresses) | 2600 | Multiple Pools Data by Pool Addresses |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools/\{pool\_address}/ohlcv/\{timeframe}](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) | 2600 | Pool OHLCV chart by Pool Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools/\{pool\_address}/trades](https://docs.coingecko.com/reference/pool-trades-contract-address) | 2600 | Past 24 Hour Trades by Pool Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /tokens/\{address}](https://docs.coingecko.com/reference/token-data-contract-address) | 2600 | Token Data by Token Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /tokens/\{address}/info](https://docs.coingecko.com/reference/token-info-contract-address) | 2600 | Token Info by Token Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /tokens/multi/\{addresses}](https://docs.coingecko.com/reference/tokens-data-contract-addresses) | 2600 | Tokens Data by Token Addresses |
| [direct/v1/CoinGecko/onchain/networks/\{network} /tokens/\{token\_address}/pools](https://docs.coingecko.com/reference/top-pools-contract-address) | 2600 | Top Pools by Token Address |
| direct/v1/CoinGecko/onchain/networks /trending\_pools | 2600 | Trending Pools List |
| [direct/v1/CoinGecko/onchain/networks/\{network} /trending\_pools](https://docs.coingecko.com/reference/trending-pools-list) | 2600 | Trending Pools by Network |
| [direct/v1/CoinGecko/onchain/search/pools](https://docs.coingecko.com/reference/search-pools) | 2600 | Search Pools |
| [direct/v1/CoinGecko/onchain/simple/networks /\{network}/token\_price/\{addresses}](https://docs.coingecko.com/reference/onchain-simple-price) | 2600 | Token Price by Token Addresses |
| [direct/v1/CoinGecko/onchain/tokens /info\_recently\_updated](https://docs.coingecko.com/reference/tokens-info-recent-updated) | 2600 | Most Recently Updated Tokens List |
| [direct/v1/CoinGecko/ping](https://docs.coingecko.com/reference/ping-server) | 2600 | Check API server status |
| [direct/v1/CoinGecko/search](https://docs.coingecko.com/reference/search-data) | 2600 | Search Queries |
| [direct/v1/CoinGecko/search/trending](https://docs.coingecko.com/reference/search-trending) | 2600 | Trending Search List |
| direct/v1/CoinGecko/simple/price | 2600 | Coin Price by IDs |
| [direct/v1/CoinGecko/simple /supported\_vs\_currencies](https://docs.coingecko.com/reference/simple-supported-currencies) | 2600 | Supported Currencies List |
| [direct/v1/CoinGecko/simple/token\_price/\{id}](https://docs.coingecko.com/reference/simple-price) | 2600 | Coin Price by Token Addresses |
| [direct/v1/CoinGecko/token\_lists /\{asset\_platform\_id}/all.json](https://docs.coingecko.com/reference/token-lists) | 2600 | 👑 Token Lists by Asset Platform ID |
## NFT
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------ |
| [direct/v1/CoinGecko/nfts/\{id}](https://docs.coingecko.com/reference/nfts-id) | 2600 | NFTs Collection Data by ID |
| [direct/v1/CoinGecko/nfts/\{asset\_platform\_id} /contract/\{contract\_address}](https://docs.coingecko.com/reference/nfts-contract-address) | 2600 | NFTs Collection Data by Contract Address |
| [direct/v1/CoinGecko/nfts/\{asset\_platform\_id} /contract/\{contract\_address}/market\_chart](https://docs.coingecko.com/reference/nfts-contract-address-market-chart) | 2600 | 💼 NFTs Collection Historical Chart Data by Contract Address |
| [direct/v1/CoinGecko/nfts/list](https://docs.coingecko.com/reference/nfts-list) | 2600 | NFTs List (ID Map) |
| [direct/v1/CoinGecko/nfts/\{id}/market\_chart](https://docs.coingecko.com/reference/nfts-id-market-chart) | 2600 | 💼 NFTs Collection Historical Chart Data by ID |
| [direct/v1/CoinGecko/nfts/markets](https://docs.coingecko.com/reference/nfts-markets) | 2600 | 💼 NFTs List with Market Data |
| [direct/v1/CoinGecko/nfts/\{id}/tickers](https://docs.coingecko.com/reference/nfts-id-tickers) | 2600 | 💼 NFTs Collection Tickers by ID |
## Other
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------- |
| [direct/v1/CoinGecko/onchain/categories](https://docs.coingecko.com/reference/categories-list) | 2600 | 💼 Categories List |
| [direct/v1/CoinGecko/onchain/categories /\{category\_id}/pools](https://docs.coingecko.com/reference/pools-category) | 2600 | 💼 Pools by Category ID |
| [direct/v1/CoinGecko/onchain/networks/\{network} /tokens/\{address}/holders\_chart](https://docs.coingecko.com/reference/token-holders-chart-token-address) | 2600 | 💼 Historical Token Holders Chart by Token Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /tokens/\{address}/ohlcv/\{timeframe}](https://docs.coingecko.com/reference/token-ohlcv-token-address) | 2600 | 💼 Token OHLCV chart by Token Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /tokens/\{address}/top\_holders](https://docs.coingecko.com/reference/top-token-holders-token-address) | 2600 | 💼 Top Token Holders by Token Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /tokens/\{address}/trades](https://docs.coingecko.com/reference/token-trades-contract-address) | 2600 | 💼 Past 24 Hour Trades by Token Address |
| [direct/v1/CoinGecko/onchain/pools/megafilter](https://docs.coingecko.com/reference/pools-megafilter) | 2600 | 💼 Megafilter for Pools |
| [direct/v1/CoinGecko/onchain/pools /trending\_search](https://docs.coingecko.com/reference/trending-search-pools) | 2600 | 💼 Trending Search Pools |
## SocialFi
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------- |
| direct/v1/CoinGecko/onchain/networks /trending\_pools | 2600 | Trending Pools List |
| [direct/v1/CoinGecko/onchain/networks/\{network} /trending\_pools](https://docs.coingecko.com/reference/trending-pools-list) | 2600 | Trending Pools by Network |
| [direct/v1/CoinGecko/search/trending](https://docs.coingecko.com/reference/search-trending) | 2600 | Trending Search List |
## Token
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------- |
| [direct/v1/CoinGecko/coins/\{id}](https://docs.coingecko.com/reference/coins-id) | 2600 | Coin Data by ID |
| [direct/v1/CoinGecko/coins/categories](https://docs.coingecko.com/reference/coins-categories) | 2600 | Coins Categories List with Market Data |
| [direct/v1/CoinGecko/coins/categories/list](https://docs.coingecko.com/reference/coins-categories-list) | 2600 | Coins Categories List (ID Map) |
| [direct/v1/CoinGecko/coins/\{id} /circulating\_supply\_chart](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart) | 2600 | 👑 Circulating Supply Chart by ID |
| [direct/v1/CoinGecko/coins/\{id} /circulating\_supply\_chart/range](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart-range) | 2600 | 👑 Circulating Supply chart within Time Range by ID |
| [direct/v1/CoinGecko/coins/\{id}/contract /\{contract\_address}/market\_chart](https://docs.coingecko.com/reference/contract-address-market-chart) | 2600 | Coin Historical Chart Data by Token Address |
| [direct/v1/CoinGecko/coins/\{id}/contract /\{contract\_address}/market\_chart/range](https://docs.coingecko.com/reference/contract-address-market-chart-range) | 2600 | Coin Historical Chart Data within Time Range by Token Address |
| [direct/v1/CoinGecko/coins/\{id}/history](https://docs.coingecko.com/reference/coins-id-history) | 2600 | Coin Historical Data by ID |
| [direct/v1/CoinGecko/coins/list](https://docs.coingecko.com/reference/coins-list) | 2600 | Coins List (ID Map) |
| [direct/v1/CoinGecko/coins/list/new](https://docs.coingecko.com/reference/coins-list-new) | 2600 | 💼 Recently Added Coins |
| [direct/v1/CoinGecko/coins/\{id}/market\_chart](https://docs.coingecko.com/reference/coins-id-market-chart) | 2600 | Coin Historical Chart Data by ID |
| [direct/v1/CoinGecko/coins/markets](https://docs.coingecko.com/reference/coins-markets) | 2600 | Coins List with Market Data |
| [direct/v1/CoinGecko/coins/\{id}/tickers](https://docs.coingecko.com/reference/coins-id-tickers) | 2600 | Coin Tickers by ID |
| [direct/v1/CoinGecko/coins/top\_gainers\_losers](https://docs.coingecko.com/reference/coins-top-gainers-losers) | 2600 | 💼 Top Gainers & Losers |
| [direct/v1/CoinGecko/coins/\{id} /total\_supply\_chart](https://docs.coingecko.com/reference/coins-id-total-supply-chart) | 2600 | 👑 Total Supply Chart by ID |
| [direct/v1/CoinGecko/coins/\{id} /total\_supply\_chart/range](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range) | 2600 | 👑 Total Supply chart within time range by ID |
| [direct/v1/CoinGecko/onchain/networks/\{network} /tokens/\{address}](https://docs.coingecko.com/reference/token-data-contract-address) | 2600 | Token Data by Token Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /tokens/\{address}/info](https://docs.coingecko.com/reference/token-info-contract-address) | 2600 | Token Info by Token Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /tokens/multi/\{addresses}](https://docs.coingecko.com/reference/tokens-data-contract-addresses) | 2600 | Tokens Data by Token Addresses |
| [direct/v1/CoinGecko/onchain/networks/\{network} /tokens/\{token\_address}/pools](https://docs.coingecko.com/reference/top-pools-contract-address) | 2600 | Top Pools by Token Address |
| [direct/v1/CoinGecko/onchain/simple/networks /\{network}/token\_price/\{addresses}](https://docs.coingecko.com/reference/onchain-simple-price) | 2600 | Token Price by Token Addresses |
| [direct/v1/CoinGecko/onchain/tokens /info\_recently\_updated](https://docs.coingecko.com/reference/tokens-info-recent-updated) | 2600 | Most Recently Updated Tokens List |
| [direct/v1/CoinGecko/search](https://docs.coingecko.com/reference/search-data) | 2600 | Search Queries |
| direct/v1/CoinGecko/simple/price | 2600 | Coin Price by IDs |
| [direct/v1/CoinGecko/simple/token\_price/\{id}](https://docs.coingecko.com/reference/simple-price) | 2600 | Coin Price by Token Addresses |
| [direct/v1/CoinGecko/token\_lists /\{asset\_platform\_id}/all.json](https://docs.coingecko.com/reference/token-lists) | 2600 | 👑 Token Lists by Asset Platform ID |
## Wallets
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------- |
| [direct/v1/CoinGecko/coins/\{id}/contract /\{contract\_address}](https://docs.coingecko.com/reference/coins-contract-address) | 2600 | Coin Data by Token Address |
| [direct/v1/CoinGecko/coins/\{id}/contract /\{contract\_address}/market\_chart](https://docs.coingecko.com/reference/contract-address-market-chart) | 2600 | Coin Historical Chart Data by Token Address |
| [direct/v1/CoinGecko/coins/\{id}/contract /\{contract\_address}/market\_chart/range](https://docs.coingecko.com/reference/contract-address-market-chart-range) | 2600 | Coin Historical Chart Data within Time Range by Token Address |
| [direct/v1/CoinGecko/nfts/\{asset\_platform\_id} /contract/\{contract\_address}](https://docs.coingecko.com/reference/nfts-contract-address) | 2600 | NFTs Collection Data by Contract Address |
| [direct/v1/CoinGecko/nfts/\{asset\_platform\_id} /contract/\{contract\_address}/market\_chart](https://docs.coingecko.com/reference/nfts-contract-address-market-chart) | 2600 | 💼 NFTs Collection Historical Chart Data by Contract Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools/\{address}](https://docs.coingecko.com/reference/pool-address) | 2600 | Specific Pool Data by Pool Address |
| [direct/v1/CoinGecko/onchain/networks/\{network} /pools/multi/\{addresses}](https://docs.coingecko.com/reference/pools-addresses) | 2600 | Multiple Pools Data by Pool Addresses |
| [direct/v1/CoinGecko/onchain/simple/networks /\{network}/token\_price/\{addresses}](https://docs.coingecko.com/reference/onchain-simple-price) | 2600 | Token Price by Token Addresses |
# CoinMarketCap direct API on Uniblock: prices and market caps
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-coinmarketcap
Query CoinMarketCap's 81 direct API endpoints on Uniblock for cryptocurrency prices, market caps, DeFi metrics, stablecoin data, and prediction markets.
# CoinMarketCap: Direct API Endpoints
CoinMarketCap provides 81 unique direct API endpoints across the following categories:
* DeFi (25 endpoints)
* Market Data (79 endpoints)
* Other (2 endpoints)
* Prediction Markets (13 endpoints)
* Scan (1 endpoint)
* SocialFi (5 endpoints)
* Stablecoins (4 endpoints)
* Token (9 endpoints)
* Transactions (1 endpoint)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
> **Learn more:** [CoinMarketCap Documentation](https://coinmarketcap.com/api)
## Prefix and Example
**Prefix:** No prefix is required for CoinMarketCap, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/CoinMarketCap + /[CoinMarketCap_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/CoinMarketCap/v1/cryptocurrency/listings/new \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## DeFi
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | ------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /listings/new](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsNew) | 3180 | Returns a paginated list of most recently added cryptocurrencies. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketPairsLatest) | 3180 | Lists all active market pairs that CoinMarketCap tracks for a given cryptocurrency or fiat currency. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency/ohlcv /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) | 3180 | Returns historical OHLCV (Open, High, Low, Close, Volume) data along with market cap for any cryptocurrency using time interval parameters. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency/ohlcv /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvLatest) | 3180 | Returns the latest OHLCV (Open, High, Low, Close, Volume) market values for one or more cryptocurrencies for the current UTC day. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /price-performance-stats/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyPricePerformanceStatsLatest) | 3180 | Returns price performance statistics for one or more cryptocurrencies including launch price ROI and all-time high / all-time low. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency/quotes /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesHistorical) | 3180 | Returns an interval of historic market quotes for any cryptocurrency based on time and interval parameters. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency/quotes /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) | 3180 | Returns the latest market quote for 1 or more cryptocurrencies. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /trending/gainers-losers](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingGainersLosers) | 3180 | Returns a paginated list of all trending cryptocurrencies, determined and sorted by the largest price gains or losses. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /trending/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingLatest) | 3180 | Returns a paginated list of all trending cryptocurrency market data, determined and sorted by CoinMarketCap search volume. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /trending/most-visited](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingMostVisited) | 3180 | Returns a paginated list of all trending cryptocurrency market data, determined and sorted by traffic to coin detail pages. |
| [direct/v1/CoinMarketCap/v1/dex/liquidity-change /list](https://coinmarketcap.com/api/documentation/v1/#operation/getLiquidityChangeList) | 3180 | Get liquidity change history for a token |
| [direct/v1/CoinMarketCap/v1/dex/platform/detail](https://coinmarketcap.com/api/documentation/v1/#operation/getPlatformDetail) | 3180 | Get detailed information for a specific platform |
| [direct/v1/CoinMarketCap/v1/dex/platform/list](https://coinmarketcap.com/api/documentation/v1/#operation/getPlatformList) | 3180 | Get list of all supported platforms |
| [direct/v1/CoinMarketCap/v1/dex/token-liquidity /query](https://coinmarketcap.com/api/documentation/v1/#operation/queryTokenLiquidity) | 3180 | Get liquidity information for a specific token |
| [direct/v1/CoinMarketCap/v1/dex/token/pools](https://coinmarketcap.com/api/documentation/v1/#operation/getTokenPools) | 3180 | Get all pools for a specific token |
| [direct/v1/CoinMarketCap/v1/exchange/listings /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) | 3180 | Returns a paginated list of all cryptocurrency exchanges including the latest aggregate market data for each exchange. |
| [direct/v1/CoinMarketCap/v1/exchange/market-pairs /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketPairsLatest) | 3180 | Returns all active market pairs that CoinMarketCap tracks for a given exchange. |
| [direct/v1/CoinMarketCap/v1/exchange/quotes /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesHistorical) | 3180 | Returns an interval of historic quotes for any exchange based on time and interval parameters. |
| [direct/v1/CoinMarketCap/v1/exchange/quotes /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesLatest) | 3180 | Returns the latest aggregate market data for 1 or more exchanges. |
| [direct/v1/CoinMarketCap/v1/partners /flipside-crypto/fcas/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1PartnersFlipsidecryptoFcasListingsLatest) | 3180 | Returns a paginated list of FCAS scores for all cryptocurrencies currently supported by FCAS. |
| [direct/v1/CoinMarketCap/v1/partners /flipside-crypto/fcas/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1PartnersFlipsidecryptoFcasQuotesLatest) | 3180 | Returns the latest FCAS score for 1 or more cryptocurrencies. |
| [direct/v1/CoinMarketCap/v2/cryptocurrency/ohlcv /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvHistorical) | 3180 | Returns historical OHLCV (Open, High, Low, Close, Volume) data along with market cap for any cryptocurrency using time interval parameters. |
| [direct/v1/CoinMarketCap/v2/cryptocurrency/ohlcv /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvLatest) | 3180 | Returns the latest OHLCV (Open, High, Low, Close, Volume) market values for one or more cryptocurrencies for the current UTC day. |
| [direct/v1/CoinMarketCap/v4/dex/pairs/ohlcv /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getPairHistoricalOHLCV) | 3180 | Historical quotes |
| [direct/v1/CoinMarketCap/v4/dex/pairs/ohlcv /latest](https://coinmarketcap.com/api/documentation/v1/#tag/DexScan) | 3180 | Ohlcv latest quotes |
## Market Data
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/CoinMarketCap/v1/blockchain/statistics /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1BlockchainStatisticsLatest) | 3180 | Returns the latest blockchain statistics data for 1 or more blockchains. |
| [direct/v1/CoinMarketCap/v1/community/trending /token](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CommunityTrendingToken) | 3180 | Returns the latest trending tokens from the CMC Community. |
| [direct/v1/CoinMarketCap/v1/community/trending /topic](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CommunityTrendingTopic) | 3180 | Returns the latest trending topics from the CMC Community. |
| [direct/v1/CoinMarketCap/v1/content/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentLatest) | 3180 | Returns a paginated list of content pulled from CMC News/Headlines and Alexandria articles. |
| [direct/v1/CoinMarketCap/v1/content/posts /comments](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsComments) | 3180 | Returns comments of the CMC Community post. |
| [direct/v1/CoinMarketCap/v1/content/posts/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsLatest) | 3180 | Returns the latest crypto-related posts from the CMC Community. |
| [direct/v1/CoinMarketCap/v1/content/posts/top](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsTop) | 3180 | Returns the top crypto-related posts from the CMC Community. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /airdrop](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrop) | 3180 | Returns information about a single airdrop available on CoinMarketCap. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /airdrops](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrops) | 3180 | Returns a list of past, present, or future airdrops which have run on CoinMarketCap. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /categories](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategories) | 3180 | Returns information about all coin categories available on CoinMarketCap. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /category](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategory) | 3180 | Returns information about a single coin category available on CoinMarketCap. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) | 3180 | Returns all static metadata available for one or more cryptocurrencies. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /listings/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsHistorical) | 3180 | Returns a ranked and sorted list of all cryptocurrencies for a historical UTC date. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) | 3180 | Returns a paginated list of all active cryptocurrencies with latest market data. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /listings/new](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsNew) | 3180 | Returns a paginated list of most recently added cryptocurrencies. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) | 3180 | Returns a mapping of all cryptocurrencies to unique CoinMarketCap `id`s. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketPairsLatest) | 3180 | Lists all active market pairs that CoinMarketCap tracks for a given cryptocurrency or fiat currency. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency/ohlcv /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) | 3180 | Returns historical OHLCV (Open, High, Low, Close, Volume) data along with market cap for any cryptocurrency using time interval parameters. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency/ohlcv /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvLatest) | 3180 | Returns the latest OHLCV (Open, High, Low, Close, Volume) market values for one or more cryptocurrencies for the current UTC day. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /price-performance-stats/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyPricePerformanceStatsLatest) | 3180 | Returns price performance statistics for one or more cryptocurrencies including launch price ROI and all-time high / all-time low. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency/quotes /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesHistorical) | 3180 | Returns an interval of historic market quotes for any cryptocurrency based on time and interval parameters. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency/quotes /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) | 3180 | Returns the latest market quote for 1 or more cryptocurrencies. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /trending/gainers-losers](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingGainersLosers) | 3180 | Returns a paginated list of all trending cryptocurrencies, determined and sorted by the largest price gains or losses. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /trending/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingLatest) | 3180 | Returns a paginated list of all trending cryptocurrency market data, determined and sorted by CoinMarketCap search volume. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /trending/most-visited](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingMostVisited) | 3180 | Returns a paginated list of all trending cryptocurrency market data, determined and sorted by traffic to coin detail pages. |
| [direct/v1/CoinMarketCap/v1/dex/gainer-loser/list](https://coinmarketcap.com/api/documentation/v1/#operation/getGainerLoserList) | 3180 | Get list of top gainer and loser tokens |
| [direct/v1/CoinMarketCap/v1/dex/liquidity-change /list](https://coinmarketcap.com/api/documentation/v1/#operation/getLiquidityChangeList) | 3180 | Get liquidity change history for a token |
| [direct/v1/CoinMarketCap/v1/dex/meme/list](https://coinmarketcap.com/api/documentation/v1/#operation/getMemeList) | 3180 | Get list of meme tokens |
| [direct/v1/CoinMarketCap/v1/dex/new/list](https://coinmarketcap.com/api/documentation/v1/#operation/getNewList) | 3180 | Get list of newly launched tokens |
| [direct/v1/CoinMarketCap/v1/dex/platform/detail](https://coinmarketcap.com/api/documentation/v1/#operation/getPlatformDetail) | 3180 | Get detailed information for a specific platform |
| [direct/v1/CoinMarketCap/v1/dex/platform/list](https://coinmarketcap.com/api/documentation/v1/#operation/getPlatformList) | 3180 | Get list of all supported platforms |
| [direct/v1/CoinMarketCap/v1/dex/search](https://coinmarketcap.com/api/documentation/v1/#operation/search) | 3180 | Search for tokens by keyword |
| [direct/v1/CoinMarketCap/v1/dex/security/detail](https://coinmarketcap.com/api/documentation/v1/#operation/getSecurityDetail) | 3180 | Get security audit information for a token |
| [direct/v1/CoinMarketCap/v1/dex/swap/list](https://coinmarketcap.com/api/documentation/v1/#operation/getSwapList) | 3180 | Get swap/trade history for a token |
| [direct/v1/CoinMarketCap/v1/dex/token](https://coinmarketcap.com/api/documentation/v1/#operation/getToken) | 3180 | Get detailed information for a specific token |
| [direct/v1/CoinMarketCap/v1/dex/token-liquidity /query](https://coinmarketcap.com/api/documentation/v1/#operation/queryTokenLiquidity) | 3180 | Get liquidity information for a specific token |
| [direct/v1/CoinMarketCap/v1/dex/token/pools](https://coinmarketcap.com/api/documentation/v1/#operation/getTokenPools) | 3180 | Get all pools for a specific token |
| [direct/v1/CoinMarketCap/v1/dex/token/price](https://coinmarketcap.com/api/documentation/v1/#operation/getTokenPrice) | 3180 | Get current price for a specific token |
| [direct/v1/CoinMarketCap/v1/dex/token/price/batch](https://coinmarketcap.com/api/documentation/v1/#operation/batchGetTokenPrice) | 3180 | Get prices for multiple tokens in one request |
| [direct/v1/CoinMarketCap/v1/dex/tokens /batch-query](https://coinmarketcap.com/api/documentation/v1/#operation/batchQueryTokens) | 3180 | Query multiple tokens in one request |
| [direct/v1/CoinMarketCap/v1/dex/tokens/trending /list](https://coinmarketcap.com/api/documentation/v1/#operation/getTrendingList) | 3180 | Get list of trending tokens |
| [direct/v1/CoinMarketCap/v1/exchange/assets](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeAssets) | 3180 | Returns the exchange assets in the form of token holdings. |
| [direct/v1/CoinMarketCap/v1/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) | 3180 | Returns all static metadata for one or more exchanges. |
| [direct/v1/CoinMarketCap/v1/exchange/listings /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) | 3180 | Returns a paginated list of all cryptocurrency exchanges including the latest aggregate market data for each exchange. |
| [direct/v1/CoinMarketCap/v1/exchange/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) | 3180 | Returns a paginated list of all active cryptocurrency exchanges by CoinMarketCap ID. |
| [direct/v1/CoinMarketCap/v1/exchange/market-pairs /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketPairsLatest) | 3180 | Returns all active market pairs that CoinMarketCap tracks for a given exchange. |
| [direct/v1/CoinMarketCap/v1/exchange/quotes /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesHistorical) | 3180 | Returns an interval of historic quotes for any exchange based on time and interval parameters. |
| [direct/v1/CoinMarketCap/v1/exchange/quotes /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesLatest) | 3180 | Returns the latest aggregate market data for 1 or more exchanges. |
| [direct/v1/CoinMarketCap/v1/fiat/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1FiatMap) | 3180 | Returns a mapping of all supported fiat currencies to unique CoinMarketCap ids. |
| [direct/v1/CoinMarketCap/v1/global-metrics/quotes /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalMetricsQuotesHistorical) | 3180 | Returns an interval of historical global cryptocurrency market metrics based on time and interval parameters. |
| [direct/v1/CoinMarketCap/v1/global-metrics/quotes /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalMetricsQuotesLatest) | 3180 | Returns the latest global cryptocurrency market metrics. |
| [direct/v1/CoinMarketCap/v1/key/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1KeyInfo) | 3180 | Returns API key details and usage stats. |
| [direct/v1/CoinMarketCap/v1/k-line/candles](https://coinmarketcap.com/api/documentation/v1/#operation/getKlineCandles) | 3180 | Get K-line candle data for a token. Returns array of \[open, high, low, close, volume, timestamp] |
| [direct/v1/CoinMarketCap/v1/k-line/points](https://coinmarketcap.com/api/documentation/v1/#operation/getKlinePoints) | 3180 | Get K-line data points for a token. Returns array of \[price, volume, timestamp] |
| [direct/v1/CoinMarketCap/v1/partners /flipside-crypto/fcas/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1PartnersFlipsidecryptoFcasListingsLatest) | 3180 | Returns a paginated list of FCAS scores for all cryptocurrencies currently supported by FCAS. |
| [direct/v1/CoinMarketCap/v1/partners /flipside-crypto/fcas/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1PartnersFlipsidecryptoFcasQuotesLatest) | 3180 | Returns the latest FCAS score for 1 or more cryptocurrencies. |
| [direct/v1/CoinMarketCap/v1/tools/postman](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPostman) | 3180 | Convert APIs into postman format. |
| [direct/v1/CoinMarketCap/v1/tools /price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceConversion) | 3180 | Convert an amount of one cryptocurrency or fiat currency into one or more different currencies utilizing the latest market rate for each currency. |
| [direct/v1/CoinMarketCap/v2/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyInfo) | 3180 | Returns all static metadata available for one or more cryptocurrencies. |
| [direct/v1/CoinMarketCap/v2/cryptocurrency /market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyMarketPairsLatest) | 3180 | Lists all active market pairs that CoinMarketCap tracks for a given cryptocurrency or fiat currency. |
| [direct/v1/CoinMarketCap/v2/cryptocurrency/ohlcv /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvHistorical) | 3180 | Returns historical OHLCV (Open, High, Low, Close, Volume) data along with market cap for any cryptocurrency using time interval parameters. |
| [direct/v1/CoinMarketCap/v2/cryptocurrency/ohlcv /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvLatest) | 3180 | Returns the latest OHLCV (Open, High, Low, Close, Volume) market values for one or more cryptocurrencies for the current UTC day. |
| [direct/v1/CoinMarketCap/v2/cryptocurrency /price-performance-stats/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyPricePerformanceStatsLatest) | 3180 | Returns price performance statistics for one or more cryptocurrencies including launch price ROI and all-time high / all-time low. |
| [direct/v1/CoinMarketCap/v2/cryptocurrency/quotes /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesHistorical) | 3180 | Returns an interval of historic market quotes for any cryptocurrency based on time and interval parameters. |
| [direct/v1/CoinMarketCap/v2/cryptocurrency/quotes /latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesLatest) | 3180 | Returns the latest market quote for 1 or more cryptocurrencies. |
| [direct/v1/CoinMarketCap/v2/tools /price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV2ToolsPriceConversion) | 3180 | Convert an amount of one cryptocurrency or fiat currency into one or more different currencies utilizing the latest market rate for each currency. |
| [direct/v1/CoinMarketCap/v3/cryptocurrency/quotes /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3CryptocurrencyQuotesHistorical) | 3180 | Returns an interval of historic market quotes for any cryptocurrency based on time and interval parameters. |
| [direct/v1/CoinMarketCap/v3/index /cmc100-historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC100Historical) | 3180 | Returns an interval of historic CoinMarketCap 100 Index values based on the interval parameter. |
| [direct/v1/CoinMarketCap/v3/index/cmc100-latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC100Latest) | 3180 | Returns the lastest CoinMarketCap 100 Index value, constituents, and constituent weights. |
| [direct/v1/CoinMarketCap/v3/index /cmc20-historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC20Historical) | 3180 | Returns an interval of historic CoinMarketCap 20 Index values based on the interval parameter. |
| [direct/v1/CoinMarketCap/v3/index/cmc20-latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC20Latest) | 3180 | Returns the lastest CoinMarketCap 20 Index value, constituents, and constituent weights. |
| [direct/v1/CoinMarketCap/v4/dex/listings/info](https://coinmarketcap.com/api/documentation/v1/#operation/getListingsInfo) | 3180 | Metadata of DEXes |
| [direct/v1/CoinMarketCap/v4/dex/listings/quotes](https://coinmarketcap.com/api/documentation/v1/#operation/getLatestListings) | 3180 | Latest listings of DEXes |
| [direct/v1/CoinMarketCap/v4/dex/networks/list](https://coinmarketcap.com/api/documentation/v1/#operation/getNetworks) | 3180 | Returns all networks on CMC |
| [direct/v1/CoinMarketCap/v4/dex/pairs/ohlcv /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getPairHistoricalOHLCV) | 3180 | Historical quotes |
| [direct/v1/CoinMarketCap/v4/dex/pairs/ohlcv /latest](https://coinmarketcap.com/api/documentation/v1/#tag/DexScan) | 3180 | Ohlcv latest quotes |
| [direct/v1/CoinMarketCap/v4/dex/pairs/quotes /latest](https://coinmarketcap.com/api/documentation/v1/#tag/DexScan) | 3180 | Pairs quotes latest |
| [direct/v1/CoinMarketCap/v4/dex/pairs/trade /latest](https://coinmarketcap.com/api/documentation/v1/#tag/DexScan) | 3180 | Latest 100 trades |
| [direct/v1/CoinMarketCap/v4/dex/spot-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#tag/DexScan) | 3180 | Latest listings of pairs |
## Other
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------------------------------------- |
| [direct/v1/CoinMarketCap/v3/fear-and-greed /historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3FearandgreedHistorical) | 3180 | Returns a paginated list of all CMC Crypto Fear and Greed values at 12am UTC time. |
| [direct/v1/CoinMarketCap/v3/fear-and-greed/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV3FearandgreedLatest) | 3180 | Returns the lastest CMC Crypto Fear and Greed value. |
## Prediction Markets
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | ------------------------------------------------------------------------------------------------- |
| [direct/v1/CoinMarketCap/v1/dex/liquidity-change /list](https://coinmarketcap.com/api/documentation/v1/#operation/getLiquidityChangeList) | 3180 | Get liquidity change history for a token |
| [direct/v1/CoinMarketCap/v1/dex/security/detail](https://coinmarketcap.com/api/documentation/v1/#operation/getSecurityDetail) | 3180 | Get security audit information for a token |
| [direct/v1/CoinMarketCap/v1/dex/swap/list](https://coinmarketcap.com/api/documentation/v1/#operation/getSwapList) | 3180 | Get swap/trade history for a token |
| [direct/v1/CoinMarketCap/v1/dex/token-liquidity /query](https://coinmarketcap.com/api/documentation/v1/#operation/queryTokenLiquidity) | 3180 | Get liquidity information for a specific token |
| [direct/v1/CoinMarketCap/v1/dex/token/pools](https://coinmarketcap.com/api/documentation/v1/#operation/getTokenPools) | 3180 | Get all pools for a specific token |
| [direct/v1/CoinMarketCap/v1/dex/token/price](https://coinmarketcap.com/api/documentation/v1/#operation/getTokenPrice) | 3180 | Get current price for a specific token |
| [direct/v1/CoinMarketCap/v1/dex/token/price/batch](https://coinmarketcap.com/api/documentation/v1/#operation/batchGetTokenPrice) | 3180 | Get prices for multiple tokens in one request |
| [direct/v1/CoinMarketCap/v1/k-line/candles](https://coinmarketcap.com/api/documentation/v1/#operation/getKlineCandles) | 3180 | Get K-line candle data for a token. Returns array of \[open, high, low, close, volume, timestamp] |
| [direct/v1/CoinMarketCap/v1/k-line/points](https://coinmarketcap.com/api/documentation/v1/#operation/getKlinePoints) | 3180 | Get K-line data points for a token. Returns array of \[price, volume, timestamp] |
| [direct/v1/CoinMarketCap/v3/index /cmc100-historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC100Historical) | 3180 | Returns an interval of historic CoinMarketCap 100 Index values based on the interval parameter. |
| [direct/v1/CoinMarketCap/v3/index/cmc100-latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC100Latest) | 3180 | Returns the lastest CoinMarketCap 100 Index value, constituents, and constituent weights. |
| [direct/v1/CoinMarketCap/v3/index /cmc20-historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC20Historical) | 3180 | Returns an interval of historic CoinMarketCap 20 Index values based on the interval parameter. |
| [direct/v1/CoinMarketCap/v3/index/cmc20-latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC20Latest) | 3180 | Returns the lastest CoinMarketCap 20 Index value, constituents, and constituent weights. |
## Scan
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------ |
| [direct/v1/CoinMarketCap/v1/dex/security/detail](https://coinmarketcap.com/api/documentation/v1/#operation/getSecurityDetail) | 3180 | Get security audit information for a token |
## SocialFi
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/CoinMarketCap/v1/community/trending /token](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CommunityTrendingToken) | 3180 | Returns the latest trending tokens from the CMC Community. |
| [direct/v1/CoinMarketCap/v1/community/trending /topic](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CommunityTrendingTopic) | 3180 | Returns the latest trending topics from the CMC Community. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /trending/gainers-losers](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingGainersLosers) | 3180 | Returns a paginated list of all trending cryptocurrencies, determined and sorted by the largest price gains or losses. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /trending/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingLatest) | 3180 | Returns a paginated list of all trending cryptocurrency market data, determined and sorted by CoinMarketCap search volume. |
| [direct/v1/CoinMarketCap/v1/cryptocurrency /trending/most-visited](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingMostVisited) | 3180 | Returns a paginated list of all trending cryptocurrency market data, determined and sorted by traffic to coin detail pages. |
## Stablecoins
### GET
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------- |
| [direct/v1/CoinMarketCap/v1/dex/swap/list](https://coinmarketcap.com/api/documentation/v1/#operation/getSwapList) | 3180 | Get swap/trade history for a token |
| [direct/v1/CoinMarketCap/v1/dex/token/pools](https://coinmarketcap.com/api/documentation/v1/#operation/getTokenPools) | 3180 | Get all pools for a specific token |
| [direct/v1/CoinMarketCap/v1/dex/token/price](https://coinmarketcap.com/api/documentation/v1/#operation/getTokenPrice) | 3180 | Get current price for a specific token |
| [direct/v1/CoinMarketCap/v1/dex/token/price/batch](https://coinmarketcap.com/api/documentation/v1/#operation/batchGetTokenPrice) | 3180 | Get prices for multiple tokens in one request |
## Token
### GET
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------------- |
| [direct/v1/CoinMarketCap/v1/community/trending /token](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CommunityTrendingToken) | 3180 | Returns the latest trending tokens from the CMC Community. |
| [direct/v1/CoinMarketCap/v1/content/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentLatest) | 3180 | Returns a paginated list of content pulled from CMC News/Headlines and Alexandria articles. |
| [direct/v1/CoinMarketCap/v1/dex/gainer-loser/list](https://coinmarketcap.com/api/documentation/v1/#operation/getGainerLoserList) | 3180 | Get list of top gainer and loser tokens |
| [direct/v1/CoinMarketCap/v1/dex/meme/list](https://coinmarketcap.com/api/documentation/v1/#operation/getMemeList) | 3180 | Get list of meme tokens |
| [direct/v1/CoinMarketCap/v1/dex/new/list](https://coinmarketcap.com/api/documentation/v1/#operation/getNewList) | 3180 | Get list of newly launched tokens |
| [direct/v1/CoinMarketCap/v1/dex/search](https://coinmarketcap.com/api/documentation/v1/#operation/search) | 3180 | Search for tokens by keyword |
| [direct/v1/CoinMarketCap/v1/dex/token](https://coinmarketcap.com/api/documentation/v1/#operation/getToken) | 3180 | Get detailed information for a specific token |
| [direct/v1/CoinMarketCap/v1/dex/tokens /batch-query](https://coinmarketcap.com/api/documentation/v1/#operation/batchQueryTokens) | 3180 | Query multiple tokens in one request |
| [direct/v1/CoinMarketCap/v1/dex/tokens/trending /list](https://coinmarketcap.com/api/documentation/v1/#operation/getTrendingList) | 3180 | Get list of trending tokens |
## Transactions
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------- |
| [direct/v1/CoinMarketCap/v1/dex/swap/list](https://coinmarketcap.com/api/documentation/v1/#operation/getSwapList) | 3180 | Get swap/trade history for a token |
# Dwellir direct API on Uniblock: multi-chain RPC access
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-dwellir
Reach Dwellir's direct API endpoint on Uniblock for high-availability RPC infrastructure across supported EVM and non-EVM chains under one API key.
# Dwellir: Direct API Endpoints
Dwellir provides 1 unique direct API endpoint across the following categories:
* Other (1 endpoint)
> **Learn more:** [Dwellir Documentation](https://www.dwellir.com/docs/hyperliquid)
## Prefix and Example
**Prefix:** No prefix is required for Dwellir, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/Dwellir + /[Dwellir_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request POST \
--url https://api.uniblock.dev/direct/v1/Dwellir/hyperliquid/info \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## Other
### POST
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------------------------------------- |
| [direct/v1/Dwellir/hyperliquid/info](https://www.dwellir.com/docs/hyperliquid/info-endpoint) | 40 | Dwellir Hyperliquid info endpoint. Use the `type` field in the request body to specify the operation. |
# GeniiData direct API on Uniblock: Bitcoin and BRC-20 data
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-geniidata
Query GeniiData's 23 direct API endpoints on Uniblock for Bitcoin ordinals, BRC-20 tokens, Runes, inscriptions, and other UTXO-chain onchain data.
# GeniiData: Direct API Endpoints
GeniiData provides 23 unique direct API endpoints across the following categories:
* Other (23 endpoints)
## Prefix and Example
**Prefix:** No prefix is required for GeniiData, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/GeniiData + /[GeniiData_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/GeniiData/1/bitmap/bitmapInfo/address/{address} \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## Other
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------- |
| direct/v1/GeniiData/1/runes/listinfo | 2000 | Get Runes Info List |
| direct/v1/GeniiData/1/runes/\{runeid}/info | 2000 | Get Runes Info |
| direct/v1/GeniiData/1/runes/\{runeid}/holders | 2000 | Get Runes Holders |
| direct/v1/GeniiData/1/runes/address/\{address} /balance | 2000 | Get Address Runes Balance List |
| direct/v1/GeniiData/1/runes/address/\{address} /\{runeid}/utxo | 2000 | Get Address Runes UTXO |
| direct/v1/GeniiData/1/runes/utxo/\{txid}/\{index} /balance | 2000 | Get UTXO Runes Balance |
| direct/v1/GeniiData/1/collection/collaborator /balances/\{address} | 2000 | Get Collaborator Collection Balance |
| direct/v1/GeniiData/1/collection/collaborator /\{collection\_id}/holders | 2000 | Get Collaborator Holders |
| direct/v1/GeniiData/1/brc20/ticks | 2000 | Get BRC20 Tick List |
| direct/v1/GeniiData/1/brc20/tickinfo/\{tick} | 2000 | Get BRC20 TickInfo by Tick |
| direct/v1/GeniiData/1/brc20/balance | 2000 | Get BRC20 Balance by Address/Tick |
| direct/v1/GeniiData/1/brc20/activities | 2000 | Get BRC20 Activities |
| direct/v1/GeniiData/1/brc20/address/\{address} /tick/\{tick}/transferableInscriptions | 2000 | Get BRC20 Transferable Inscriptions |
| direct/v1/GeniiData/1/sns/namelist | 2000 | Get SNS Name List |
| direct/v1/GeniiData/1/sns/namespace/\{namespace} /names | 2000 | Get SNS Name by Namespace |
| direct/v1/GeniiData/1/sns/name/\{name} | 2000 | Get SNS Info by Name |
| direct/v1/GeniiData/1/sns/inscriptionId /\{inscriptionId}/info | 2000 | Get SNS Info by InscriptionId |
| direct/v1/GeniiData/1/sns/address/\{address} | 2000 | Get SNS Sssets by Address |
| direct/v1/GeniiData/1/bitmap/listinfo | 2000 | Get BITMAP List |
| direct/v1/GeniiData/1/bitmap/bitmapInfo /bitmapNumber/\{bitmapNumber} | 2000 | Get BITMAP Info by Number |
| direct/v1/GeniiData/1/bitmap/bitmapInfo /inscriptionId/\{inscriptionId} | 2000 | Get BITMAP Info by InscriptionId |
| direct/v1/GeniiData/1/bitmap/bitmapInfo/address /\{address} | 2000 | Get BITMAP Assets by Address |
| direct/v1/GeniiData/1/key/info | 2000 | Key Info |
# GoldRush direct API on Uniblock: wallets, tokens, NFTs, scan
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-goldrush
Query GoldRush's 48 direct API endpoints on Uniblock for wallet balances, token analytics, NFT ownership, block scan lookups, and transaction history.
# GoldRush: Direct API Endpoints
GoldRush provides 48 unique direct API endpoints across the following categories:
* DeFi (1 endpoint)
* Market Data (6 endpoints)
* NFT (14 endpoints)
* Scan (10 endpoints)
* Token (12 endpoints)
* Transaction (12 endpoints)
* Wallets (21 endpoints)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
> **Learn more:** [GoldRush Documentation](https://goldrush.dev/docs/api-reference)
## Prefix and Example
**Prefix:** No prefix is required for GoldRush, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/GoldRush + /[GoldRush_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/GoldRush/v1/pricing/spot_prices/{chainName}/pools/{contractAddress} \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## DeFi
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/GoldRush/v1/pricing/spot\_prices /\{chainName}/pools/\{contractAddress}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices#get-pool-spot-prices) | 100 | Get the spot token pair prices for a specified pool contract address. Supports pools on Uniswap V2, V3 and their forks. |
## Market Data
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | ----------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/GoldRush/v1/pricing/spot\_prices /\{chainName}/pools/\{contractAddress}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices#get-pool-spot-prices) | 100 | Get the spot token pair prices for a specified pool contract address. Supports pools on Uniswap V2, V3 and their forks. |
| [direct/v1/GoldRush/v1/\{chainName}/nft\_market /\{contractAddress}/floor\_price](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-market-floor-price) | 100 | Get historical floor prices for a collection |
| [direct/v1/GoldRush/v1/\{chainName}/nft\_market /\{contractAddress}/sale\_count](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-market-sale-count) | 100 | Get historical sales count for a collection |
| [direct/v1/GoldRush/v1/pricing /historical\_by\_addresses\_v2/\{chainName} /\{quoteCurrency}/\{contractAddress}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) | 100 | Get historical token prices |
| [direct/v1/GoldRush/v1/\{chainName}/nft\_market /\{contractAddress}/volume](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-market-volume) | 100 | Get historical volume for a collection |
### POST
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/GoldRush/hypercore/info](https://goldrush.dev/docs/goldrush-hyperliquid/overview) | 100 | GoldRush is the complete data layer for Hyperliquid that offers a drop-in Hyperliquid /info API replacement with no rate limits. |
## NFT
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------- |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/balances\_nft](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) | 100 | Get NFTs for address |
| [direct/v1/GoldRush/v1/\{chainName}/nft /\{collectionContract}/traits/\{trait}/attributes](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-attribute-values-collection-trait) | 100 | Get attributes for a collection trait |
| [direct/v1/GoldRush/v1/\{chainName}/nft /collections](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-chain-collections) | 100 | Get chain collections |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/collection/\{collectionContract}](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection) | 100 | Check ownership in NFT collection |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/collection/\{collectionContract} /token/\{tokenId}](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token) | 100 | Check ownership in NFT collection for specific token |
| [direct/v1/GoldRush/v1/\{chainName}/nft\_market /\{contractAddress}/floor\_price](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-market-floor-price) | 100 | Get historical floor prices for a collection |
| [direct/v1/GoldRush/v1/\{chainName}/nft\_market /\{contractAddress}/sale\_count](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-market-sale-count) | 100 | Get historical sales count for a collection |
| [direct/v1/GoldRush/v1/\{chainName}/nft\_market /\{contractAddress}/volume](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-market-volume) | 100 | Get historical volume for a collection |
| [direct/v1/GoldRush/v1/\{chainName}/nft/approvals /\{walletAddress}](https://goldrush.dev/docs/api-reference/foundational-api/security/get-nft-approvals) | 100 | Get NFT approvals for address |
| [direct/v1/GoldRush/v1/\{chainName}/nft /\{contractAddress}/metadata](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-token-ids-for-contract-with-metadata) | 100 | Get NFTs from contract with metadata |
| [direct/v1/GoldRush/v1/\{chainName}/tokens /\{contractAddress}/nft\_transactions/\{tokenId}](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-transactions-contract) | 100 | Get NFT transactions for contract |
| [direct/v1/GoldRush/v1/\{chainName}/nft /\{contractAddress}/metadata/\{tokenId}](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-metadata-token-id-contract) | 100 | Get single NFT from contract with metadata |
| [direct/v1/GoldRush/v1/\{chainName}/nft /\{collectionContract}/traits](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-list-of-traits-collection) | 100 | Get traits for a collection |
| [direct/v1/GoldRush/v1/\{chainName}/nft /\{collectionContract}/traits\_summary](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-collection-trait-summary) | 100 | Get trait summary for collection |
## Scan
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | -------------------------------------------- |
| [direct/v1/GoldRush/v1/chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) | 100 | Get all chains |
| [direct/v1/GoldRush/v1/chains/status](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) | 100 | Get all chain statuses |
| [direct/v1/GoldRush/v1/\{chainName}/block\_v2 /\{startDate}/\{endDate}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) | 100 | Get block heights |
| [direct/v1/GoldRush/v1/\{chainName}/block\_hash /\{blockHash}/transactions\_v3](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) | 100 | Get all transactions in a block (v3) |
| [direct/v1/GoldRush/v1/\{chainName}/block /\{blockHeight}/transactions\_v3/page/\{page}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) | 100 | Get all transactions in a block by page (v3) |
| [direct/v1/GoldRush/v1/\{chainName}/block\_v2 /\{blockHeight}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) | 100 | Get a block |
| [direct/v1/GoldRush/v1/\{chainName}/event /\{eventType}/gas\_prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) | 100 | Get gas prices |
| [direct/v1/GoldRush/v1/\{chainName}/events/address /\{contractAddress}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) | 100 | Get log events by contract address |
| [direct/v1/GoldRush/v1/\{chainName}/events/topics /\{topicHash}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) | 100 | Get log events by topic hash(es) |
| [direct/v1/GoldRush/v1/\{chainName}/events](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) | 100 | Get logs |
## Token
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/portfolio\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) | 100 | Commonly used to render a daily portfolio balance for an address broken down by the token. The timeframe is user-configurable, defaults to 30 days. |
| [direct/v1/GoldRush/v1/allchains/address /\{walletAddress}/balances](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-allchains-transactions) | 100 | Fetch paginated spot & historical native and token balances for a single address on up to 10 EVM chains with one API call. |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/balances\_native](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) | 100 | Get native token balance for address |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/balances\_v2](https://goldrush.dev/docs/api-reference/balances/get-token-balances-for-address) | 100 | Get token balances for address |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/historical\_balances](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address) | 100 | Get historical token balances for address |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/transfers\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) | 100 | Get ERC20 token transfers for address |
| [direct/v1/GoldRush/v1/btc-mainnet/address /\{walletAddress}/balances\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address) | 100 | Get Bitcoin balances for non-HD address |
| [direct/v1/GoldRush/v1/btc-mainnet/address /\{walletAddress}/hd\_wallets](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address) | 100 | Get Bitcoin balances for HD address |
| [direct/v1/GoldRush/v1/btc-mainnet/address /\{walletAddress}/historical\_balances](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address) | 100 | Get historical Bitcoin balance for non-HD address |
| [direct/v1/GoldRush/v1/pricing /historical\_by\_addresses\_v2/\{chainName} /\{quoteCurrency}/\{contractAddress}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) | 100 | Get historical token prices |
| [direct/v1/GoldRush/v1/\{chainName}/approvals /\{walletAddress}](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) | 100 | Get token approvals for address |
| [direct/v1/GoldRush/v1/\{chainName}/tokens /\{tokenAddress}/token\_holders\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2) | 100 | Get token holders as of any block height (v2) |
## Transaction
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | -------------------------------------------------- |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/transactions\_summary](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) | 100 | Get transaction summary for address |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/transfers\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) | 100 | Get ERC20 token transfers for address |
| [direct/v1/GoldRush/v1/allchains/transactions](https://goldrush.dev/docs/api-reference/cross-chain/foundational-api/get-allchains-transactions) | 100 | Get multichain & multiaddress transactions |
| [direct/v1/GoldRush/v1/cq/covalent/app/bitcoin /transactions](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address) | 100 | Get transactions for Bitcoin address |
| [direct/v1/GoldRush/v1/\{chainName}/block\_hash /\{blockHash}/transactions\_v3](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) | 100 | Get all transactions in a block (v3) |
| [direct/v1/GoldRush/v1/\{chainName}/block /\{blockHeight}/transactions\_v3/page/\{page}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) | 100 | Get all transactions in a block by page (v3) |
| [direct/v1/GoldRush/v1/\{chainName}/bulk /transactions/\{walletAddress}/\{timeBucket}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) | 100 | Get bulk time bucket transactions for address (v3) |
| [direct/v1/GoldRush/v1/\{chainName}/bulk /transactions/\{walletAddress}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) | 100 | Get earliest transactions for address (v3) |
| [direct/v1/GoldRush/v1/\{chainName}/tokens /\{contractAddress}/nft\_transactions/\{tokenId}](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-transactions-contract) | 100 | Get NFT transactions for contract |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/transactions\_v3](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) | 100 | Get recent transactions for address (v3) |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/transactions\_v3/page/\{page}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) | 100 | Get paginated transactions for address (v3) |
| [direct/v1/GoldRush/v1/\{chainName}/transaction\_v2 /\{txHash}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) | 100 | Get a transaction |
## Wallets
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/portfolio\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) | 100 | Commonly used to render a daily portfolio balance for an address broken down by the token. The timeframe is user-configurable, defaults to 30 days. |
| [direct/v1/GoldRush/v1/allchains/address /\{walletAddress}/balances](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-allchains-transactions) | 100 | Fetch paginated spot & historical native and token balances for a single address on up to 10 EVM chains with one API call. |
| [direct/v1/GoldRush/v1/address/\{walletAddress} /activity](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-address-activity) | 100 | Get activity across all chains for address |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/balances\_native](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) | 100 | Get native token balance for address |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/balances\_nft](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) | 100 | Get NFTs for address |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/balances\_v2](https://goldrush.dev/docs/api-reference/balances/get-token-balances-for-address) | 100 | Get token balances for address |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/historical\_balances](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address) | 100 | Get historical token balances for address |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/transactions\_summary](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) | 100 | Get transaction summary for address |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/transfers\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) | 100 | Get ERC20 token transfers for address |
| [direct/v1/GoldRush/v1/btc-mainnet/address /\{walletAddress}/balances\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address) | 100 | Get Bitcoin balances for non-HD address |
| [direct/v1/GoldRush/v1/btc-mainnet/address /\{walletAddress}/hd\_wallets](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address) | 100 | Get Bitcoin balances for HD address |
| [direct/v1/GoldRush/v1/btc-mainnet/address /\{walletAddress}/historical\_balances](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address) | 100 | Get historical Bitcoin balance for non-HD address |
| [direct/v1/GoldRush/v1/\{chainName}/bulk /transactions/\{walletAddress}/\{timeBucket}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) | 100 | Get bulk time bucket transactions for address (v3) |
| [direct/v1/GoldRush/v1/\{chainName}/bulk /transactions/\{walletAddress}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) | 100 | Get earliest transactions for address (v3) |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/collection/\{collectionContract}](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection) | 100 | Check ownership in NFT collection |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/collection/\{collectionContract} /token/\{tokenId}](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token) | 100 | Check ownership in NFT collection for specific token |
| [direct/v1/GoldRush/v1/\{chainName}/nft/approvals /\{walletAddress}](https://goldrush.dev/docs/api-reference/foundational-api/security/get-nft-approvals) | 100 | Get NFT approvals for address |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/resolve\_address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-resolved-address-for-registered-address) | 100 | Get resolved address for registered address |
| [direct/v1/GoldRush/v1/\{chainName}/approvals /\{walletAddress}](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) | 100 | Get token approvals for address |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/transactions\_v3](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) | 100 | Get recent transactions for address (v3) |
| [direct/v1/GoldRush/v1/\{chainName}/address /\{walletAddress}/transactions\_v3/page/\{page}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) | 100 | Get paginated transactions for address (v3) |
# Helius direct API on Uniblock: Solana transaction endpoints
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-helius
Reach Helius's 2 direct API endpoints on Uniblock for Solana transaction submission and enhanced transaction parsing under a single Uniblock API key.
# Helius: Direct API Endpoints
Helius provides 2 unique direct API endpoints across the following categories:
* Transaction (2 endpoints)
> **Learn more:** [Helius Documentation](https://docs.helius.dev/solana-apis)
## Prefix and Example
**Prefix:** No prefix is required for Helius, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/Helius + /[Helius_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/Helius/v0/addresses/{address}/transactions \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## Transaction
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------ |
| [direct/v1/Helius/v0/addresses/\{address} /transactions](https://docs.helius.dev/solana-apis/enhanced-transactions-api/parsed-transaction-history) | 50 | Returns an enriched transaction history for a given address. |
### POST
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------- |
| [direct/v1/Helius/v0/transactions](https://docs.helius.dev/solana-apis/enhanced-transactions-api/parse-transaction-s) | 50 | Returns an array of enriched, human-readable versions of the given transactions. |
# HelloMoon direct API on Uniblock: Solana DeFi, NFT, tokens
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-hellomoon
Query HelloMoon's 180 direct API endpoints on Uniblock for Solana DeFi analytics, NFT collections, token flows, SocialFi metrics, and wallet activity.
# HelloMoon: Direct API Endpoints
HelloMoon provides 180 unique direct API endpoints across the following categories:
* DeFi (126 endpoints)
* Market Data (15 endpoints)
* NFT (51 endpoints)
* SocialFi (18 endpoints)
* Token (49 endpoints)
* Transaction (8 endpoints)
* Wallets (4 endpoints)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
> **Learn more:** [HelloMoon Documentation](https://docs.hellomoon.io/reference)
## Prefix and Example
**Prefix:** No prefix is required for HelloMoon, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/HelloMoon + /[HelloMoon_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/HelloMoon/v0/subscriptions/list \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## DeFi
### DELETE
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------- |
| [direct/v1/HelloMoon/v0/subscriptions/remove/\{id}](https://docs.hellomoon.io/reference/delete_v0-subscriptions-remove-id) | 50 | Remove a subscription by its ID. |
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------- |
| [direct/v1/HelloMoon/v0/subscriptions/list](https://docs.hellomoon.io/reference/get_v0-subscriptions-list) | 50 | List all active subscriptions. |
| [direct/v1/HelloMoon/v0/subscriptions/retrieve /\{id}](https://docs.hellomoon.io/reference/get_v0-subscriptions-retrieve-id) | 50 | Retrieve a specific subscription by its ID. |
### POST
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------------------------------------------------------------------------- |
| [direct/v1/HelloMoon/v0/account-data](https://docs.hellomoon.io/reference/post_v0-account-data) | 50 | Retrieve account data for a specified address on Solana. |
| [direct/v1/HelloMoon/v0/accounts/stream/create](https://docs.hellomoon.io/reference/post_v0-accounts-stream-create) | 50 | Create a data stream for account changes, set to trigger a webhook or other target. |
| [direct/v1/HelloMoon/v0/staking /active-stake-per-validator](https://docs.hellomoon.io/reference/post_v0-staking-active-stake-per-validator) | 50 | Fetch active staking data per validator on Solana. |
| [direct/v1/HelloMoon/v0/asset-dash-updated](https://docs.hellomoon.io/reference/post_v0-asset-dash-updated) | 50 | Retrieve updated asset dashboard data. |
| [direct/v1/HelloMoon/v0/account-data/bulk](https://docs.hellomoon.io/reference/post_v0-account-data-bulk) | 50 | Retrieve bulk account data for Solana addresses. |
| [direct/v1/HelloMoon/v0/citrus/account-data](https://docs.hellomoon.io/reference/post_v0-citrus-account-data) | 50 | Retrieve account data associated with Citrus on the Solana blockchain. |
| [direct/v1/HelloMoon/v0/citrus/loan-events](https://docs.hellomoon.io/reference/post_v0-citrus-loan-events) | 50 | Fetch loan event data for accounts associated with Citrus. |
| [direct/v1/HelloMoon/v0/citrus/loan-summary](https://docs.hellomoon.io/reference/post_v0-citrus-loan-summary) | 50 | Get a summary of loan data associated with Citrus. |
| [direct/v1/HelloMoon/v0/das-ownership](https://docs.hellomoon.io/reference/post_v0-das-ownership) | 50 | Retrieve ownership data for Decentralized Autonomous Society (DAS) accounts on Solana. |
| [direct/v1/HelloMoon/v0/defi/fungible-token-info](https://docs.hellomoon.io/reference/post_v0-defi-fungible-token-info) | 50 | Fetch information on fungible tokens in DeFi settings on Solana. |
| [direct/v1/HelloMoon/v0/defi /high-volume-recent-tokens](https://docs.hellomoon.io/reference/post_v0-defi-high-volume-recent-tokens) | 50 | Fetch data on recently high-volume tokens within DeFi. |
| [direct/v1/HelloMoon/v0/defi/lending](https://docs.hellomoon.io/reference/post_v0-defi-lending) | 50 | Access DeFi lending data including borrowing and repayment activities for SPL tokens and stablecoins on Solana. |
| [direct/v1/HelloMoon/v0/defi/liquidity](https://docs.hellomoon.io/reference/post_v0-defi-liquidity) | 50 | Fetch liquidity data for a specific DeFi pool, with optional metadata. |
| [direct/v1/HelloMoon/v0/defi/program-stats /daily-new-users](https://docs.hellomoon.io/reference/post_v0-defi-program-stats-daily-new-users) | 50 | Retrieve daily new user counts for specific DeFi programs. |
| [direct/v1/HelloMoon/v0/defi/program-stats /overlap](https://docs.hellomoon.io/reference/post_v0-defi-program-stats-overlap) | 50 | Fetch overlap statistics for different DeFi programs. |
| [direct/v1/HelloMoon/v0/defi/program-stats /top-tokens](https://docs.hellomoon.io/reference/post_v0-defi-program-stats-top-tokens) | 50 | Retrieve top tokens based on user interaction within DeFi programs. |
| [direct/v1/HelloMoon/v0/defi/smart-money](https://docs.hellomoon.io/reference/post_v0-defi-smart-money) | 50 | Fetch data on smart money activities within DeFi ecosystems on Solana. |
| [direct/v1/HelloMoon/v0/defi/smart-money /top-tokens](https://docs.hellomoon.io/reference/post_v0-defi-smart-money-top-tokens) | 50 | Retrieve top tokens by smart money inflow. |
| [direct/v1/HelloMoon/v0/defi/swaps](https://docs.hellomoon.io/reference/post_v0-defi-swaps) | 50 | Retrieve swap transaction data for DeFi protocols, including details such as aggregator and time. |
| [direct/v1/HelloMoon/v0/defi/token-age](https://docs.hellomoon.io/reference/post_v0-defi-token-age) | 50 | Retrieve token age statistics within DeFi pools on Solana. |
| [direct/v1/HelloMoon/v0/defi/token-ath](https://docs.hellomoon.io/reference/post_v0-defi-token-ath) | 50 | Fetch data on tokens that have reached all-time highs within DeFi platforms. |
| [direct/v1/HelloMoon/v0/defi/token-buying](https://docs.hellomoon.io/reference/post_v0-defi-token-buying) | 50 | Retrieve recent buying activity data for tokens on DeFi platforms. |
| [direct/v1/HelloMoon/v0/defi/total-liquidity](https://docs.hellomoon.io/reference/post_v0-defi-total-liquidity) | 50 | Get total liquidity data for DeFi platforms on Solana. |
| [direct/v1/HelloMoon/v0/defi /trending-tokens-volume](https://docs.hellomoon.io/reference/post_v0-defi-trending-tokens-volume) | 50 | Retrieve volume data for trending tokens on DeFi platforms. |
| [direct/v1/HelloMoon/v0/defi/twitter\_accounts /per-token](https://docs.hellomoon.io/reference/post_v0-defi-twitter-accounts-per-token) | 50 | Fetch Twitter account data associated with specific tokens on DeFi platforms. |
| [direct/v1/HelloMoon/v0/account-data/devnet](https://docs.hellomoon.io/reference/post_v0-account-data-devnet) | 50 | Retrieve account data for a single address on Solana Devnet. |
| [direct/v1/HelloMoon/v0/account-data/devnet/bulk](https://docs.hellomoon.io/reference/post_v0-account-data-devnet-bulk) | 50 | Fetch bulk account data on Solana Devnet. |
| [direct/v1/HelloMoon/v0/dyor/leaderboard](https://docs.hellomoon.io/reference/post_v0-dyor-leaderboard) | 50 | Retrieve a leaderboard related to DYOR (Do Your Own Research) activities on Solana. |
| [direct/v1/HelloMoon/v0/frakt/loan-events](https://docs.hellomoon.io/reference/post_v0-frakt-loan-events) | 50 | Retrieve loan event data for Frakt-related accounts. |
| [direct/v1/HelloMoon/v0/frakt/loan-events/bonds](https://docs.hellomoon.io/reference/post_v0-frakt-loan-events-bonds) | 50 | Retrieve loan events specifically related to bonds in the Frakt protocol. |
| [direct/v1/HelloMoon/v0/frakt/loan-summary](https://docs.hellomoon.io/reference/post_v0-frakt-loan-summary) | 50 | Get a summary of loan data for accounts associated with Frakt. |
| [direct/v1/HelloMoon/v0/token /balances-by-owner-fungible](https://docs.hellomoon.io/reference/post_v0-token-balances-by-owner-fungible) | 50 | Retrieve fungible token balances held by a specified owner on Solana. |
| [direct/v1/HelloMoon/v0/gcr/wheel /get-rewards-meta](https://docs.hellomoon.io/reference/post_v0-gcr-wheel-get-rewards-meta) | 50 | Retrieve metadata related to reward distributions in the GCR Wheel system. |
| [direct/v1/HelloMoon/v0/hello-moon /collection-mint-mapping](https://docs.hellomoon.io/reference/post_v0-hello-moon-collection-mint-mapping) | 50 | Fetch mapping data for collections and mint addresses within the Hello Moon platform. |
| [direct/v1/HelloMoon/v0/hello-moon/defenders /get-preferred-token](https://docs.hellomoon.io/reference/post_v0-hello-moon-defenders-get-preferred-token) | 50 | Retrieve the preferred token settings for a specific user or account on Hello Moon. |
| [direct/v1/HelloMoon/v0/hello-moon/leaderboard](https://docs.hellomoon.io/reference/post_v0-hello-moon-leaderboard) | 50 | Retrieve leaderboard data within the Hello Moon platform. |
| [direct/v1/HelloMoon/v0/hello-moon/leaderboard /add](https://docs.hellomoon.io/reference/post_v0-hello-moon-leaderboard-add) | 50 | Add a user or account to the Hello Moon leaderboard. |
| [direct/v1/HelloMoon/v0/hello-moon/parsed-swaps](https://docs.hellomoon.io/reference/post_v0-hello-moon-parsed-swaps) | 50 | Fetch parsed swap data on Hello Moon, including swap details by aggregator. |
| [direct/v1/HelloMoon/v0/hello-moon /radium-liquidity](https://docs.hellomoon.io/reference/post_v0-hello-moon-radium-liquidity) | 50 | Retrieve liquidity data related to Radium pools on Hello Moon. |
| [direct/v1/HelloMoon/v0/hello-moon/defenders /set-preferred-token](https://docs.hellomoon.io/reference/post_v0-hello-moon-defenders-set-preferred-token) | 50 | Set the preferred token for a specific user or account on Hello Moon. |
| [direct/v1/HelloMoon/v0/hello-moon/defenders /token-unlock-emergency-migration](https://docs.hellomoon.io/reference/post_v0-hello-moon-defenders-token-unlock-emergency-migration) | 50 | Perform an emergency token unlock or migration for a user on Hello Moon. |
| [direct/v1/HelloMoon/v0/hello-moon /verified\_collections](https://docs.hellomoon.io/reference/post_v0-hello-moon-verified-collections) | 50 | Retrieve verified NFT collection data on Hello Moon. |
| [direct/v1/HelloMoon/v0/hello-moon /verified\_collections/dev](https://docs.hellomoon.io/reference/post_v0-hello-moon-verified-collections-dev) | 50 | Retrieve developer-specific verified collection data on Hello Moon. |
| [direct/v1/HelloMoon/v0/jito/confirm-txn](https://docs.hellomoon.io/reference/post_v0-jito-confirm-txn) | 50 | Confirm a transaction on Solana using Jito, a high-performance trading solution. |
| [direct/v1/HelloMoon/v0/jito/get-tip-account](https://docs.hellomoon.io/reference/post_v0-jito-get-tip-account) | 50 | Retrieve tipping account information for Jito transactions. |
| [direct/v1/HelloMoon/v0/defi/liquidity-pools /metadata](https://docs.hellomoon.io/reference/post_v0-defi-liquidity-pools-metadata) | 50 | Retrieve metadata for liquidity pools, including pool configurations and parameters. |
| [direct/v1/HelloMoon/v0/defi/liquidity-pools /withdrawals-deposits](https://docs.hellomoon.io/reference/post_v0-defi-liquidity-pools-withdrawals-deposits) | 50 | Track deposits and withdrawals in DeFi liquidity pools on the Solana blockchain. |
| [direct/v1/HelloMoon/v0/defi/lp-balance](https://docs.hellomoon.io/reference/post_v0-defi-lp-balance) | 50 | Check the balance of liquidity provider tokens in DeFi pools on Solana. |
| [direct/v1/HelloMoon/v0/new-boards-10](https://docs.hellomoon.io/reference/post_v0-new-boards-10) | 50 | Retrieve or interact with new leaderboard boards on Solana within Hello Moon. |
| [direct/v1/HelloMoon/v0/nft/collection/collective](https://docs.hellomoon.io/reference/post_v0-nft-collection-collective) | 50 | Fetch data for NFT collections labeled as "collective" on Hello Moon. |
| [direct/v1/HelloMoon/v0/nft/collection /floor-price-compressed](https://docs.hellomoon.io/reference/post_v0-nft-collection-floor-price-compressed) | 50 | Fetch compressed floor price data for NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/listing](https://docs.hellomoon.io/reference/post_v0-nft-collection-listing) | 50 | Retrieve listing data for specific NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/ownership /cumulative](https://docs.hellomoon.io/reference/post_v0-nft-collection-ownership-cumulative) | 50 | Fetch cumulative ownership data for NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/ownership /current](https://docs.hellomoon.io/reference/post_v0-nft-collection-ownership-current) | 50 | Retrieve current ownership data for an NFT collection. |
| [direct/v1/HelloMoon/v0/nft/collection/ownership /historical](https://docs.hellomoon.io/reference/post_v0-nft-collection-ownership-historical) | 50 | Fetch historical ownership data for NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/ownership /holding-period](https://docs.hellomoon.io/reference/post_v0-nft-collection-ownership-holding-period) | 50 | Get holding period data for owners of NFTs in specific collections. |
| [direct/v1/HelloMoon/v0/nft/collection/ownership /top-holders](https://docs.hellomoon.io/reference/post_v0-nft-collection-ownership-top-holders) | 50 | Retrieve top holder data for an NFT collection. |
| [direct/v1/HelloMoon/v0/nft/collection/stats /primary-sales](https://docs.hellomoon.io/reference/post_v0-nft-collection-stats-primary-sales) | 50 | Fetch primary sales statistics for NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection /program-usage](https://docs.hellomoon.io/reference/post_v0-nft-collection-program-usage) | 50 | Fetch program usage statistics for a specific NFT collection. |
| [direct/v1/HelloMoon/v0/nft/collection /smart-money-inflow](https://docs.hellomoon.io/reference/post_v0-nft-collection-smart-money-inflow) | 50 | Retrieve data on smart money inflows into NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/stats](https://docs.hellomoon.io/reference/post_v0-nft-collection-stats) | 50 | Retrieve statistical data for NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection /washtrading](https://docs.hellomoon.io/reference/post_v0-nft-collection-washtrading) | 50 | Retrieve wash trading data for NFTs within specific collections. |
| [direct/v1/HelloMoon/v0/nft/freeze\_lookup/v2](https://docs.hellomoon.io/reference/post_v0-nft-freeze-lookup-v2) | 50 | Retrieve freeze status details for NFTs with updated settings or format. |
| [direct/v1/HelloMoon/v0/nft/ownership/historical](https://docs.hellomoon.io/reference/post_v0-nft-ownership-historical) | 50 | Retrieve historical ownership data for NFTs within the specified endpoint. |
| [direct/v1/HelloMoon/v0/nft/listing-status/v2](https://docs.hellomoon.io/reference/post_v0-nft-listing-status-v2) | 50 | Get updated listing status data for NFTs across marketplaces. |
| [direct/v1/HelloMoon/v0/nft/loans /collection-summary](https://docs.hellomoon.io/reference/post_v0-nft-loans-collection-summary) | 50 | Get a summary of loans within NFT collections. |
| [direct/v1/HelloMoon/v0/nft/marketplace/tensor /floor-price-by-creator](https://docs.hellomoon.io/reference/post_v0-nft-marketplace-tensor-floor-price-by-creator) | 50 | Retrieve floor price data for Tensor marketplace NFTs, grouped by creator. |
| [direct/v1/HelloMoon/v0/nft/market-stats](https://docs.hellomoon.io/reference/post_v0-nft-market-stats) | 50 | Fetch general market statistics for NFTs. |
| [direct/v1/HelloMoon/v0/nft /sales\_per\_market\_daily](https://docs.hellomoon.io/reference/post_v0-nft-sales-per-market-daily) | 50 | Fetch daily sales data for NFTs across different marketplaces. |
| [direct/v1/HelloMoon/v0/accounts/parsed/create](https://docs.hellomoon.io/reference/post_v0-accounts-parsed-create) | 50 | Create a parsed account entry with a specified target type, such as a webhook. |
| [direct/v1/HelloMoon/v0/print /top-tokens-by-frequency](https://docs.hellomoon.io/reference) | 50 | Fetch tokens sorted by frequency within the Print category. |
| [direct/v1/HelloMoon/v0/print /top-tokens-by-profit](https://docs.hellomoon.io/reference) | 50 | Retrieve tokens ranked by profitability within the Print category. |
| [direct/v1/HelloMoon/v0/print /top-tokens-trader-profit](https://docs.hellomoon.io/reference) | 50 | Fetch tokens ranked by trader profit within Print. |
| [direct/v1/HelloMoon/v0/print/top-tokens-users](https://docs.hellomoon.io/reference) | 50 | Retrieve data on top tokens by user count within Print. |
| [direct/v1/HelloMoon/v0/print/stats/wallet](https://docs.hellomoon.io/reference) | 50 | Fetch wallet statistics for Print-related data on Solana. |
| [direct/v1/HelloMoon/v0/tenacious\_tentacles /process-and-freeze](https://docs.hellomoon.io/reference) | 50 | Process and freeze specific data within the tenacious tentacles endpoint. |
| [direct/v1/HelloMoon/v0/rain/account-data](https://docs.hellomoon.io/reference/post_v0-rain-account-data) | 50 | Retrieve account data associated with Rain on the Solana blockchain. |
| [direct/v1/HelloMoon/v0/staking /reward-per-validator](https://docs.hellomoon.io/reference/post_v0-staking-reward-per-validator) | 50 | Get reward data per validator on Solana. |
| [direct/v1/HelloMoon/v0/sharky/account-data](https://docs.hellomoon.io/reference/post_v0-sharky-account-data) | 50 | Retrieve account data for Sharky-related accounts on Solana. |
| [direct/v1/HelloMoon/v0/sharky/apy](https://docs.hellomoon.io/reference/post_v0-sharky-apy) | 50 | Retrieve APY (annual percentage yield) data for accounts associated with Sharky. |
| [direct/v1/HelloMoon/v0/sharky/default-stats](https://docs.hellomoon.io/reference/post_v0-sharky-default-stats) | 50 | Retrieve default statistics for Sharky loans on Solana. |
| [direct/v1/HelloMoon/v0/sharky/account-data/dev](https://docs.hellomoon.io/reference/post_v0-sharky-account-data-dev) | 50 | Fetch developer-specific account data within the Sharky protocol. |
| [direct/v1/HelloMoon/v0/sharky/loan-summary /filtered](https://docs.hellomoon.io/reference/post_v0-sharky-loan-summary-filtered) | 50 | Provides a filtered summary of loan data within the Sharky protocol. |
| [direct/v1/HelloMoon/v0/sharky /historical-defaults](https://docs.hellomoon.io/reference/post_v0-sharky-historical-defaults) | 50 | Fetch historical default data for Sharky loans. |
| [direct/v1/HelloMoon/v0/sharky/loan-events](https://docs.hellomoon.io/reference/post_v0-sharky-loan-events) | 50 | Fetch loan event data for accounts associated with Sharky. |
| [direct/v1/HelloMoon/v0/sharky/loan-summary](https://docs.hellomoon.io/reference/post_v0-sharky-loan-summary) | 50 | Get a summary of loan data associated with Sharky accounts. |
| [direct/v1/HelloMoon/v0/sharky /loan-summary-private](https://docs.hellomoon.io/reference/post_v0-sharky-loan-summary-private) | 50 | Retrieve private loan summary data within the Sharky endpoint. |
| [direct/v1/HelloMoon/v0/sharky/orderbook-stats](https://docs.hellomoon.io/reference/post_v0-sharky-orderbook-stats) | 50 | Retrieve orderbook statistics for Sharky. |
| [direct/v1/HelloMoon/v0/sharky/orderbook-summary](https://docs.hellomoon.io/reference/post_v0-sharky-orderbook-summary) | 50 | Get a summary of Sharky orderbook data. |
| [direct/v1/HelloMoon/v0/token/smart-money](https://docs.hellomoon.io/reference/post_v0-token-smart-money) | 50 | Fetch data on tokens associated with smart money inflows, with ordering and pagination options. |
| [direct/v1/HelloMoon/v0/solana /artemis-program-stats](https://docs.hellomoon.io/reference/post_v0-solana-artemis-program-stats) | 50 | Retrieve program statistics for the Artemis program on Solana. |
| [direct/v1/HelloMoon/v0/defi/sol-grid-bot /top-tokens-one-min](https://docs.hellomoon.io/reference/post_v0-defi-sol-grid-bot-top-tokens-one-min) | 50 | Fetch one-minute interval data on top tokens from the SOL Grid Bot. |
| [direct/v1/HelloMoon/v0/defi/staking/accounts](https://docs.hellomoon.io/reference/post_v0-defi-staking-accounts) | 50 | Retrieve data on staking accounts, including balance and stake pool data. |
| [direct/v1/HelloMoon/v0/staking/actions](https://docs.hellomoon.io/reference/post_v0-staking-actions) | 50 | Interact with staking-related actions or activities on Solana. |
| [direct/v1/HelloMoon/v0/staking/rewards](https://docs.hellomoon.io/reference/post_v0-staking-rewards) | 50 | Fetch staking reward data for a specified validator or account. |
| [direct/v1/HelloMoon/v0/staking/transfers](https://docs.hellomoon.io/reference/post_v0-staking-transfers) | 50 | Retrieve records of staking-related transfers, such as stake activations and deactivations. |
| [direct/v1/HelloMoon/v0/subscriptions/create](https://docs.hellomoon.io/reference/post_v0-subscriptions-create) | 50 | Create a new subscription for webhook or other event notifications. |
| [direct/v1/HelloMoon/v0/superfans/login](https://docs.hellomoon.io/reference) | 50 | Login endpoint for Superfans on Hello Moon. |
| [direct/v1/HelloMoon/v0/swaps/mint-filter](https://docs.hellomoon.io/reference/post_v0-swaps-mint-filter) | 50 | Filter swap transactions by mint address, pagination supported. |
| [direct/v1/HelloMoon/v0/tenacious\_tentacles /get\_tentacles](https://docs.hellomoon.io/reference) | 50 | Retrieve tentacle-related data from the tenacious tentacles endpoint. |
| [direct/v1/HelloMoon/v0/token-22/buying-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-buying-per-day) | 50 | Track daily buying activity for Token-22 assets on Solana. |
| [direct/v1/HelloMoon/v0/token-22/creation-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-creation-per-day) | 50 | Track daily creation activity for Token-22 assets on Solana. |
| [direct/v1/HelloMoon/v0/token-22/users-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-users-per-day) | 50 | Track the daily active users of a specific token. |
| [direct/v1/HelloMoon/v0/token-22/selling-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-selling-per-day) | 50 | Track daily selling activity for Token-22 assets on Solana. |
| [direct/v1/HelloMoon/v0/token-22 /swaps-balance-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-swaps-balance-per-day) | 50 | Retrieve daily balance data for swaps involving Token-22 assets. |
| [direct/v1/HelloMoon/v0/token-22 /transfers-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-transfers-per-day) | 50 | Track daily transfer activity for Token-22 assets. |
| [direct/v1/HelloMoon/v0/token/candlesticks](https://docs.hellomoon.io/reference/post_v0-token-candlesticks) | 50 | Retrieve candlestick data for token price movements, filtered by start time or other criteria. |
| [direct/v1/HelloMoon/v0/token/daily\_active\_users](https://docs.hellomoon.io/reference/post_v0-token-daily-active-users) | 50 | Track daily active users for a specified token. |
| [direct/v1/HelloMoon/v0/token/daily\_new\_purchases](https://docs.hellomoon.io/reference/post_v0-token-daily-new-purchases) | 50 | Track daily new purchases for a specified token. |
| [direct/v1/HelloMoon/v0/token-22 /first-time-users-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-first-time-users-per-day) | 50 | Track daily first-time users of a specific token. |
| [direct/v1/HelloMoon/v0/token/smart-money-inflow](https://docs.hellomoon.io/reference/post_v0-token-smart-money-inflow) | 50 | Retrieve data on the inflow of smart money into specific tokens. |
| [direct/v1/HelloMoon/v0/token/stats](https://docs.hellomoon.io/reference/post_v0-token-stats) | 50 | Fetch statistical data for tokens on Solana. |
| [direct/v1/HelloMoon/v0/token/trading-volume](https://docs.hellomoon.io/reference/post_v0-token-trading-volume) | 50 | Fetch trading volume data for a specific token. |
| [direct/v1/HelloMoon/v0/token/volume-stats](https://docs.hellomoon.io/reference/post_v0-token-volume-stats) | 50 | Retrieve volume statistics for tokens on Solana. |
| [direct/v1/HelloMoon/v0/defi/top-holders/w-meta](https://docs.hellomoon.io/reference/post_v0-defi-top-holders-w-meta) | 50 | Retrieve top holders with additional metadata information. |
| [direct/v1/HelloMoon/v0/transaction/stream/create](https://docs.hellomoon.io/reference/post_v0-transaction-stream-create) | 50 | Create a transaction data stream with specified webhook or notification settings. |
| [direct/v1/HelloMoon/v0/defi/user-positions](https://docs.hellomoon.io/reference/post_v0-defi-user-positions) | 50 | Fetch user-specific DeFi positions across various pools and assets. |
| [direct/v1/HelloMoon/v0/tenacious\_tentacles /verify](https://docs.hellomoon.io/reference) | 50 | Verify data within the tenacious tentacles endpoint. |
| [direct/v1/HelloMoon/v0/defi/whirlpools /positions-by-user](https://docs.hellomoon.io/reference/post_v0-defi-whirlpools-positions-by-user) | 50 | Retrieve positions within Whirlpool liquidity pools for a specific user. |
### PUT
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------ | ------: | -------------------------------------------------------------------------- |
| [direct/v1/HelloMoon/v0/accounts/stream/update](https://docs.hellomoon.io/reference/put_v0-accounts-stream-update) | 50 | Update an existing account data stream with new target or filter settings. |
| [direct/v1/HelloMoon/v0/accounts/parsed/update](https://docs.hellomoon.io/reference/put_v0-accounts-parsed-update) | 50 | Update a parsed account entry with new data or target information. |
| [direct/v1/HelloMoon/v0/subscriptions/update](https://docs.hellomoon.io/reference/put_v0-subscriptions-update) | 50 | Update an existing subscription with new settings or filters. |
| [direct/v1/HelloMoon/v0/transaction/stream/update](https://docs.hellomoon.io/reference/put_v0-transaction-stream-update) | 50 | Update an existing transaction data stream with new settings. |
## Market Data
### POST
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------------------------------------------------- |
| [direct/v1/HelloMoon/v0/nft/collection/floorprice](https://docs.hellomoon.io/reference/post_v0-nft-collection-floorprice) | 50 | Get the latest floor price for an NFT collection. |
| [direct/v1/HelloMoon/v0/nft/collection/floorprice /batched](https://docs.hellomoon.io/reference/post_v0-nft-collection-floorprice-batched) | 50 | Fetch batched floor prices for multiple NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/floorprice /candlesticks](https://docs.hellomoon.io/reference/post_v0-nft-collection-floorprice-candlesticks) | 50 | Retrieve candlestick data for floor prices of NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection /floor-price-compressed](https://docs.hellomoon.io/reference/post_v0-nft-collection-floor-price-compressed) | 50 | Fetch compressed floor price data for NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection /floorprices](https://docs.hellomoon.io/reference/post_v0-nft-collection-floorprices) | 50 | Retrieve floor prices across multiple NFT collections. |
| [direct/v1/HelloMoon/v0/nft/estimated-price](https://docs.hellomoon.io/reference/post_v0-nft-estimated-price) | 50 | Get estimated price for an NFT based on recent market data and trends. |
| [direct/v1/HelloMoon/v0/nft/marketplace/tensor /floor-price-by-creator](https://docs.hellomoon.io/reference/post_v0-nft-marketplace-tensor-floor-price-by-creator) | 50 | Retrieve floor price data for Tensor marketplace NFTs, grouped by creator. |
| [direct/v1/HelloMoon/v0/nft/marketplace /transactions](https://docs.hellomoon.io/reference/post_v0-nft-marketplace-transactions) | 50 | Retrieve NFT marketplace transaction records, including sale amounts and times. |
| [direct/v1/HelloMoon/v0/nft/market-stats](https://docs.hellomoon.io/reference/post_v0-nft-market-stats) | 50 | Fetch general market statistics for NFTs. |
| [direct/v1/HelloMoon/v0/nft /sales\_per\_market\_daily](https://docs.hellomoon.io/reference/post_v0-nft-sales-per-market-daily) | 50 | Fetch daily sales data for NFTs across different marketplaces. |
| [direct/v1/HelloMoon/v0/spider/wenlambo /usdc\_price\_in\_sol](https://docs.hellomoon.io/reference/post_v0-spider-wenlambo-usdc-price-in-sol) | 50 | Retrieve the price of USDC in SOL under the Spider Wenlambo category. |
| [direct/v1/HelloMoon/v0/token/candlesticks](https://docs.hellomoon.io/reference/post_v0-token-candlesticks) | 50 | Retrieve candlestick data for token price movements, filtered by start time or other criteria. |
| [direct/v1/HelloMoon/v0/token/price](https://docs.hellomoon.io/reference/post_v0-token-price) | 50 | Fetch the current price of a specified token. |
| [direct/v1/HelloMoon/v0/token/price/batched](https://docs.hellomoon.io/reference/post_v0-token-price-batched) | 50 | Retrieve batched price information for multiple tokens. |
| [direct/v1/HelloMoon/v0/token/prices](https://docs.hellomoon.io/reference/post_v0-token-prices) | 50 | Fetch historical and recent price data for a token with specified granularity. |
## NFT
### POST
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------------- |
| [direct/v1/HelloMoon/v0/hello-moon /collection-mint-mapping](https://docs.hellomoon.io/reference/post_v0-hello-moon-collection-mint-mapping) | 50 | Fetch mapping data for collections and mint addresses within the Hello Moon platform. |
| [direct/v1/HelloMoon/v0/nft /mint-accounts-by-owner-cnft](https://docs.hellomoon.io/reference/post_v0-nft-mint-accounts-by-owner-cnft) | 50 | Get mint account details for NFTs owned by a specific user. |
| [direct/v1/HelloMoon/v0/nft/mints-by-owner](https://docs.hellomoon.io/reference/post_v0-nft-mints-by-owner) | 50 | Get a list of NFTs minted by a specific owner on the blockchain. |
| [direct/v1/HelloMoon/v0/nft/collection/all-time](https://docs.hellomoon.io/reference/post_v0-nft-collection-all-time) | 50 | Retrieve all-time data for NFT collections, including transaction volume and price history. |
| [direct/v1/HelloMoon/v0/nft/collection/collective](https://docs.hellomoon.io/reference/post_v0-nft-collection-collective) | 50 | Fetch data for NFT collections labeled as "collective" on Hello Moon. |
| [direct/v1/HelloMoon/v0/nft/collection/floorprice](https://docs.hellomoon.io/reference/post_v0-nft-collection-floorprice) | 50 | Get the latest floor price for an NFT collection. |
| [direct/v1/HelloMoon/v0/nft/collection/floorprice /batched](https://docs.hellomoon.io/reference/post_v0-nft-collection-floorprice-batched) | 50 | Fetch batched floor prices for multiple NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/floorprice /candlesticks](https://docs.hellomoon.io/reference/post_v0-nft-collection-floorprice-candlesticks) | 50 | Retrieve candlestick data for floor prices of NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection /floor-price-compressed](https://docs.hellomoon.io/reference/post_v0-nft-collection-floor-price-compressed) | 50 | Fetch compressed floor price data for NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection /floorprices](https://docs.hellomoon.io/reference/post_v0-nft-collection-floorprices) | 50 | Retrieve floor prices across multiple NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection /leaderboard/stats](https://docs.hellomoon.io/reference/post_v0-nft-collection-leaderboard-stats) | 50 | Get leaderboard statistics for NFT collections based on trading volumes and other factors. |
| [direct/v1/HelloMoon/v0/nft/collection/listing](https://docs.hellomoon.io/reference/post_v0-nft-collection-listing) | 50 | Retrieve listing data for specific NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/mints](https://docs.hellomoon.io/reference/post_v0-nft-collection-mints) | 50 | Retrieve data on newly minted NFTs within specific collections. |
| [direct/v1/HelloMoon/v0/nft/collection/name](https://docs.hellomoon.io/reference/post_v0-nft-collection-name) | 50 | Retrieve NFT collection details by name, using a specific search strategy. |
| [direct/v1/HelloMoon/v0/nft/collection/overlap](https://docs.hellomoon.io/reference/post_v0-nft-collection-overlap) | 50 | Fetch overlap data for NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/overlap /top](https://docs.hellomoon.io/reference/post_v0-nft-collection-overlap-top) | 50 | Retrieve top overlap data for NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/ownership /cumulative](https://docs.hellomoon.io/reference/post_v0-nft-collection-ownership-cumulative) | 50 | Fetch cumulative ownership data for NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/ownership /current](https://docs.hellomoon.io/reference/post_v0-nft-collection-ownership-current) | 50 | Retrieve current ownership data for an NFT collection. |
| [direct/v1/HelloMoon/v0/nft/collection/ownership /historical](https://docs.hellomoon.io/reference/post_v0-nft-collection-ownership-historical) | 50 | Fetch historical ownership data for NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/ownership /holding-period](https://docs.hellomoon.io/reference/post_v0-nft-collection-ownership-holding-period) | 50 | Get holding period data for owners of NFTs in specific collections. |
| [direct/v1/HelloMoon/v0/nft/collection/ownership /top-holders](https://docs.hellomoon.io/reference/post_v0-nft-collection-ownership-top-holders) | 50 | Retrieve top holder data for an NFT collection. |
| [direct/v1/HelloMoon/v0/nft/collection/stats /primary-sales](https://docs.hellomoon.io/reference/post_v0-nft-collection-stats-primary-sales) | 50 | Fetch primary sales statistics for NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection /program-usage](https://docs.hellomoon.io/reference/post_v0-nft-collection-program-usage) | 50 | Fetch program usage statistics for a specific NFT collection. |
| [direct/v1/HelloMoon/v0/nft/collection /smart-money-inflow](https://docs.hellomoon.io/reference/post_v0-nft-collection-smart-money-inflow) | 50 | Retrieve data on smart money inflows into NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/stats](https://docs.hellomoon.io/reference/post_v0-nft-collection-stats) | 50 | Retrieve statistical data for NFT collections. |
| [direct/v1/HelloMoon/v0/nft/collection/volatility](https://docs.hellomoon.io/reference/post_v0-nft-collection-volatility) | 50 | Retrieve volatility data for NFT collections, useful for market analysis. |
| [direct/v1/HelloMoon/v0/nft/collection /washtrading](https://docs.hellomoon.io/reference/post_v0-nft-collection-washtrading) | 50 | Retrieve wash trading data for NFTs within specific collections. |
| [direct/v1/HelloMoon/v0/nft/estimated-price](https://docs.hellomoon.io/reference/post_v0-nft-estimated-price) | 50 | Get estimated price for an NFT based on recent market data and trends. |
| [direct/v1/HelloMoon/v0/nft/freeze\_lookup](https://docs.hellomoon.io/reference/post_v0-nft-freeze-lookup) | 50 | Look up freeze status for NFTs within specific collections. |
| [direct/v1/HelloMoon/v0/nft/freeze\_lookup/v2](https://docs.hellomoon.io/reference/post_v0-nft-freeze-lookup-v2) | 50 | Retrieve freeze status details for NFTs with updated settings or format. |
| [direct/v1/HelloMoon/v0/nft/ownership/historical](https://docs.hellomoon.io/reference/post_v0-nft-ownership-historical) | 50 | Retrieve historical ownership data for NFTs within the specified endpoint. |
| [direct/v1/HelloMoon/v0/nft/sales/secondary /latest](https://docs.hellomoon.io/reference/post_v0-nft-sales-secondary-latest) | 50 | Fetch the latest secondary sales data for a specific NFT or collection. |
| [direct/v1/HelloMoon/v0/nft/leaderboard](https://docs.hellomoon.io/reference/post_v0-nft-leaderboard) | 50 | Retrieve an NFT leaderboard with ordering options such as by smart money inflow. |
| [direct/v1/HelloMoon/v0/nft/listings](https://docs.hellomoon.io/reference/post_v0-nft-listings) | 50 | List all current NFT listings with detailed metadata. |
| [direct/v1/HelloMoon/v0/nft/listing-status](https://docs.hellomoon.io/reference/post_v0-nft-listing-status) | 50 | Retrieve the current listing status of NFTs across marketplaces. |
| [direct/v1/HelloMoon/v0/nft/listing-status/v2](https://docs.hellomoon.io/reference/post_v0-nft-listing-status-v2) | 50 | Get updated listing status data for NFTs across marketplaces. |
| [direct/v1/HelloMoon/v0/nft/loans /collection-summary](https://docs.hellomoon.io/reference/post_v0-nft-loans-collection-summary) | 50 | Get a summary of loans within NFT collections. |
| [direct/v1/HelloMoon/v0/nft/loans/ltv](https://docs.hellomoon.io/reference/post_v0-nft-loans-ltv) | 50 | Get loan-to-value (LTV) ratio data for NFTs, essential for loan assessment. |
| [direct/v1/HelloMoon/v0/nft/marketplace/tensor /floor-price-by-creator](https://docs.hellomoon.io/reference/post_v0-nft-marketplace-tensor-floor-price-by-creator) | 50 | Retrieve floor price data for Tensor marketplace NFTs, grouped by creator. |
| [direct/v1/HelloMoon/v0/nft/marketplace /transactions](https://docs.hellomoon.io/reference/post_v0-nft-marketplace-transactions) | 50 | Retrieve NFT marketplace transaction records, including sale amounts and times. |
| [direct/v1/HelloMoon/v0/nft/market-stats](https://docs.hellomoon.io/reference/post_v0-nft-market-stats) | 50 | Fetch general market statistics for NFTs. |
| [direct/v1/HelloMoon/v0/nft/mint\_information](https://docs.hellomoon.io/reference/post_v0-nft-mint-information) | 50 | Retrieve detailed mint information for a specific NFT. |
| [direct/v1/HelloMoon/v0/nft/collection/ownership /for-pubkey](https://docs.hellomoon.io/reference/post_v0-nft-collection-ownership-for-pubkey) | 50 | Get NFT ownership information for a specific public key. |
| [direct/v1/HelloMoon/v0/nft/sales/primary](https://docs.hellomoon.io/reference/post_v0-nft-sales-primary) | 50 | Retrieve primary sale data for NFTs, including price and buyer information. |
| [direct/v1/HelloMoon/v0/nft/royalty](https://docs.hellomoon.io/reference/post_v0-nft-royalty) | 50 | Retrieve royalty information for NFTs within specified collections. |
| [direct/v1/HelloMoon/v0/nft/royalty/all-time /amount-paid](https://docs.hellomoon.io/reference/post_v0-nft-royalty-all-time-amount-paid) | 50 | Get the all-time amount of royalties paid for a specified NFT collection. |
| [direct/v1/HelloMoon/v0/nft /sales\_per\_market\_daily](https://docs.hellomoon.io/reference/post_v0-nft-sales-per-market-daily) | 50 | Fetch daily sales data for NFTs across different marketplaces. |
| [direct/v1/HelloMoon/v0/nft/sales/secondary](https://docs.hellomoon.io/reference/post_v0-nft-sales-secondary) | 50 | Retrieve secondary sale data for NFTs, including price and buyer details. |
| [direct/v1/HelloMoon/v0/nft/sales/secondary /latest/mint](https://docs.hellomoon.io/reference/post_v0-nft-sales-secondary-latest-mint) | 50 | Retrieve recent secondary sales data for NFTs by mint address. |
| [direct/v1/HelloMoon/v0/nft/social](https://docs.hellomoon.io/reference/post_v0-nft-social) | 50 | Retrieve social engagement data for NFTs on Hello Moon. |
| [direct/v1/HelloMoon/v0/shit/nfts](https://docs.hellomoon.io/reference/post_v0-shit-nfts) | 50 | Fetch NFT data labeled under the "Shit" category on Hello Moon. |
## SocialFi
### DELETE
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------- |
| [direct/v1/HelloMoon/v0/subscriptions/remove/\{id}](https://docs.hellomoon.io/reference/delete_v0-subscriptions-remove-id) | 50 | Remove a subscription by its ID. |
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------- |
| [direct/v1/HelloMoon/v0/subscriptions/retrieve /\{id}](https://docs.hellomoon.io/reference/get_v0-subscriptions-retrieve-id) | 50 | Retrieve a specific subscription by its ID. |
### POST
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------------------------------------------- |
| [direct/v1/HelloMoon/v0/asset-dash-updated](https://docs.hellomoon.io/reference/post_v0-asset-dash-updated) | 50 | Retrieve updated asset dashboard data. |
| [direct/v1/HelloMoon/v0/defi /high-volume-recent-tokens](https://docs.hellomoon.io/reference/post_v0-defi-high-volume-recent-tokens) | 50 | Fetch data on recently high-volume tokens within DeFi. |
| [direct/v1/HelloMoon/v0/defi/token-buying](https://docs.hellomoon.io/reference/post_v0-defi-token-buying) | 50 | Retrieve recent buying activity data for tokens on DeFi platforms. |
| [direct/v1/HelloMoon/v0/defi /trending-tokens-volume](https://docs.hellomoon.io/reference/post_v0-defi-trending-tokens-volume) | 50 | Retrieve volume data for trending tokens on DeFi platforms. |
| [direct/v1/HelloMoon/v0/nft/social](https://docs.hellomoon.io/reference/post_v0-nft-social) | 50 | Retrieve social engagement data for NFTs on Hello Moon. |
| [direct/v1/HelloMoon/v0/skill-issue/leaderboard /get-all](https://docs.hellomoon.io/reference) | 50 | Retrieve leaderboard entries under the Skill Issue category on Hello Moon. |
| [direct/v1/HelloMoon/v0/skill-issue/leaderboard /insert](https://docs.hellomoon.io/reference) | 50 | Insert a new entry into the Skill Issue leaderboard. |
| [direct/v1/HelloMoon/v0/skill-issue/profile](https://docs.hellomoon.io/reference) | 50 | Retrieve profile data within the Skill Issue category. |
| [direct/v1/HelloMoon/v0/skill-issue/profile/get](https://docs.hellomoon.io/reference) | 50 | Fetch profile data for Skill Issue category participants on Hello Moon. |
| [direct/v1/HelloMoon/v0/skill-issue/tournament /had-entered](https://docs.hellomoon.io/reference) | 50 | Check if a user has entered a Skill Issue tournament on Hello Moon. |
| [direct/v1/HelloMoon/v0/skill-issue/tournament /time](https://docs.hellomoon.io/reference) | 50 | Fetch timing information for Skill Issue tournaments. |
| [direct/v1/HelloMoon/v0/superfans/login](https://docs.hellomoon.io/reference) | 50 | Login endpoint for Superfans on Hello Moon. |
| [direct/v1/HelloMoon/v0/defi/top-holders/w-meta](https://docs.hellomoon.io/reference/post_v0-defi-top-holders-w-meta) | 50 | Retrieve top holders with additional metadata information. |
| [direct/v1/HelloMoon/v0/transaction/stream/create](https://docs.hellomoon.io/reference/post_v0-transaction-stream-create) | 50 | Create a transaction data stream with specified webhook or notification settings. |
### PUT
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------ | ------: | ------------------------------------------------------------- |
| [direct/v1/HelloMoon/v0/subscriptions/update](https://docs.hellomoon.io/reference/put_v0-subscriptions-update) | 50 | Update an existing subscription with new settings or filters. |
| [direct/v1/HelloMoon/v0/transaction/stream/update](https://docs.hellomoon.io/reference/put_v0-transaction-stream-update) | 50 | Update an existing transaction data stream with new settings. |
## Token
### POST
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------------------------------- |
| [direct/v1/HelloMoon/v0/defi/fungible-token-info](https://docs.hellomoon.io/reference/post_v0-defi-fungible-token-info) | 50 | Fetch information on fungible tokens in DeFi settings on Solana. |
| [direct/v1/HelloMoon/v0/defi /high-volume-recent-tokens](https://docs.hellomoon.io/reference/post_v0-defi-high-volume-recent-tokens) | 50 | Fetch data on recently high-volume tokens within DeFi. |
| [direct/v1/HelloMoon/v0/defi/program-stats /top-tokens](https://docs.hellomoon.io/reference/post_v0-defi-program-stats-top-tokens) | 50 | Retrieve top tokens based on user interaction within DeFi programs. |
| [direct/v1/HelloMoon/v0/defi/smart-money /top-tokens](https://docs.hellomoon.io/reference/post_v0-defi-smart-money-top-tokens) | 50 | Retrieve top tokens by smart money inflow. |
| [direct/v1/HelloMoon/v0/defi/token-age](https://docs.hellomoon.io/reference/post_v0-defi-token-age) | 50 | Retrieve token age statistics within DeFi pools on Solana. |
| [direct/v1/HelloMoon/v0/defi/token-ath](https://docs.hellomoon.io/reference/post_v0-defi-token-ath) | 50 | Fetch data on tokens that have reached all-time highs within DeFi platforms. |
| [direct/v1/HelloMoon/v0/defi/token-buying](https://docs.hellomoon.io/reference/post_v0-defi-token-buying) | 50 | Retrieve recent buying activity data for tokens on DeFi platforms. |
| [direct/v1/HelloMoon/v0/defi /trending-tokens-volume](https://docs.hellomoon.io/reference/post_v0-defi-trending-tokens-volume) | 50 | Retrieve volume data for trending tokens on DeFi platforms. |
| [direct/v1/HelloMoon/v0/defi/twitter\_accounts /per-token](https://docs.hellomoon.io/reference/post_v0-defi-twitter-accounts-per-token) | 50 | Fetch Twitter account data associated with specific tokens on DeFi platforms. |
| [direct/v1/HelloMoon/v0/token /balances-by-owner-fungible](https://docs.hellomoon.io/reference/post_v0-token-balances-by-owner-fungible) | 50 | Retrieve fungible token balances held by a specified owner on Solana. |
| [direct/v1/HelloMoon/v0/hello-moon/defenders /get-preferred-token](https://docs.hellomoon.io/reference/post_v0-hello-moon-defenders-get-preferred-token) | 50 | Retrieve the preferred token settings for a specific user or account on Hello Moon. |
| [direct/v1/HelloMoon/v0/hello-moon/defenders /set-preferred-token](https://docs.hellomoon.io/reference/post_v0-hello-moon-defenders-set-preferred-token) | 50 | Set the preferred token for a specific user or account on Hello Moon. |
| [direct/v1/HelloMoon/v0/hello-moon/defenders /token-unlock-emergency-migration](https://docs.hellomoon.io/reference/post_v0-hello-moon-defenders-token-unlock-emergency-migration) | 50 | Perform an emergency token unlock or migration for a user on Hello Moon. |
| [direct/v1/HelloMoon/v0/print /top-tokens-by-frequency](https://docs.hellomoon.io/reference) | 50 | Fetch tokens sorted by frequency within the Print category. |
| [direct/v1/HelloMoon/v0/print /top-tokens-by-profit](https://docs.hellomoon.io/reference) | 50 | Retrieve tokens ranked by profitability within the Print category. |
| [direct/v1/HelloMoon/v0/print /top-tokens-trader-profit](https://docs.hellomoon.io/reference) | 50 | Fetch tokens ranked by trader profit within Print. |
| [direct/v1/HelloMoon/v0/print/top-tokens-users](https://docs.hellomoon.io/reference) | 50 | Retrieve data on top tokens by user count within Print. |
| [direct/v1/HelloMoon/v0/shit/spl-token](https://docs.hellomoon.io/reference/post_v0-shit-spl-token) | 50 | Retrieve SPL token data under the "Shit" category on Hello Moon. |
| [direct/v1/HelloMoon/v0/token/smart-money](https://docs.hellomoon.io/reference/post_v0-token-smart-money) | 50 | Fetch data on tokens associated with smart money inflows, with ordering and pagination options. |
| [direct/v1/HelloMoon/v0/token/sol-balance](https://docs.hellomoon.io/reference/post_v0-token-sol-balance) | 50 | Retrieve SOL balance for a specified wallet address. |
| [direct/v1/HelloMoon/v0/defi/sol-grid-bot /top-tokens-one-min](https://docs.hellomoon.io/reference/post_v0-defi-sol-grid-bot-top-tokens-one-min) | 50 | Fetch one-minute interval data on top tokens from the SOL Grid Bot. |
| [direct/v1/HelloMoon/v0/token-22/buying-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-buying-per-day) | 50 | Track daily buying activity for Token-22 assets on Solana. |
| [direct/v1/HelloMoon/v0/token-22/creation-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-creation-per-day) | 50 | Track daily creation activity for Token-22 assets on Solana. |
| [direct/v1/HelloMoon/v0/token-22/users-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-users-per-day) | 50 | Track the daily active users of a specific token. |
| [direct/v1/HelloMoon/v0/token-22/selling-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-selling-per-day) | 50 | Track daily selling activity for Token-22 assets on Solana. |
| [direct/v1/HelloMoon/v0/token-22 /swaps-balance-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-swaps-balance-per-day) | 50 | Retrieve daily balance data for swaps involving Token-22 assets. |
| [direct/v1/HelloMoon/v0/token-22 /transfers-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-transfers-per-day) | 50 | Track daily transfer activity for Token-22 assets. |
| [direct/v1/HelloMoon/v0/token/token-balance](https://docs.hellomoon.io/reference/post_v0-token-token-balance) | 50 | Fetch token balance for a specified wallet address and token. |
| [direct/v1/HelloMoon/v0/token/balances-by-owner](https://docs.hellomoon.io/reference/post_v0-token-balances-by-owner) | 50 | Retrieve token balances held by a specified owner on Solana. |
| [direct/v1/HelloMoon/v0/token /blocktime-unified-mint](https://docs.hellomoon.io/reference/post_v0-token-blocktime-unified-mint) | 50 | Get token block time for unified mint operations on Solana. |
| [direct/v1/HelloMoon/v0/token/candlesticks](https://docs.hellomoon.io/reference/post_v0-token-candlesticks) | 50 | Retrieve candlestick data for token price movements, filtered by start time or other criteria. |
| [direct/v1/HelloMoon/v0/token/creation](https://docs.hellomoon.io/reference/post_v0-token-creation) | 50 | Retrieve creation information for tokens on Solana. |
| [direct/v1/HelloMoon/v0/token/daily\_active\_users](https://docs.hellomoon.io/reference/post_v0-token-daily-active-users) | 50 | Track daily active users for a specified token. |
| [direct/v1/HelloMoon/v0/token/daily\_new\_purchases](https://docs.hellomoon.io/reference/post_v0-token-daily-new-purchases) | 50 | Track daily new purchases for a specified token. |
| [direct/v1/HelloMoon/v0/token-22 /first-time-users-per-day](https://docs.hellomoon.io/reference/post_v0-token-22-first-time-users-per-day) | 50 | Track daily first-time users of a specific token. |
| [direct/v1/HelloMoon/v0/token /token-leaderboard-max-change](https://docs.hellomoon.io/reference/post_v0-token-token-leaderboard-max-change) | 50 | Retrieve tokens with maximum changes in balance or value. |
| [direct/v1/HelloMoon/v0/token/list](https://docs.hellomoon.io/reference/post_v0-token-list) | 50 | List available tokens with relevant metadata. |
| [direct/v1/HelloMoon/v0/token/price](https://docs.hellomoon.io/reference/post_v0-token-price) | 50 | Fetch the current price of a specified token. |
| [direct/v1/HelloMoon/v0/token/price/batched](https://docs.hellomoon.io/reference/post_v0-token-price-batched) | 50 | Retrieve batched price information for multiple tokens. |
| [direct/v1/HelloMoon/v0/token/prices](https://docs.hellomoon.io/reference/post_v0-token-prices) | 50 | Fetch historical and recent price data for a token with specified granularity. |
| [direct/v1/HelloMoon/v0/token/smart-money-inflow](https://docs.hellomoon.io/reference/post_v0-token-smart-money-inflow) | 50 | Retrieve data on the inflow of smart money into specific tokens. |
| [direct/v1/HelloMoon/v0/token/stats](https://docs.hellomoon.io/reference/post_v0-token-stats) | 50 | Fetch statistical data for tokens on Solana. |
| [direct/v1/HelloMoon/v0/token/supply](https://docs.hellomoon.io/reference/post_v0-token-supply) | 50 | Retrieve the circulating supply of a specified token. |
| [direct/v1/HelloMoon/v0/token/trading-volume](https://docs.hellomoon.io/reference/post_v0-token-trading-volume) | 50 | Fetch trading volume data for a specific token. |
| [direct/v1/HelloMoon/v0/token/transfers](https://docs.hellomoon.io/reference/post_v0-token-transfers) | 50 | Retrieve recent transfer records for a token. |
| [direct/v1/HelloMoon/v0/token/transfers /historical](https://docs.hellomoon.io/reference/post_v0-token-transfers-historical) | 50 | Get historical transfer records for a specified token on Solana. |
| [direct/v1/HelloMoon/v0/token/volume-stats](https://docs.hellomoon.io/reference/post_v0-token-volume-stats) | 50 | Retrieve volume statistics for tokens on Solana. |
| [direct/v1/HelloMoon/v0/defi/top-holders](https://docs.hellomoon.io/reference/post_v0-defi-top-holders) | 50 | List top holders of specified DeFi tokens. |
| [direct/v1/HelloMoon/v0/defi/top-holders/w-meta](https://docs.hellomoon.io/reference/post_v0-defi-top-holders-w-meta) | 50 | Retrieve top holders with additional metadata information. |
## Transaction
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------------------- |
| [direct/v1/HelloMoon/v0/solana/all-time /txns-by-user](https://docs.hellomoon.io/reference/post_v0-solana-all-time-txns-by-user) | 50 | Get all-time transaction history for a specified user on Solana. |
| [direct/v1/HelloMoon/v0/defi/swaps](https://docs.hellomoon.io/reference/post_v0-defi-swaps) | 50 | Retrieve swap transaction data for DeFi protocols, including details such as aggregator and time. |
| [direct/v1/HelloMoon/v0/jito/confirm-txn](https://docs.hellomoon.io/reference/post_v0-jito-confirm-txn) | 50 | Confirm a transaction on Solana using Jito, a high-performance trading solution. |
| [direct/v1/HelloMoon/v0/nft/marketplace /transactions](https://docs.hellomoon.io/reference/post_v0-nft-marketplace-transactions) | 50 | Retrieve NFT marketplace transaction records, including sale amounts and times. |
| [direct/v1/HelloMoon/v0/swaps/mint-filter](https://docs.hellomoon.io/reference/post_v0-swaps-mint-filter) | 50 | Filter swap transactions by mint address, pagination supported. |
| [direct/v1/HelloMoon/v0/solana/txns-by-user](https://docs.hellomoon.io/reference/post_v0-solana-txns-by-user) | 50 | Retrieve recent transactions for a specified user on Solana, with optional filters on block time. |
| [direct/v1/HelloMoon/v0/transaction/stream/create](https://docs.hellomoon.io/reference/post_v0-transaction-stream-create) | 50 | Create a transaction data stream with specified webhook or notification settings. |
### PUT
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------ | ------: | ------------------------------------------------------------- |
| [direct/v1/HelloMoon/v0/transaction/stream/update](https://docs.hellomoon.io/reference/put_v0-transaction-stream-update) | 50 | Update an existing transaction data stream with new settings. |
## Wallets
### POST
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------------------- |
| [direct/v1/HelloMoon/v0/solana/all-time /txns-by-user](https://docs.hellomoon.io/reference/post_v0-solana-all-time-txns-by-user) | 50 | Get all-time transaction history for a specified user on Solana. |
| [direct/v1/HelloMoon/v0/print/stats/wallet](https://docs.hellomoon.io/reference) | 50 | Fetch wallet statistics for Print-related data on Solana. |
| [direct/v1/HelloMoon/v0/solana/txns-by-user](https://docs.hellomoon.io/reference/post_v0-solana-txns-by-user) | 50 | Retrieve recent transactions for a specified user on Solana, with optional filters on block time. |
| [direct/v1/HelloMoon/v0/defi/whirlpools /positions-by-user](https://docs.hellomoon.io/reference/post_v0-defi-whirlpools-positions-by-user) | 50 | Retrieve positions within Whirlpool liquidity pools for a specific user. |
# Kraken direct API on Uniblock: market data and trading
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-kraken
Query Kraken's 55 direct API endpoints on Uniblock for spot market data, order books, trading, historical prices, wallets, and CeFi funding operations.
# Kraken: Direct API Endpoints
Kraken provides 55 unique direct API endpoints across the following categories:
* Centralized Finance (21 endpoints)
* Historical (1 endpoint)
* Market Data (28 endpoints)
* Token (1 endpoint)
* Trading (13 endpoints)
* Utility (7 endpoints)
* Wallets (5 endpoints)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
## Prefix and Example
**Prefix:** No prefix is required for Kraken, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/Kraken + /[Kraken_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/Kraken/0/public/SystemStatus \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## Centralized Finance
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| direct/v1/Kraken/api/history/v3/executions | 100 | Lists executions/trades for authenticated account. |
| direct/v1/Kraken/derivatives/api/v3/feeschedules | 100 | This endpoint lists all fee schedules. |
| direct/v1/Kraken/derivatives/api/v3 /notifications | 100 | This endpoint provides the platforms notifications. |
| direct/v1/Kraken/derivatives/api/v3/openorders | 100 | This endpoint returns information on all open orders for all Futures contracts. |
| direct/v1/Kraken/derivatives/api/v3 /openpositions | 100 | This endpoint returns the size and average entry price of all open positions in Futures contracts. This includes Futures contracts that have matured but have not yet been settled. |
| direct/v1/Kraken/api/history/v3/orders | 100 | Lists order events for authenticated account. |
| direct/v1/Kraken/derivatives/api/v3 /pnlpreferences | 100 | The PNL currency preference is used to determine which currency to pay out when realizing PNL gains. |
| direct/v1/Kraken/derivatives/api/v3 /portfolio-margining/parameters | 100 | Retrieve current portfolio margin calculation parameters. |
| direct/v1/Kraken/derivatives/api/v3/unwindqueue | 100 | This endpoint returns the percentile of the open position in case of unwinding. |
| direct/v1/Kraken/api/history/v3/positions | 100 | Lists position events for authenticated account. |
| direct/v1/Kraken/derivatives/api/v3 /self-trade-strategy | 100 | Returns account-wide self-trade matching strategy. |
| direct/v1/Kraken/0/public/Time | 100 | Get the server's time. |
| direct/v1/Kraken/0/public/SystemStatus | 100 | Get the current system status or trading mode. |
| direct/v1/Kraken/api/history/v3/triggers | 100 | Lists trigger events for authenticated account. |
| direct/v1/Kraken/derivatives/api/v3/fills | 100 | This endpoint returns information on your filled orders for all futures contracts. |
| direct/v1/Kraken/derivatives/api/v3/rfqs | 100 | Retrieve all currently open RFQs |
| direct/v1/Kraken/derivatives/api/v3 /assignmentprogram/history | 100 | This endpoint returns information on assignment program preferences change history |
| direct/v1/Kraken/derivatives/api/v3 /assignmentprogram/current | 100 | This endpoint returns information on currently active assignment programs |
| direct/v1/Kraken/derivatives/api/v3/rfqs /open-offers | 100 | Retrieve all open offers for the account on currently open RFQs |
| direct/v1/Kraken/derivatives/api/v3/rfqs /open-rfqs | 100 | Retrieve all currently open RFQs created by the authenticated account. |
| direct/v1/Kraken/derivatives/api/v3/rfqs /\{rfqUid} | 100 | Retrieve a specific open RFQ by its unique identifier |
## Historical
### GET
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------- | ------: | ---------------------------------------------------------------------------------- |
| direct/v1/Kraken/derivatives/api/v3 /assignmentprogram/history | 100 | This endpoint returns information on assignment program preferences change history |
## Market Data
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------- | ------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| direct/v1/Kraken/derivatives/api/v3/feeschedules /volumes | 100 | Returns your fee schedule volumes for each fee schedule. |
| direct/v1/Kraken/0/public/GroupedBook | 100 | The GroupedBook endpoint aggregates the volume in the order book over a specified tick range. It provides a summary of liquidity deep into the book, useful for user interface display. |
| direct/v1/Kraken/derivatives/api/v3/instruments /\{symbol}/status | 100 | Returns price dislocation and volatility details for given market. |
| direct/v1/Kraken/derivatives/api/v3/instruments /status | 100 | Returns price dislocation and volatility details for all markets. |
| direct/v1/Kraken/derivatives/api/v3/instruments | 100 | Returns specifications for all currently listed markets and indices. |
| direct/v1/Kraken/api/charts/v1/analytics /liquidity-pool | 100 | Get liquidity pool statistic including usd value |
| direct/v1/Kraken/0/public/OHLC | 100 | Retrieve OHLC market data. |
| direct/v1/Kraken/0/public/Depth | 100 | Returns level 2 (L2) order book, which describes the individual price levels in the book with aggregated order quantities at each level. |
| direct/v1/Kraken/derivatives/api/v3/orderbook | 100 | This endpoint returns the entire non-cumulative order book of currently listed Futures contracts. |
| direct/v1/Kraken/api/history/v3/market /\{tradeable}/executions | 100 | Lists trades for a market. |
| direct/v1/Kraken/api/history/v3/market /\{tradeable}/price | 100 | Lists price events for a market. |
| direct/v1/Kraken/api/history/v3/market /\{tradeable}/orders | 100 | Lists order events for a market. |
| direct/v1/Kraken/0/public/Spread | 100 | Returns the last \~200 top-of-book spreads for a given pair |
| direct/v1/Kraken/0/public/Trades | 100 | Returns the last 1000 trades by default |
| direct/v1/Kraken/derivatives/api/v3/tickers /\{symbol} | 100 | Get market data for contract or index by symbol |
| direct/v1/Kraken/0/public/Ticker | 100 | Get ticker information for all or requested markets. |
| direct/v1/Kraken/derivatives/api/v3/tickers | 100 | This endpoint returns current market data for all currently listed Futures contracts and indices. |
| direct/v1/Kraken/0/public/AssetPairs | 100 | Get tradable asset pairs |
| direct/v1/Kraken/derivatives/api/v3/history | 100 | This endpoint returns the most recent 100 trades prior to the specified lastTime value up to past 7 days or recent trading engine restart (whichever is sooner). |
| direct/v1/Kraken/derivatives/api/v3/trading /instruments | 100 | Returns specifications for all currently accessible markets and indices. |
| direct/v1/Kraken/derivatives/api/v3 /historical-funding-rates | 100 | Returns list of historical funding rates for given market. |
| direct/v1/Kraken/api/charts/v1/analytics /\{symbol}/\{analytics\_type} | 100 | Analytics data divided into time buckets |
| direct/v1/Kraken/api/charts/v1/:tick\_type /\{symbol}/\{resolution} | 100 | Candles for specified tick type, market, and resolution. |
| direct/v1/Kraken/api/charts/v1/\{tick\_type} | 100 | Markets available for specified tick type. |
| direct/v1/Kraken/0/public/PostTrade | 100 | Returns a list of trades on the spot exchange. If no filter parameters are specified, the last 1000 trades for all pairs are received. |
| direct/v1/Kraken/0/public/PreTrade | 100 | Returns the price levels in the order book with aggregated order quantities at each price level. The top 10 levels are returned for each trading pair. |
| direct/v1/Kraken/api/charts/v1/\{tick\_type} /\{symbol} | 100 | Candle resolutions available for specified tick type and market. |
| direct/v1/Kraken/api/charts/v1 | 100 | Returns all available tick types to use with the markets endpoint. |
## Token
### GET
| Path | Est. CU | Description |
| --------------------------------------------- | ------: | ---------------------------------------------------------------------------------------------- |
| direct/v1/Kraken/0/public/Assets | 100 | Get information about the assets that are available for deposit, withdrawal, trading and earn. |
## Trading
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| direct/v1/Kraken/api/history/v3/executions | 100 | Lists executions/trades for authenticated account. |
| direct/v1/Kraken/derivatives/api/v3/feeschedules | 100 | This endpoint lists all fee schedules. |
| direct/v1/Kraken/derivatives/api/v3/openorders | 100 | This endpoint returns information on all open orders for all Futures contracts. |
| direct/v1/Kraken/derivatives/api/v3 /openpositions | 100 | This endpoint returns the size and average entry price of all open positions in Futures contracts. This includes Futures contracts that have matured but have not yet been settled. |
| direct/v1/Kraken/api/history/v3/orders | 100 | Lists order events for authenticated account. |
| direct/v1/Kraken/derivatives/api/v3/unwindqueue | 100 | This endpoint returns the percentile of the open position in case of unwinding. |
| direct/v1/Kraken/api/history/v3/positions | 100 | Lists position events for authenticated account. |
| direct/v1/Kraken/api/history/v3/triggers | 100 | Lists trigger events for authenticated account. |
| direct/v1/Kraken/derivatives/api/v3/fills | 100 | This endpoint returns information on your filled orders for all futures contracts. |
| direct/v1/Kraken/derivatives/api/v3/rfqs | 100 | Retrieve all currently open RFQs |
| direct/v1/Kraken/derivatives/api/v3/rfqs /open-offers | 100 | Retrieve all open offers for the account on currently open RFQs |
| direct/v1/Kraken/derivatives/api/v3/rfqs /open-rfqs | 100 | Retrieve all currently open RFQs created by the authenticated account. |
| direct/v1/Kraken/derivatives/api/v3/rfqs /\{rfqUid} | 100 | Retrieve a specific open RFQ by its unique identifier |
## Utility
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------------------------------------------------------- |
| direct/v1/Kraken/derivatives/api/v3 /notifications | 100 | This endpoint provides the platforms notifications. |
| direct/v1/Kraken/derivatives/api/v3 /pnlpreferences | 100 | The PNL currency preference is used to determine which currency to pay out when realizing PNL gains. |
| direct/v1/Kraken/derivatives/api/v3 /portfolio-margining/parameters | 100 | Retrieve current portfolio margin calculation parameters. |
| direct/v1/Kraken/derivatives/api/v3 /self-trade-strategy | 100 | Returns account-wide self-trade matching strategy. |
| direct/v1/Kraken/0/public/Time | 100 | Get the server's time. |
| direct/v1/Kraken/0/public/SystemStatus | 100 | Get the current system status or trading mode. |
| direct/v1/Kraken/derivatives/api/v3 /assignmentprogram/current | 100 | This endpoint returns information on currently active assignment programs |
## Wallets
### GET
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| direct/v1/Kraken/api/history/v3/accountlogcsv | 100 | Lists recent account log entries in CSV format. |
| direct/v1/Kraken/derivatives/api/v3/subaccount /\{subaccountUid}/trading-enabled | 100 | Returns trading capability info for given subaccount. |
| direct/v1/Kraken/api/history/v3/account-log | 100 | Lists account log entries, paged by timestamp or by ID. |
| direct/v1/Kraken/derivatives/api/v3/subaccounts | 100 | Return information about subaccounts, including balances and UIDs. |
| direct/v1/Kraken/derivatives/api/v3/accounts | 100 | This endpoint returns key information relating to all your accounts which may either be cash accounts or margin accounts. This includes digital asset balances, instrument balances, margin requirements, margin trigger estimates and auxiliary information such as available funds, PnL of open positions and portfolio value. |
# LunarCrush direct API on Uniblock: SocialFi and market data
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-lunarcrush
Query LunarCrush's 32 direct API endpoints on Uniblock for social sentiment, market data, token metrics, NFT signals, and DeFi engagement analytics.
# LunarCrush: Direct API Endpoints
LunarCrush provides 32 unique direct API endpoints across the following categories:
* DeFi (5 endpoints)
* Market Data (5 endpoints)
* NFT (5 endpoints)
* SocialFi (11 endpoints)
* Token (6 endpoints)
> **Learn more:** [LunarCrush Documentation](https://lunarcrush.com/developers)
## Prefix and Example
**Prefix:** No prefix is required for LunarCrush, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/LunarCrush + /[LunarCrush_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/LunarCrush/public/categories/list/v1 \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## DeFi
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------- |
| [direct/v1/LunarCrush/public/categories/list/v1](https://lunarcrush.com/developers/api/public/categories/list/v1) | 5000 | Get a list of trending social categories. |
| [direct/v1/LunarCrush/public/category/\{category} /creators/v1](https://lunarcrush.com/developers/api/public/category/:category/creators/v1) | 5000 | Get the top creators for a social category |
| [direct/v1/LunarCrush/public/category/\{category} /v1](https://lunarcrush.com/developers/api/public/category/:category/v1) | 5000 | Get summary information for a social topic |
| [direct/v1/LunarCrush/public/category/\{category} /time-series/v1](https://lunarcrush.com/developers/api/public/category/:category/time-series/v1) | 5000 | Get historical time series data for a social category |
| [direct/v1/LunarCrush/public/category/\{category} /topics/v1](https://lunarcrush.com/developers/api/public/category/:category/topics/v1) | 5000 | Get the top topics for a social category |
## Market Data
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/LunarCrush/public/stocks/\{stock}/v1](https://lunarcrush.com/developers/api/public/stocks/:stock/v1) | 5000 | Get market data on a stock. Specify the coin to be queried by providing the numeric ID or the symbol of the coin in the input parameter, which can be found by calling the /coins/list endpoint. |
| [direct/v1/LunarCrush/public/stocks/list/v1](https://lunarcrush.com/developers/api/public/stocks/list/v1) | 5000 | Lists all stocks supported by LunarCrush. Includes the "topic" endpoint to use to get social data from this asset as a social topic. |
| [direct/v1/LunarCrush/public/stocks/list/v2](https://lunarcrush.com/developers/api/public/stocks/list/v2) | 5000 | Get a general snapshot of LunarCrush metrics on the entire list of tracked stocks. It is designed as a lightweight mechanism for monitoring the universe of available assets, either in aggregate or relative to each other. Metrics include Galaxy Score™, AltRank™, floor price, 24h percent change, market cap, social mentions, social interactions, social contributors, social dominance, and categories. |
| [direct/v1/LunarCrush/public/stocks/\{stock} /time-series/v1](https://lunarcrush.com/developers/api/public/stocks/:stock/time-series/v1) | 5000 | Get market time series data on a stock. Specify the stock to be queried by providing the numeric ID or the symbol of the stock in the input parameter, which can be found by calling the /stocks/list endpoint. |
| [direct/v1/LunarCrush/public/stocks/\{stock} /time-series/v2](https://lunarcrush.com/developers/api/public/stocks/:stock/time-series/v2) | 5000 | Get market time series data on a stock. Specify the stock to be queried by providing the numeric ID or the symbol of the stock in the input parameter, which can be found by calling the /stocks/list endpoint. |
## NFT
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/LunarCrush/public/nfts/\{nft}/v1](https://lunarcrush.com/developers/api/public/nfts/:nft/v1) | 5000 | Get market data on an nft collection. Specify the nft to be queried by providing the numeric ID or the slug of the nft in the input parameter, which can be found by calling the /public/nfts/list endpoint. |
| [direct/v1/LunarCrush/public/nfts/list/v1](https://lunarcrush.com/developers/api/public/nfts/list/v1) | 5000 | Lists all nft collections supported by LunarCrush. Includes the "topic" endpoint to use to get social data from this nft collection as a social topic. |
| [direct/v1/LunarCrush/public/nfts/list/v2](https://lunarcrush.com/developers/api/public/nfts/list/v2) | 5000 | Get a general snapshot of LunarCrush metrics on the entire list of tracked NFTS. It is designed as a lightweight mechanism for monitoring the universe of available assets, either in aggregate or relative to each other. Metrics include Galaxy Score™, AltRank™, floor price, 24h percent change, market cap, social mentions, social interactions, social contributors, social dominance, and categories. |
| [direct/v1/LunarCrush/public/nfts/\{nft} /time-series/v1](https://lunarcrush.com/developers/api/public/nfts/:nft/time-series/v1) | 5000 | Get market time series data on an nft collection. Specify the nft to be queried by providing the numeric ID or slug of the nft collection in the input parameter, which can be found by calling the /public/nfts/list endpoint. |
| [direct/v1/LunarCrush/public/nfts/\{nft} /time-series/v2](https://lunarcrush.com/developers/api/public/nfts/:nft/time-series/v2) | 5000 | Get market time series data on a nft. Specify the nft to be queried by providing the numeric ID or the symbol of the nft in the input parameter, which can be found by calling the /nfts/list endpoint. |
## SocialFi
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [direct/v1/LunarCrush/public/creator/\{network} /\{id}/v1](https://lunarcrush.com/developers/api/public/creator/:network/:id/v1) | 5000 | Get detail information on a specific creator |
| [direct/v1/LunarCrush/public/creator/\{network} /\{id}/posts/v1](https://lunarcrush.com/developers/api/public/creator/:network/:id/posts/v1) | 5000 | Get the top posts for a specific creator. |
| [direct/v1/LunarCrush/public/creators/list/v1](https://lunarcrush.com/developers/api/public/creators/list/v1) | 5000 | Get a list of trending social creators over all of social based on interactions. To get lists of creators by category or topic see the topics and categories endpoints. |
| [direct/v1/LunarCrush/public/creator/\{network} /\{id}/time-series/v1](https://lunarcrush.com/developers/api/public/creator/:network/:id/time-series/v1) | 5000 | Get time series data on a creator. |
| [direct/v1/LunarCrush/public/posts/\{post\_type} /\{post\_id}/v1](https://lunarcrush.com/developers/api/public/posts/:post_type/:post_id/v1) | 5000 | Get details of a post |
| [direct/v1/LunarCrush/public/posts/\{post\_type} /\{post\_id}/time-series/v1](https://lunarcrush.com/developers/api/public/posts/:post_type/:post_id/time-series/v1) | 5000 | Get interactions over time for a post. If a post is older than 365 days the time series will be returned as daily interactions, otherwise it hourly interactions |
| [direct/v1/LunarCrush/public/topic/\{topic} /creators/v1](https://lunarcrush.com/developers/api/public/topic/:topic/creators/v1) | 5000 | Get the top creators for a social topic |
| [direct/v1/LunarCrush/public/topic/\{topic}/posts /v1](https://lunarcrush.com/developers/api/public/topic/:topic/posts/v1) | 5000 | Get the top posts for a social topic. If start time is provided the result will be the top posts by interactions for the time range. If start is not provided it will be the most recent top posts by interactions from the last 24 hours. |
| [direct/v1/LunarCrush/public/topics/list/v1](https://lunarcrush.com/developers/api/public/topics/list/v1) | 5000 | Get a list of trending social topics. |
| [direct/v1/LunarCrush/public/topic/\{topic}/v1](https://lunarcrush.com/developers/api/public/topic/:topic/v1) | 5000 | Get summary information for a social topic. The output is a 24 hour aggregation social activity with metrics comparing the latest 24 hours to the previous 24 hours. |
| [direct/v1/LunarCrush/public/topic/\{topic} /time-series/v1](https://lunarcrush.com/developers/api/public/topic/:topic/time-series/v1) | 5000 | Get historical time series data for a social topic |
## Token
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/LunarCrush/public/coins/\{coin}/v1](https://lunarcrush.com/developers/api/public/coins/:coin/v1) | 5000 | Get market data on a coin or token. Specify the coin to be queried by providing the numeric ID or the symbol of the coin in the input parameter, which can be found by calling the /coins/list endpoint. |
| [direct/v1/LunarCrush/public/coins/\{coin}/meta/v1](https://lunarcrush.com/developers/api/public/coins/:coin/meta/v1) | 5000 | Get meta information for a cryptocurrency project. This includes information such as the website, social media links, and other information. |
| [direct/v1/LunarCrush/public/coins/list/v1](https://lunarcrush.com/developers/api/public/coins/list/v1) | 5000 | Lists all coins and tokens supported by LunarCrush. Includes the "topic" endpoint to use to get social data from this asset as a social topic. |
| [direct/v1/LunarCrush/public/coins/list/v2](https://lunarcrush.com/developers/api/public/coins/list/v2) | 5000 | Get a general snapshot of LunarCrush metrics on the entire list of tracked coins. It is designed as a lightweight mechanism for monitoring the universe of available assets, either in aggregate or relative to each other. Metrics include Galaxy Score™, AltRank™, price, volatility, 24h percent change, market cap, social mentions, social interactions, social contributors, social dominance, and categories. |
| [direct/v1/LunarCrush/public/coins/\{coin} /time-series/v1](https://lunarcrush.com/developers/api/public/coins/:coin/time-series/v1) | 5000 | Get market time series data on a coin or token. Specify the coin to be queried by providing the numeric ID or the symbol of the coin in the input parameter, which can be found by calling the /coins/list endpoint. |
| [direct/v1/LunarCrush/public/coins/\{coin} /time-series/v2](https://lunarcrush.com/developers/api/public/coins/:coin/time-series/v2) | 5000 | Get market time series data on a coin or token. Specify the coin to be queried by providing the numeric ID or the symbol of the coin in the input parameter, which can be found by calling the /coins/list endpoint. |
# Magic Eden direct API on Uniblock: NFT marketplace data
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-magiceden
Query Magic Eden's 41 direct API endpoints on Uniblock for NFT collection listings, floor prices, trades, activity, and marketplace metadata across chains.
# MagicEden: Direct API Endpoints
MagicEden provides 41 unique direct API endpoints across the following categories:
* Other (41 endpoints)
> **Learn more:** [MagicEden Documentation](https://docs.magiceden.io/reference)
## Prefix and Example
**Prefix:** No prefix is required for MagicEden, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/MagicEden + /[MagicEden_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/MagicEden/v2/collections \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## Other
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ----------- |
| [direct/v1/MagicEden/v2/tokens/\{token\_mint} /activities](https://docs.magiceden.io/reference/get_tokens-token-mint-activities) | 5000 | |
| [direct/v1/MagicEden/v2/collections/\{symbol} /activities](https://docs.magiceden.io/reference/get_collections-symbol-activities) | 5000 | |
| [direct/v1/MagicEden/v2/wallets/\{wallet\_address} /activities](https://docs.magiceden.io/reference/get_wallets-wallet-address-activities) | 5000 | |
| [direct/v1/MagicEden/v2/mmm/pools](https://docs.magiceden.io/reference/get_mmm-pools) | 5000 | |
| [direct/v1/MagicEden/v2/mmm/pools/buy-walls](https://docs.magiceden.io/reference) | 5000 | |
| [direct/v1/MagicEden/v2/collections /\{collectionSymbol}/attributes](https://docs.magiceden.io/reference/get_collections-collectionsymbol-attributes) | 5000 | |
| [direct/v1/MagicEden/v2/mmm/token/\{mint\_address} /pools](https://docs.magiceden.io/reference/get_mmm-token-mint-address-pools) | 5000 | |
| [direct/v1/MagicEden/v2/collections](https://docs.magiceden.io/reference/get_collections) | 5000 | |
| [direct/v1/MagicEden/v2/wallets/\{wallet\_address} /escrow\_balance](https://docs.magiceden.io/reference/get_wallets-wallet-address-escrow-balance) | 5000 | |
| [direct/v1/MagicEden/v2/collections/\{symbol} /holder\_stats](https://docs.magiceden.io/reference/get_collections-symbol-holder-stats) | 5000 | |
| [direct/v1/MagicEden/v2/wallets/\{wallet\_address}](https://docs.magiceden.io/reference/get_wallets-wallet-address) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/buy](https://docs.magiceden.io/reference/get_instructions-buy) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/buy\_now](https://docs.magiceden.io/reference/get_instructions-buy-now) | 5000 | |
| [direct/v1/MagicEden/v2/instructions /buy\_now\_transfer\_nft](https://docs.magiceden.io/reference/get_instructions-buy-now-transfer-nft) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/buy\_cancel](https://docs.magiceden.io/reference/get_instructions-buy-cancel) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/sell\_cancel](https://docs.magiceden.io/reference/get_instructions-sell-cancel) | 5000 | |
| [direct/v1/MagicEden/v2/instructions /buy\_change\_price](https://docs.magiceden.io/reference/get_instructions-buy-change-price) | 5000 | |
| [direct/v1/MagicEden/v2/instructions /sell\_change\_price](https://docs.magiceden.io/reference/get_instructions-sell-change-price) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/mmm /sol-close-pool](https://docs.magiceden.io/reference/get_instructions-mmm-sol-close-pool) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/mmm /create-pool](https://docs.magiceden.io/reference/get_instructions-mmm-create-pool) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/mmm /sol-deposit-buy](https://docs.magiceden.io/reference/get_instructions-mmm-sol-deposit-buy) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/deposit](https://docs.magiceden.io/reference/get_instructions-deposit) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/mmm /sol-fulfill-buy](https://docs.magiceden.io/reference/get_instructions-mmm-sol-fulfill-buy) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/mmm /sol-fulfill-sell](https://docs.magiceden.io/reference/get_instructions-mmm-sol-fulfill-sell) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/sell](https://docs.magiceden.io/reference/get_instructions-sell) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/sell\_now](https://docs.magiceden.io/reference/get_instructions-sell-now) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/mmm /update-pool](https://docs.magiceden.io/reference/get_instructions-mmm-update-pool) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/withdraw](https://docs.magiceden.io/reference/get_instructions-withdraw) | 5000 | |
| [direct/v1/MagicEden/v2/instructions/mmm /sol-withdraw-buy](https://docs.magiceden.io/reference/get_instructions-mmm-sol-withdraw-buy) | 5000 | |
| [direct/v1/MagicEden/v2/launchpad/collections](https://docs.magiceden.io/reference/get_launchpad-collections) | 5000 | |
| [direct/v1/MagicEden/v2/tokens/\{token\_mint} /listings](https://docs.magiceden.io/reference/get_tokens-token-mint-listings) | 5000 | |
| [direct/v1/MagicEden/v2/collections/\{symbol} /listings](https://docs.magiceden.io/reference/get_collections-symbol-listings) | 5000 | |
| [direct/v1/MagicEden/v2/wallets/\{wallet\_address} /offers\_made](https://docs.magiceden.io/reference/get_wallets-wallet-address-offers-made) | 5000 | |
| [direct/v1/MagicEden/v2/wallets/\{wallet\_address} /offers\_received](https://docs.magiceden.io/reference/get_wallets-wallet-address-offers-received) | 5000 | |
| [direct/v1/MagicEden/v2/tokens/\{token\_mint} /offers\_received](https://docs.magiceden.io/reference/get_tokens-token-mint-offers-received) | 5000 | |
| [direct/v1/MagicEden/v2/collections/\{symbol} /stats](https://docs.magiceden.io/reference/get_collections-symbol-stats) | 5000 | |
| [direct/v1/MagicEden/v2/marketplace /popular\_collections](https://docs.magiceden.io/reference/get_marketplace-popular-collections) | 5000 | |
| [direct/v1/MagicEden/v2/tokens/\{token\_mint}](https://docs.magiceden.io/reference/get_tokens-token-mint) | 5000 | |
| [direct/v1/MagicEden/v2/wallets/\{wallet\_address} /tokens](https://docs.magiceden.io/reference/get_wallets-wallet-address-tokens) | 5000 | |
| [direct/v1/MagicEden/v2/collections/\{symbol} /leaderboard](https://docs.magiceden.io/reference/get_collections-symbol-leaderboard) | 5000 | |
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------ | ------: | ----------- |
| [direct/v1/MagicEden/v2/collections/batch /listings](https://docs.magiceden.io/reference/post_collections-batch-listings) | 5000 | |
# Mempool direct API on Uniblock: Bitcoin mempool and blocks
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-mempool
Query Mempool's 83 direct API endpoints on Uniblock for Bitcoin block, transaction, fee, and mempool data streamed from a public mempool.space instance.
# Mempool: Direct API Endpoints
Mempool provides 83 unique direct API endpoints across the following categories:
* Other (83 endpoints)
## Prefix and Example
**Prefix:** No prefix is required for Mempool, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/Mempool + /[Mempool_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/Mempool/address/{address} \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## Other
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------- | ------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| direct/v1/Mempool/v1/difficulty-adjustment | 2000 | Returns details about difficulty adjustment. |
| direct/v1/Mempool/v1/prices | 2000 | Returns bitcoin latest price denominated in main currencies. |
| direct/v1/Mempool/v1/historical-price | 2000 | Returns bitcoin historical price denominated in main currencies. Available query parameters: currency, timestamp. If no parameter is provided, the full price history for all currencies is returned. |
| direct/v1/Mempool/address/\{address} | 2000 | Returns details about an address. Available fields: address, chain\_stats, and mempool\_stats. chain\_stats and mempool\_stats each contain an object with tx\_count, funded\_txo\_count, funded\_txo\_sum, spent\_txo\_count, and spent\_txo\_sum. |
| direct/v1/Mempool/address/\{address}/txs | 2000 | Get transaction history for the specified address/scripthash, sorted with newest first. Returns up to 50 mempool transactions plus the first 25 confirmed transactions. You can request more confirmed transactions using an after\_txid query parameter. |
| direct/v1/Mempool/address/\{address}/txs/chain | 2000 | Get confirmed transaction history for the specified address/scripthash, sorted with newest first. Returns 25 transactions per page. More can be requested by specifying the last txid seen by the previous query. |
| direct/v1/Mempool/address/\{address}/txs/mempool | 2000 | Get unconfirmed transaction history for the specified address/scripthash. Returns up to 50 transactions (no paging). |
| direct/v1/Mempool/address/\{address}/utxo | 2000 | Get the list of unspent transaction outputs associated with the address/scripthash. Available fields: txid, vout, value, and status (with the status of the funding tx). |
| direct/v1/Mempool/v1/validate-address/\{address} | 2000 | Returns whether an address is valid or not. Available fields: isvalid (boolean), address (string), scriptPubKey (string), isscript (boolean), iswitness (boolean), witness\_version (numeric, optional), and witness\_program (string, optional). |
| direct/v1/Mempool/block/\{hash} | 2000 | Returns details about a block. |
| direct/v1/Mempool/block/\{hash}/header | 2000 | Returns the hex-encoded block header. |
| direct/v1/Mempool/block-height/\{height} | 2000 | Returns the hash of the block currently at :height. |
| direct/v1/Mempool/v1/mining/blocks/timestamp /\{timestamp} | 2000 | Returns the height and the hash of the block closest to the given :timestamp. |
| direct/v1/Mempool/block/\{hash}/raw | 2000 | Returns the raw block representation in binary. |
| direct/v1/Mempool/block/\{hash}/status | 2000 | Returns the confirmation status of a block. Available fields: in\_best\_chain (boolean, false for orphaned blocks), next\_best (the hash of the next block, only available for blocks in the best chain). |
| direct/v1/Mempool/blocks/tip/height | 2000 | Returns the height of the last block. |
| direct/v1/Mempool/blocks/tip/hash | 2000 | Returns the hash of the last block. |
| direct/v1/Mempool/block/\{hash}/txid/\{index} | 2000 | Returns the transaction at index :index within the specified block. |
| direct/v1/Mempool/block/\{hash}/txids | 2000 | Returns a list of all txids in the block. |
| direct/v1/Mempool/block/\{hash}/txs | 2000 | Returns a list of transactions in the block (up to 25 transactions beginning at start\_index). Transactions returned here do not have the status field, since all the transactions share the same block and confirmation status. |
| direct/v1/Mempool/v1/blocks/\{startHeight} | 2000 | Returns details on the past 15 blocks with fee and mining details in an extras field. If :startHeight is specified, the past 15 blocks before (and including) :startHeight are returned. |
| direct/v1/Mempool/v1/blocks-bulk/\{minHeight} /\{maxHeight} | 2000 | Returns details on the range of blocks between :minHeight and :maxHeight, inclusive, up to 10 blocks. If :maxHeight is not specified, it defaults to the current tip.To return data for more than 10 blocks, consider becoming an enterprise sponsor. |
| direct/v1/Mempool/v1/mining/pools/\{timePeriod} | 2000 | Returns a list of all known mining pools ordered by blocks found over the specified trailing :timePeriod.Leave :timePeriod unspecified to get all available data, or specify one of the following values: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y. |
| direct/v1/Mempool/v1/mining/pool/\{slug} | 2000 | Returns details about the mining pool specified by :slug. |
| direct/v1/Mempool/v1/mining/hashrate/pools /\{timePeriod} | 2000 | Returns average hashrates (and share of total hashrate) of mining pools active in the specified trailing :timePeriod, in descending order of hashrate.Leave :timePeriod unspecified to get all available data, or specify any of the following time periods: 1m, 3m, 6m, 1y, 2y, 3y. |
| direct/v1/Mempool/v1/mining/pool/\{slug}/hashrate | 2000 | Returns all known hashrate data for the mining pool specified by :slug. Hashrate values are weekly averages. |
| direct/v1/Mempool/v1/mining/pool/luxor/blocks /\{blockHeight} | 2000 | Returns past 10 blocks mined by the specified mining pool (:slug) before the specified :blockHeight. If no :blockHeight is specified, the mining pool's 10 most recent blocks are returned. |
| direct/v1/Mempool/v1/mining/hashrate /\{timePeriod} | 2000 | Returns network-wide hashrate and difficulty figures over the specified trailing :timePeriod:Current (real-time) hashrateCurrent (real-time) difficultyHistorical daily average hashratesHistorical difficultyValid values for :timePeriod are 1m, 3m, 6m, 1y, 2y, 3y. If no time interval is specified, all available data is returned.Be sure that INDEXING\_BLOCKS\_AMOUNT is set properly in your backend config so that enough blocks are indexed to properly serve your request. |
| direct/v1/Mempool/v1/mining /difficulty-adjustments/\{interval} | 2000 | Returns the record of difficulty adjustments over the specified trailing :interval:Block timestampBlock heightDifficultyDifficulty changeIf no time interval is specified, all available data is returned. |
| direct/v1/Mempool/v1/mining/reward-stats /\{blockCount} | 2000 | Returns block reward and total transactions confirmed for the past :blockCount blocks. |
| direct/v1/Mempool/v1/mining/blocks/fees /\{timePeriod} | 2000 | Returns average total fees for blocks in the specified :timePeriod, ordered oldest to newest. :timePeriod can be any of the following: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y.For 24h and 3d time periods, every block is included and fee amounts are exact (not averages). For the 1w time period, fees may be averages depending on how fast blocks were found around a particular timestamp. For other time periods, fees are averages. |
| direct/v1/Mempool/v1/mining/blocks/rewards /\{timePeriod} | 2000 | Returns average block rewards for blocks in the specified :timePeriod, ordered oldest to newest. :timePeriod can be any of the following: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y.For 24h and 3d time periods, every block is included and block rewards are exact (not averages). For the 1w time period, block rewards may be averages depending on how fast blocks were found around a particular timestamp. For other time periods, block rewards are averages. |
| direct/v1/Mempool/v1/mining/blocks/fee-rates /\{timePeriod} | 2000 | Returns average feerate percentiles for blocks in the specified :timePeriod, ordered oldest to newest. :timePeriod can be any of the following: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y.For 24h and 3d time periods, every block is included and percentiles are exact (not averages). For the 1w time period, percentiles may be averages depending on how fast blocks were found around a particular timestamp. For other time periods, percentiles are averages. |
| direct/v1/Mempool/v1/mining/blocks/sizes-weights /\{timePeriod} | 2000 | Returns average size (bytes) and average weight (weight units) for blocks in the specified :timePeriod, ordered oldest to newest. :timePeriod can be any of the following: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y.For 24h and 3d time periods, every block is included and figures are exact (not averages). For the 1w time period, figures may be averages depending on how fast blocks were found around a particular timestamp. For other time periods, figures are averages. |
| direct/v1/Mempool/v1/mining/blocks/predictions /\{timePeriod} | 2000 | Returns average block health in the specified :timePeriod, ordered oldest to newest. :timePeriod can be any of the following: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y.For 24h and 3d time periods, every block is included and figures are exact (not averages). For the 1w time period, figures may be averages depending on how fast blocks were found around a particular timestamp. For other time periods, figures are averages. |
| direct/v1/Mempool/v1/mining/blocks/audit/score /\{blockHash} | 2000 | Returns the block audit score for the specified :blockHash. Available fields: hash, matchRate, expectedFees, and expectedWeight. |
| direct/v1/Mempool/v1/mining/blocks/audit/scores /\{startHeight} | 2000 | Returns blocks audit score for the past 16 blocks. If :startHeight is specified, the past 15 blocks before (and including) :startHeight are returned. Available fields: hash, matchRate, expectedFees, and expectedWeight. |
| direct/v1/Mempool/v1/block/\{blockHash} /audit-summary | 2000 | Returns the block audit summary for the specified :blockHash. Available fields: height, id, timestamp, template, missingTxs, addedTxs, freshTxs, sigopTxs, fullrbfTxs, acceleratedTxs, matchRate, expectedFees, and expectedWeight. |
| direct/v1/Mempool/v1/fees/mempool-blocks | 2000 | Returns current mempool as projected blocks. |
| direct/v1/Mempool/v1/fees/recommended | 2000 | Returns our currently suggested fees for new transactions. |
| direct/v1/Mempool/mempool | 2000 | Returns current mempool backlog statistics. |
| direct/v1/Mempool/mempool/txids | 2000 | Get the full list of txids in the mempool as an array. The order of the txids is arbitrary and does not match bitcoind. |
| direct/v1/Mempool/mempool/recent | 2000 | Get a list of the last 10 transactions to enter the mempool. Each transaction object contains simplified overview data, with the following fields: txid, fee, vsize, and value. |
| direct/v1/Mempool/v1/replacements | 2000 | Returns the list of mempool transactions that are part of a RBF chain. |
| direct/v1/Mempool/v1/fullrbf/replacements | 2000 | Returns the list of mempool transactions that are part of a Full-RBF chain. |
| direct/v1/Mempool/v1/cpfp | 2000 | Returns the ancestors and the best descendant fees for a transaction. |
| direct/v1/Mempool/tx/\{txId} | 2000 | Returns details about a transaction. Available fields: txid, version, locktime, size, weight, fee, vin, vout, and status. |
| direct/v1/Mempool/tx/\{txId}/hex | 2000 | Returns a transaction serialized as hex. |
| direct/v1/Mempool/tx/\{txId}/merkleblock-proof | 2000 | Returns a merkle inclusion proof for the transaction using bitcoind's merkleblock format. |
| direct/v1/Mempool/tx/\{txId}/merkle-proof | 2000 | Returns a merkle inclusion proof for the transaction using Electrum's blockchain.transaction.get\_merkle format. |
| direct/v1/Mempool/tx/\{txId}/outspend/\{vout} | 2000 | Returns the spending status of a transaction output. Available fields: spent (boolean), txid (optional), vin (optional), and status (optional, the status of the spending tx). |
| direct/v1/Mempool/tx/\{txId}/outspends | 2000 | Returns the spending status of all transaction outputs. |
| direct/v1/Mempool/tx/\{txId}/raw | 2000 | Returns a transaction as binary data. |
| direct/v1/Mempool/v1/tx/\{txId}/rbf | 2000 | Returns the RBF tree timeline of a transaction. |
| direct/v1/Mempool/tx/\{txId}/status | 2000 | Returns the confirmation status of a transaction. Available fields: confirmed (boolean), block\_height (optional), and block\_hash (optional). |
| direct/v1/Mempool/v1/transaction-times | 2000 | Returns the timestamps when a list of unconfirmed transactions was initially observed in the mempool. If a transaction is not found in the mempool or has been mined, the timestamp will be 0. |
| direct/v1/Mempool/v1/lightning/statistics /\{interval} | 2000 | Returns network-wide stats such as total number of channels and nodes, total capacity, and average/median fee figures.Pass one of the following for :interval: latest, 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y. |
| direct/v1/Mempool/v1/lightning/search | 2000 | Returns Lightning nodes and channels that match a full-text, case-insensitive search :query across node aliases, node pubkeys, channel IDs, and short channel IDs. |
| direct/v1/Mempool/v1/lightning/nodes/country /\{country} | 2000 | Returns a list of Lightning nodes running on clearnet in the requested :country, where :country is an ISO Alpha-2 country code. |
| direct/v1/Mempool/v1/lightning/nodes/countries | 2000 | Returns aggregate capacity and number of clearnet nodes per country. Capacity figures are in satoshis. |
| direct/v1/Mempool/v1/lightning/nodes/isp/\{isp} | 2000 | Returns a list of nodes hosted by a specified :isp, where :isp is an ISP's ASN. |
| direct/v1/Mempool/v1/lightning/nodes/isp-ranking | 2000 | Returns aggregate capacity, number of nodes, and number of channels per ISP. Capacity figures are in satoshis. |
| direct/v1/Mempool/v1/lightning/nodes/rankings | 2000 | Returns two lists of the top 100 nodes: one ordered by liquidity (aggregate channel capacity) and the other ordered by connectivity (number of open channels). |
| direct/v1/Mempool/v1/lightning/nodes/rankings /liquidity | 2000 | Returns a list of the top 100 nodes by liquidity (aggregate channel capacity). |
| direct/v1/Mempool/v1/lightning/nodes/rankings /connectivity | 2000 | Returns a list of the top 100 nodes by connectivity (number of open channels). |
| direct/v1/Mempool/v1/lightning/nodes/rankings /age | 2000 | Returns a list of the top 100 oldest nodes. |
| direct/v1/Mempool/v1/lightning/nodes/\{pubKey} | 2000 | Returns details about a node with the given :pubKey. |
| direct/v1/Mempool/v1/lightning/nodes/\{pubKey} /statistics | 2000 | Returns historical stats for a node with the given :pubKey. |
| direct/v1/Mempool/v1/lightning/channels /\{channelId} | 2000 | Returns info about a Lightning channel with the given :channelId. |
| direct/v1/Mempool/v1/lightning/channels/txids | 2000 | Returns channels that correspond to the given :txid (multiple transaction IDs can be specified). |
| direct/v1/Mempool/v1/lightning/channels | 2000 | Returns a list of a node's channels given its :pubKey. Ten channels are returned at a time. Use :index for paging. :channelStatus can be open, active, or closed. |
| direct/v1/Mempool/v1/lightning/channels-geo | 2000 | Returns a list of channels with corresponding node geodata. |
| direct/v1/Mempool/v1/lightning/channels-geo /\{pubKey} | 2000 | Returns a list of channels with corresponding geodata for a node with the given :pubKey. |
| direct/v1/Mempool/v1/services/accelerator /accelerations | 2000 | Returns all transactions currently being accelerated. |
| direct/v1/Mempool/v1/services/accelerator /accelerations/history | 2000 | Returns all past accelerated transactions. Filters can be applied: status: all, requested, accelerating, mined, completed, failed timeframe: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y, 4y, all minedByPoolUniqueId: any id from pools-v2.json blockHash: a block hash blockHeight: a block height page: the requested page number if using pagination (min: 1) pageLength: the page lenght if using pagination (min: 1, max: 50) from: unix timestamp (overrides timeframe) to: unix timestamp (overrides timeframe) |
| direct/v1/Mempool/v1/services/accelerator /top-up-history | 2000 | Returns a list of top ups the user has made as prepayment for the accelerator service. |
| direct/v1/Mempool/v1/services/accelerator /balance | 2000 | Returns the user's currently available balance, currently locked funds, and total fees paid so far. |
| direct/v1/Mempool/v1/services/accelerator /history | 2000 | Returns the user's past acceleration requests.Pass one of the following for :status (required): all, requested, accelerating, mined, completed, failed.Pass true in :details to get a detailed history of the acceleration request. |
### POST
| Path | Est. CU | Description |
| ----------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| direct/v1/Mempool/tx | 2000 | Broadcast a raw transaction to the network. The transaction should be provided as hex in the request body. The txid will be returned on success. |
| direct/v1/Mempool/v1/services/accelerator /estimate | 2000 | Returns estimated costs to accelerate a transaction. Optionally set the X-Mempool-Auth header to get customized estimation. |
| direct/v1/Mempool/v1/services/payments/bitcoin | 2000 | Request a LN invoice to accelerate a transaction. |
| direct/v1/Mempool/v1/services/accelerator /accelerate | 2000 | Sends a request to accelerate a transaction. |
| direct/v1/Mempool/v1/services/accelerator/cancel | 2000 | Sends a request to cancel an acceleration in the accelerating status.You can retreive eligible acceleration id using the history endpoint GET /api/v1/services/accelerator/history?status=accelerating. |
# Moralis direct API on Uniblock: wallets, tokens, NFTs, DeFi
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-moralis
Query Moralis's 111 direct API endpoints on Uniblock for wallet activity, token pricing and transfers, NFT metadata, DeFi analytics, and market data.
# Moralis: Direct API Endpoints
Moralis provides 111 unique direct API endpoints across the following categories:
* DeFi (2 endpoints)
* Market Data (26 endpoints)
* NFT (29 endpoints)
* Other (7 endpoints)
* Scan (2 endpoints)
* SocialFi (4 endpoints)
* Token (48 endpoints)
* Transaction (10 endpoints)
* Wallets (30 endpoints)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
> **Learn more:** [Moralis Documentation](https://docs.moralis.com/web3-data-api)
## Prefix and Example
**Prefix:** No prefix is required for Moralis, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/Moralis + /[Moralis_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/Moralis/contracts-review \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## DeFi
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------- | ------: | ------------------------ |
| [direct/v1/Moralis/info/endpointWeights](https://docs.moralis.com/web3-data-api/evm/reference/endpoint-weights) | 20 | Get weights of endpoints |
| [direct/v1/Moralis/contracts-review](https://docs.moralis.com/web3-data-api/evm/reference) | 20 | Review contracts |
## Market Data
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------- |
| [direct/v1/Moralis/volume/categories](https://docs.moralis.com/data-api/universal/global/endpoints/trading-stats-category) | 1125 | Get trading volume and buyer/seller metrics by token category |
| [direct/v1/Moralis/volume/timeseries/\{categoryId}](https://docs.moralis.com/data-api/universal/global/endpoints/trading-stats-category-timeseries) | 100 | Get buy/sell volume, liquidity, and FDV timeseries for a token category |
| [direct/v1/Moralis/volume/chains](https://docs.moralis.com/data-api/universal/global/endpoints/trading-stats-chain) | 1125 | Get trading volume and market metrics by chain |
| [direct/v1/Moralis/volume/timeseries](https://docs.moralis.com/data-api/universal/global/endpoints/trading-stats-timeseries) | 1125 | Get chain trading volume, liquidity, and FDV timeseries |
| [direct/v1/Moralis/nft/\{address}/price](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-contract-sale-prices) | 225 | Get contract sale prices |
| [direct/v1/Moralis/erc20/\{address}/price](https://docs.moralis.com/web3-data-api/evm/reference/get-token-price) | 375 | Get ERC20 token price |
| [direct/v1/Moralis/nft/\{address}/lowestprice](https://docs.moralis.com/web3-data-api/evm/reference) | 300 | Get lowest price |
| [direct/v1/Moralis/erc20/prices](https://docs.moralis.com/web3-data-api/evm/reference/get-multiple-token-prices) | 750 | Get multiple token prices |
| [direct/v1/Moralis/nft/\{address}/\{token\_id}/price](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-sale-prices) | 225 | Get sale prices |
| [direct/v1/Moralis/solana/token/\{network}/pairs /\{address}/ohlcv](https://docs.moralis.com/web3-data-api/solana/reference/get-ohlcv-by-pair-address) | 1125 | Get candlestick data for a pair on Solana |
| [direct/v1/Moralis/solana/token/\{network}/pairs /\{pairAddress}/swaps](https://docs.moralis.com/web3-data-api/solana/reference/get-swaps-by-pair-address) | 375 | Get swaps for a specific pair address on Solana |
| [direct/v1/Moralis/solana/token/\{network}/pairs /\{pairAddress}/stats](https://docs.moralis.com/web3-data-api/solana/reference/get-token-pair-stats) | 375 | Get pair stats by address on Solana |
| [direct/v1/Moralis/solana/account/\{network} /\{address}/portfolio](https://docs.moralis.com/web3-data-api/solana/reference/get-sol-portfolio) | 75 | Get portfolio by wallet on Solana |
| [direct/v1/Moralis/solana/token/\{network}/pairs /\{address}/snipers](https://docs.moralis.com/web3-data-api/solana/reference/get-snipers-by-pair-address) | 1125 | Get snipers by pair address on Solana |
| [direct/v1/Moralis/solana/token/\{network} /\{address}/pairs](https://docs.moralis.com/web3-data-api/solana/reference/get-token-pairs-by-address) | 375 | Get token pairs by address on Solana |
| [direct/v1/Moralis/solana/token/\{network} /\{address}/pairs/stats](https://docs.moralis.com/web3-data-api/solana/reference/get-token-pair-stats) | 375 | Get token pair statistics by address on Solana |
| [direct/v1/Moralis/solana/token/\{network} /\{address}/price](https://docs.moralis.com/web3-data-api/solana/reference/get-sol-token-price) | 75 | Get token price on Solana |
| [direct/v1/Moralis/solana/account/\{network} /\{address}/tokens](https://docs.moralis.com/web3-data-api/solana/reference/get-spl) | 75 | Get token balance by wallet on Solana |
| [direct/v1/Moralis/solana/token/\{network} /\{tokenAddress}/swaps](https://docs.moralis.com/web3-data-api/solana/reference/get-swaps-by-token-address) | 525 | Get swaps for a specific token address on Solana |
| [direct/v1/Moralis/tokens/\{tokenAddress} /analytics](https://docs.moralis.com/data-api/universal/token/analytics/token-analytics) | 600 | Get analytics for a token |
| [direct/v1/Moralis/discovery/tokens/top-gainers](https://docs.moralis.com/data-api/universal/token/filtered-tokens) | 1875 | Get the top gaining tokens by price performance |
| [direct/v1/Moralis/discovery/tokens/top-losers](https://docs.moralis.com/data-api/universal/token/filtered-tokens) | 1875 | Get the top losing tokens by price performance |
| [direct/v1/Moralis/tokens/trending](https://docs.moralis.com/data-api/universal/token/trending-tokens) | 1125 | Get trending tokens |
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------ | ------: | ---------------------------------------------- |
| [direct/v1/Moralis/discovery/tokens](https://docs.moralis.com/data-api/universal/token/filtered-tokens) | 1875 | Filter and discover tokens by on-chain metrics |
| [direct/v1/Moralis/tokens/analytics](https://docs.moralis.com/data-api/universal/token/token-analytics) | 1125 | Get analytics for multiple tokens (batch) |
| [direct/v1/Moralis/tokens/analytics/timeseries](https://docs.moralis.com/data-api/universal/token/token-analytics) | 1500 | Get analytics timeseries for a token |
## NFT
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------- |
| [direct/v1/Moralis/\{address}/nft/collections](https://docs.moralis.com/web3-data-api/evm/reference/get-wallet-nft-collections) | 100 | Get collections by wallet |
| [direct/v1/Moralis/nft/\{address}/stats](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-collection-stats) | 375 | Get collection stats |
| [direct/v1/Moralis/nft/\{address}/metadata](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-contract-metadata) | 375 | Get contract metadata |
| [direct/v1/Moralis/nft/\{address}/price](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-contract-sale-prices) | 225 | Get contract sale prices |
| [direct/v1/Moralis/nft/\{address}/lowestprice](https://docs.moralis.com/web3-data-api/evm/reference) | 300 | Get lowest price |
| [direct/v1/Moralis/nft/getMultipleNFTs](https://docs.moralis.com/web3-data-api/evm/reference/get-multiple-nfts) | 1125 | Get multiple NFTs |
| [direct/v1/Moralis/nft/\{address}/\{token\_id}](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-metadata) | 150 | Get NFT metadata |
| [direct/v1/Moralis/nft/\{address}/owners](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-owners) | 375 | Get NFT owners |
| [direct/v1/Moralis/nft/\{address}](https://docs.moralis.com/web3-data-api/evm/reference/get-contract-nfts) | 375 | Get NFTs by contract |
| [direct/v1/Moralis/nft/\{address}/nfts-by-traits](https://docs.moralis.com/web3-data-api/evm/reference/get-nfts-by-traits) | 375 | Get NFTs by traits |
| [direct/v1/Moralis/\{address}/nft](https://docs.moralis.com/web3-data-api/evm/reference/get-wallet-nfts) | 375 | Get NFTs by wallet |
| [direct/v1/Moralis/nft/\{address}/trades](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-trades) | 300 | Get NFT trades |
| [direct/v1/Moralis/wallets/\{address}/nfts/trades](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-nft-trades-by-wallet) | 300 | Get trades by wallet |
| [direct/v1/Moralis/nft/\{address}/traits](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-traits-by-collection) | 375 | Get NFT traits by collection (single response, limited to 5,000 traits) |
| [direct/v1/Moralis/nft/\{address}/traits/paginate](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-traits-by-collection-paginate) | 100 | Get NFT traits by collection (paginated, no limit) |
| [direct/v1/Moralis/\{address}/nft/transfers](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-nft-transfers) | 375 | Get transfers by wallet |
| [direct/v1/Moralis/nft/\{address}/\{token\_id}/price](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-sale-prices) | 225 | Get sale prices |
| [direct/v1/Moralis/solana/nft/\{network}/\{address} /metadata](https://docs.moralis.com/web3-data-api/solana/reference/get-sol-nft-metadata) | 75 | Get NFT metadata on Solana |
| [direct/v1/Moralis/solana/account/\{network} /\{address}/nft](https://docs.moralis.com/web3-data-api/solana/reference) | 75 | Get NFTs by wallet on Solana |
| [direct/v1/Moralis/nft/\{address}/\{token\_id} /owners](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-token-id-owners) | 375 | Get token ID owners |
| [direct/v1/Moralis/nft/\{address}/\{token\_id}/stats](https://docs.moralis.com/web3-data-api/evm/reference) | 375 | Get token stats |
| [direct/v1/Moralis/nft/\{address}/\{token\_id} /trades](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-trades-by-token) | 300 | Get trades by token |
| [direct/v1/Moralis/block/\{block\_number\_or\_hash} /nft/transfers](https://docs.moralis.com/web3-data-api/evm/reference) | 150 | Get transfers by block |
| [direct/v1/Moralis/nft/\{address}/transfers](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-contract-transfers) | 375 | Get transfers by contract |
| [direct/v1/Moralis/nft/\{address}/\{token\_id} /transfers](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-transfers) | 150 | Get transfers by contract and token ID |
| [direct/v1/Moralis/nft/transfers](https://docs.moralis.com/web3-data-api/evm/reference/get-wallet-nft-transfers) | 375 | Get NFT transfers for a wallet |
| [direct/v1/Moralis/nft/\{address}/\{token\_id} /metadata/resync](https://docs.moralis.com/web3-data-api/evm/reference/resync-metadata) | 375 | Resync metadata |
| [direct/v1/Moralis/nft/\{address}/traits/resync](https://docs.moralis.com/web3-data-api/evm/reference/resync-nft-traits-by-collection) | 75 | Resync NFT traits by collection |
| [direct/v1/Moralis/nft/\{address}/sync](https://docs.moralis.com/web3-data-api/evm/reference/sync-nft-contract) | 375 | Sync NFT contract |
## Other
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------------- |
| [direct/v1/Moralis/nft/\{address}/floor-price](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-floor-price-by-contract) | 225 | Get floor price for a given contract. |
| [direct/v1/Moralis/nft/\{address}/\{token\_id} /floor-price](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-floor-price-by-token) | 225 | Get floor price for a given token. |
| [direct/v1/Moralis/nft/\{address}/floor-price /historical](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-historical-floor-price-by-contract) | 375 | Get historical floor price for a contract. |
| [direct/v1/Moralis/market-data/nfts /hottest-collections](https://docs.moralis.com/web3-data-api/evm/reference/get-top-nft-collections-by-trading-volume) | 1500 | Get the top NFT collections by trading volume |
| [direct/v1/Moralis/solana/token/\{network}/holders /\{address}/historical](https://docs.moralis.com/web3-data-api/solana/reference/get-historical-token-holders) | 100 | Get historical holder statistics for a specific Solana token address over a date range |
| [direct/v1/Moralis/solana/token/\{network}/holders /\{address}](https://docs.moralis.com/web3-data-api/solana/reference/get-token-holder-stats) | 225 | Get Solana token holder summary |
| [direct/v1/Moralis/market-data/nfts /top-collections](https://docs.moralis.com/web3-data-api/evm/reference/get-top-nft-collections-by-market-cap) | 1500 | Get the top NFT collections by market cap |
## Scan
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------- |
| [direct/v1/Moralis/tokens/\{tokenAddress}/score](https://docs.moralis.com/data-api/universal/token/score/token-score) | 750 | Get security and quality score for a token |
| [direct/v1/Moralis/tokens/\{tokenAddress}/score /historical](https://docs.moralis.com/data-api/universal/token/score/token-score-timeseries) | 1125 | Get historical security score timeseries for a token |
## SocialFi
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------- |
| [direct/v1/Moralis/entities/categories /\{categoryId}](https://docs.moralis.com/web3-data-api/evm/reference/entity-api/get-entities-by-category) | 375 | Get entities by category |
| [direct/v1/Moralis/entities/\{entityId}](https://docs.moralis.com/web3-data-api/evm/reference/entity-api/get-entity-by-id) | 375 | Get entity by ID |
| [direct/v1/Moralis/entities/categories](https://docs.moralis.com/web3-data-api/evm/reference/entity-api/get-entity-categories) | 75 | Get entity categories |
| [direct/v1/Moralis/entities/search](https://docs.moralis.com/web3-data-api/evm/reference/entity-api/search-entities) | 375 | Search for entities, addresses, and categories |
## Token
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------- |
| [direct/v1/Moralis/web3/version](https://docs.moralis.com/web3-data-api/evm/reference/web3-api-version) | 20 | Get API version |
| [direct/v1/Moralis/wallets/balances](https://docs.moralis.com/web3-data-api/evm/reference/get-native-balances-for-addresses) | 75 | Get native balance for multiple wallets |
| [direct/v1/Moralis/dateToBlock](https://docs.moralis.com/web3-data-api/evm/reference/get-date-to-block) | 100 | Get block by date |
| [direct/v1/Moralis/block/\{block\_number\_or\_hash}](https://docs.moralis.com/web3-data-api/evm/reference/get-block) | 750 | Get block by hash |
| [direct/v1/Moralis/\{token0\_address} /\{token1\_address}/pairAddres](https://docs.moralis.com/web3-data-api/evm/reference/get-pair-address) | 100 | Get DEX token pair address |
| [direct/v1/Moralis/\{pair\_address}/reserves](https://docs.moralis.com/web3-data-api/evm/reference/get-pair-reserves) | 75 | Get DEX token pair reserves |
| [direct/v1/Moralis/erc20/\{address}/allowance](https://docs.moralis.com/web3-data-api/evm/reference) | 75 | Get ERC20 token allowance |
| [direct/v1/Moralis/wallets/\{address}/approvals](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-token-approvals) | 750 | Get ERC20 approvals by wallet |
| [direct/v1/Moralis/\{address}/erc20](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-token-balances-by-wallet) | 750 | Get ERC20 token balance by wallet |
| [direct/v1/Moralis/erc20/metadata](https://docs.moralis.com/web3-data-api/evm/reference/get-token-metadata) | 75 | Get ERC20 token metadata by contract |
| [direct/v1/Moralis/erc20/metadata/symbols](https://docs.moralis.com/web3-data-api/evm/reference/get-token-metadata-by-symbol) | 75 | Get ERC20 token metadata by symbols |
| [direct/v1/Moralis/erc20/\{address}/price](https://docs.moralis.com/web3-data-api/evm/reference/get-token-price) | 375 | Get ERC20 token price |
| [direct/v1/Moralis/erc20/\{token\_address}/owners](https://docs.moralis.com/web3-data-api/evm/reference) | 375 | Get ERC20 token owners |
| [direct/v1/Moralis/erc20/\{address}/stats](https://docs.moralis.com/web3-data-api/evm/reference/get-token-stats) | 375 | Get ERC20 token stats |
| [direct/v1/Moralis/erc20/\{address}/transfers](https://docs.moralis.com/web3-data-api/evm/reference/get-token-transfers) | 375 | Get ERC20 token transfers by contract |
| [direct/v1/Moralis/\{address}/erc20/transfers](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-token-transfers) | 375 | Get ERC20 token transfers by wallet |
| [direct/v1/Moralis/erc20/prices](https://docs.moralis.com/web3-data-api/evm/reference/get-multiple-token-prices) | 750 | Get multiple token prices |
| [direct/v1/Moralis/\{address}/balance](https://docs.moralis.com/web3-data-api/evm/reference/get-native-balance) | 75 | Get native balance by wallet |
| [direct/v1/Moralis/nft/\{address}/\{token\_id}](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-metadata) | 150 | Get NFT metadata |
| [direct/v1/Moralis/nft/\{address}/\{token\_id}/price](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-sale-prices) | 225 | Get sale prices |
| [direct/v1/Moralis/solana/account/\{network} /\{address}/balance](https://docs.moralis.com/web3-data-api/solana/reference/sol-balance) | 75 | Get native balance by wallet on Solana |
| [direct/v1/Moralis/solana/token/\{network}/pairs /\{address}/ohlcv](https://docs.moralis.com/web3-data-api/solana/reference/get-ohlcv-by-pair-address) | 1125 | Get candlestick data for a pair on Solana |
| [direct/v1/Moralis/solana/token/\{network}/pairs /\{pairAddress}/swaps](https://docs.moralis.com/web3-data-api/solana/reference/get-swaps-by-pair-address) | 375 | Get swaps for a specific pair address on Solana |
| [direct/v1/Moralis/solana/token/\{network}/pairs /\{pairAddress}/stats](https://docs.moralis.com/web3-data-api/solana/reference/get-token-pair-stats) | 375 | Get pair stats by address on Solana |
| [direct/v1/Moralis/solana/token/\{network}/pairs /\{address}/snipers](https://docs.moralis.com/web3-data-api/solana/reference/get-snipers-by-pair-address) | 1125 | Get snipers by pair address on Solana |
| [direct/v1/Moralis/solana/token/\{network} /\{address}/metadata](https://docs.moralis.com/web3-data-api/solana/reference/get-token-metadata) | 75 | Get token metadata on Solana |
| [direct/v1/Moralis/solana/token/\{network} /\{address}/pairs](https://docs.moralis.com/web3-data-api/solana/reference/get-token-pairs-by-address) | 375 | Get token pairs by address on Solana |
| [direct/v1/Moralis/solana/token/\{network} /\{address}/pairs/stats](https://docs.moralis.com/web3-data-api/solana/reference/get-token-pair-stats) | 375 | Get token pair statistics by address on Solana |
| [direct/v1/Moralis/solana/token/\{network} /\{address}/price](https://docs.moralis.com/web3-data-api/solana/reference/get-sol-token-price) | 75 | Get token price on Solana |
| [direct/v1/Moralis/solana/account/\{network} /\{address}/tokens](https://docs.moralis.com/web3-data-api/solana/reference/get-spl) | 75 | Get token balance by wallet on Solana |
| [direct/v1/Moralis/solana/token/\{network} /\{tokenAddress}/swaps](https://docs.moralis.com/web3-data-api/solana/reference/get-swaps-by-token-address) | 525 | Get swaps for a specific token address on Solana |
| [direct/v1/Moralis/tokens/\{tokenAddress} /analytics](https://docs.moralis.com/data-api/universal/token/analytics/token-analytics) | 600 | Get analytics for a token |
| [direct/v1/Moralis/nft/\{address}/\{token\_id} /owners](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-token-id-owners) | 375 | Get token ID owners |
| [direct/v1/Moralis/wallets/\{address}/tokens](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-token-balances-price) | 750 | Get Native & ERC20 token balances & prices by wallet |
| [direct/v1/Moralis/tokens/\{tokenAddress}/score](https://docs.moralis.com/data-api/universal/token/score/token-score) | 750 | Get security and quality score for a token |
| [direct/v1/Moralis/tokens/\{tokenAddress}/score /historical](https://docs.moralis.com/data-api/universal/token/score/token-score-timeseries) | 1125 | Get historical security score timeseries for a token |
| [direct/v1/Moralis/nft/\{address}/\{token\_id}/stats](https://docs.moralis.com/web3-data-api/evm/reference) | 375 | Get token stats |
| [direct/v1/Moralis/erc20/\{address}/top-gainers](https://docs.moralis.com/web3-data-api/evm/reference/get-top-profitable-wallet-per-token) | 375 | Get Top Profitable Wallets by Token |
| [direct/v1/Moralis/discovery/tokens/top-gainers](https://docs.moralis.com/data-api/universal/token/filtered-tokens) | 1875 | Get the top gaining tokens by price performance |
| [direct/v1/Moralis/discovery/tokens/top-losers](https://docs.moralis.com/data-api/universal/token/filtered-tokens) | 1875 | Get the top losing tokens by price performance |
| [direct/v1/Moralis/nft/\{address}/\{token\_id} /trades](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-trades-by-token) | 300 | Get trades by token |
| [direct/v1/Moralis/nft/\{address}/\{token\_id} /transfers](https://docs.moralis.com/web3-data-api/evm/reference/get-nft-transfers) | 150 | Get transfers by contract and token ID |
| [direct/v1/Moralis/tokens/trending](https://docs.moralis.com/data-api/universal/token/trending-tokens) | 1125 | Get trending tokens |
| [direct/v1/Moralis/nft/\{address}/\{token\_id} /metadata/resync](https://docs.moralis.com/web3-data-api/evm/reference/resync-metadata) | 375 | Resync metadata |
| [direct/v1/Moralis/tokens/search](https://docs.moralis.com/data-api/universal/token/search/token-search) | 1125 | Search for tokens by name, symbol, or address |
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------ | ------: | ---------------------------------------------- |
| [direct/v1/Moralis/discovery/tokens](https://docs.moralis.com/data-api/universal/token/filtered-tokens) | 1875 | Filter and discover tokens by on-chain metrics |
| [direct/v1/Moralis/tokens/analytics](https://docs.moralis.com/data-api/universal/token/token-analytics) | 1125 | Get analytics for multiple tokens (batch) |
| [direct/v1/Moralis/tokens/analytics/timeseries](https://docs.moralis.com/data-api/universal/token/token-analytics) | 1500 | Get analytics timeseries for a token |
## Transaction
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------- |
| [direct/v1/Moralis/block/\{block\_number\_or\_hash}](https://docs.moralis.com/web3-data-api/evm/reference/get-block) | 750 | Get block by hash |
| [direct/v1/Moralis/block/\{block\_number\_or\_hash} /stats](https://docs.moralis.com/web3-data-api/evm/reference) | 375 | Get block stats |
| [direct/v1/Moralis/transaction/\{transaction\_hash} /verbose](https://docs.moralis.com/web3-data-api/evm/reference/get-decoded-transaction) | 150 | Get decoded transaction by hash |
| [direct/v1/Moralis/\{address}/events](https://docs.moralis.com/web3-data-api/evm/reference) | 150 | Get events by contract |
| [direct/v1/Moralis/transaction/\{transaction\_hash} /internal-transactions](https://docs.moralis.com/web3-data-api/evm/reference) | 150 | Get internal transactions by transaction hash |
| [direct/v1/Moralis/latestBlockNumber/\{chain}](https://docs.moralis.com/web3-data-api/evm/reference/get-latest-block-number) | 75 | Get latest block number. |
| [direct/v1/Moralis/\{address}/logs](https://docs.moralis.com/web3-data-api/evm/reference) | 150 | Get logs by contract |
| [direct/v1/Moralis/solana/account/\{network} /\{walletAddress}/swaps](https://docs.moralis.com/web3-data-api/solana/reference/get-wallet-swap-txs) | 375 | Get swap transactions by wallet on Solana |
| [direct/v1/Moralis/transaction/\{transaction\_hash}](https://docs.moralis.com/web3-data-api/evm/reference/get-transaction) | 75 | Get transaction by hash |
| [direct/v1/Moralis/wallets/\{address}/history](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-history) | 1125 | Get full wallet history |
## Wallets
### GET
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------- |
| [direct/v1/Moralis/resolve/\{address}/reverse](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/resolve-address) | 75 | ENS lookup by address. |
| [direct/v1/Moralis/resolve/ens/\{domain}](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/resolve-ens-domain) | 75 | ENS Lookup by Domain |
| [direct/v1/Moralis/wallets/balances](https://docs.moralis.com/web3-data-api/evm/reference/get-native-balances-for-addresses) | 75 | Get native balance for multiple wallets |
| [direct/v1/Moralis/wallets/\{address}/chains](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-chain-activity-by-wallet) | 375 | Get chain activity by wallet |
| [direct/v1/Moralis/\{address}/verbose](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-decoded-transactions-by-wallet) | 375 | Get decoded transactions by wallet |
| [direct/v1/Moralis/wallets/\{address}/defi /positions](https://docs.moralis.com/web3-data-api/evm/reference/get-defi-positions-summary) | 375 | Get DeFi positions by wallet |
| [direct/v1/Moralis/wallets/\{address}/defi/summary](https://docs.moralis.com/web3-data-api/evm/reference/get-defi-summary) | 375 | Get DeFi protocols by wallet |
| [direct/v1/Moralis/wallets/\{address}/defi /\{protocol}/positions](https://docs.moralis.com/web3-data-api/evm/reference/get-defi-positions-summary) | 100 | Get detailed DeFi positions by wallet and protocol |
| [direct/v1/Moralis/wallets/\{address}/approvals](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-token-approvals) | 750 | Get ERC20 approvals by wallet |
| [direct/v1/Moralis/\{address}/erc20](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-token-balances-by-wallet) | 750 | Get ERC20 token balance by wallet |
| [direct/v1/Moralis/\{address}/erc20/transfers](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-token-transfers) | 375 | Get ERC20 token transfers by wallet |
| [direct/v1/Moralis/\{address}/events](https://docs.moralis.com/web3-data-api/evm/reference) | 150 | Get events by contract |
| [direct/v1/Moralis/\{address}/logs](https://docs.moralis.com/web3-data-api/evm/reference) | 150 | Get logs by contract |
| [direct/v1/Moralis/\{address}/balance](https://docs.moralis.com/web3-data-api/evm/reference/get-native-balance) | 75 | Get native balance by wallet |
| [direct/v1/Moralis/\{address}](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-transactions-by-wallet) | 225 | Get native transactions by wallet |
| [direct/v1/Moralis/wallets/\{address}/nfts/trades](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-nft-trades-by-wallet) | 300 | Get trades by wallet |
| [direct/v1/Moralis/\{address}/nft/transfers](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-nft-transfers) | 375 | Get transfers by wallet |
| [direct/v1/Moralis/solana/account/\{network} /\{address}/balance](https://docs.moralis.com/web3-data-api/solana/reference/sol-balance) | 75 | Get native balance by wallet on Solana |
| [direct/v1/Moralis/solana/account/\{network} /\{address}/nft](https://docs.moralis.com/web3-data-api/solana/reference) | 75 | Get NFTs by wallet on Solana |
| [direct/v1/Moralis/solana/account/\{network} /\{address}/portfolio](https://docs.moralis.com/web3-data-api/solana/reference/get-sol-portfolio) | 75 | Get portfolio by wallet on Solana |
| [direct/v1/Moralis/solana/account/\{network} /\{walletAddress}/swaps](https://docs.moralis.com/web3-data-api/solana/reference/get-wallet-swap-txs) | 375 | Get swap transactions by wallet on Solana |
| [direct/v1/Moralis/solana/account/\{network} /\{address}/tokens](https://docs.moralis.com/web3-data-api/solana/reference/get-spl) | 75 | Get token balance by wallet on Solana |
| [direct/v1/Moralis/wallets/\{address}/tokens](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-token-balances-price) | 750 | Get Native & ERC20 token balances & prices by wallet |
| [direct/v1/Moralis/wallets/\{address}/history](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-history) | 1125 | Get full wallet history |
| [direct/v1/Moralis/wallets/\{address}/net-worth](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-net-worth) | 1875 | Get wallet net-worth |
| [direct/v1/Moralis/wallets/\{address} /profitability](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-profitability) | 375 | Get Wallet PnL Breakdown |
| [direct/v1/Moralis/wallets/\{address} /profitability/summary](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-profitability-summary) | 225 | Get Wallet PnL Summary |
| [direct/v1/Moralis/wallets/\{address}/stats](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/get-wallet-stats) | 375 | Get wallet stats |
| [direct/v1/Moralis/resolve/\{address}/domain](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/resolve-address) | 75 | Unstoppable Lookup by Address |
| [direct/v1/Moralis/resolve/\{domain}](https://docs.moralis.com/web3-data-api/evm/reference/wallet-api/resolve-domain) | 75 | Unstoppable Lookup by Domain |
# Polymarket direct API on Uniblock: prediction market data
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-polymarket
Query Polymarket's 59 direct API endpoints on Uniblock for prediction market metadata, order books, prices, trades, balances, and historical data.
# Polymarket: Direct API Endpoints
Polymarket provides 59 unique direct API endpoints across the following categories:
* Balance (4 endpoints)
* Historical (2 endpoints)
* Liquidity (1 endpoint)
* Market Data (18 endpoints)
* Metadata (11 endpoints)
* Other (1 endpoint)
* Prediction Markets (58 endpoints)
* Price (7 endpoints)
* Ramp (2 endpoints)
* SocialFi (5 endpoints)
* Trading (5 endpoints)
* Utility (3 endpoints)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
> **Learn more:** [Polymarket Documentation](https://docs.polymarket.com/api-reference)
## Prefix and Example
**Prefix:** No prefix is required for Polymarket, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/Polymarket + /[Polymarket_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/Polymarket/data/closed-positions \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## Balance
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------- |
| [direct/v1/Polymarket/data/closed-positions](https://docs.polymarket.com/api-reference/core/get-closed-positions-for-a-user) | 50 | Get closed positions for a user |
| [direct/v1/Polymarket/data/positions](https://docs.polymarket.com/api-reference/core/get-current-positions-for-a-user) | 50 | Get current positions for a user |
| [direct/v1/Polymarket/data/v1/market-positions](https://docs.polymarket.com/api-reference/core/get-positions-for-a-market) | 50 | Get positions for a market |
| [direct/v1/Polymarket/data/value](https://docs.polymarket.com/api-reference/core/get-total-value-of-a-users-positions) | 50 | Get total value of a user's positions |
## Historical
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------ |
| [direct/v1/Polymarket/clob/prices-history](https://docs.polymarket.com/api-reference/markets/get-prices-history) | 50 | Get prices history |
| [direct/v1/Polymarket/data/v1/builders/volume](https://docs.polymarket.com/api-reference/builders/get-daily-builder-volume-time-series) | 50 | Get daily builder volume time-series |
## Liquidity
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------ | ------: | -------------- |
| [direct/v1/Polymarket/clob/book](https://docs.polymarket.com/api-reference/market-data/get-order-book) | 50 | Get order book |
## Market Data
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | ------------------------------- |
| [direct/v1/Polymarket/clob/fee-rate](https://docs.polymarket.com/api-reference/market-data/get-fee-rate) | 50 | Get fee rate |
| [direct/v1/Polymarket/clob/fee-rate/\{token\_id}](https://docs.polymarket.com/api-reference/market-data/get-fee-rate-by-path-parameter) | 50 | Get fee rate by path parameter |
| [direct/v1/Polymarket/clob/sampling-markets](https://docs.polymarket.com/api-reference/markets/get-sampling-markets) | 50 | Get sampling markets |
| [direct/v1/Polymarket/clob /sampling-simplified-markets](https://docs.polymarket.com/api-reference/markets/get-sampling-simplified-markets) | 50 | Get sampling simplified markets |
| [direct/v1/Polymarket/clob/simplified-markets](https://docs.polymarket.com/api-reference/markets/get-simplified-markets) | 50 | Get simplified markets |
| [direct/v1/Polymarket/clob/tick-size](https://docs.polymarket.com/api-reference/market-data/get-tick-size) | 50 | Get tick size |
| [direct/v1/Polymarket/clob/tick-size/\{token\_id}](https://docs.polymarket.com/api-reference/market-data/get-tick-size-by-path-parameter) | 50 | Get tick size by path parameter |
| [direct/v1/Polymarket/data/live-volume](https://docs.polymarket.com/api-reference/misc/get-live-volume-for-an-event) | 50 | Get live volume for an event |
| [direct/v1/Polymarket/data/oi](https://docs.polymarket.com/api-reference/misc/get-open-interest) | 50 | Get open interest |
| [direct/v1/Polymarket/data/holders](https://docs.polymarket.com/api-reference/core/get-top-holders-for-markets) | 50 | Get top holders for markets |
| [direct/v1/Polymarket/gamma/events/\{id}](https://docs.polymarket.com/api-reference/events/get-event-by-id) | 50 | Get event by id |
| [direct/v1/Polymarket/gamma/events/slug/\{slug}](https://docs.polymarket.com/api-reference/events/get-event-by-slug) | 50 | Get event by slug |
| [direct/v1/Polymarket/gamma/events](https://docs.polymarket.com/api-reference/events/list-events) | 50 | List events |
| [direct/v1/Polymarket/gamma/markets/\{id}](https://docs.polymarket.com/api-reference/markets/get-market-by-id) | 50 | Get market by id |
| [direct/v1/Polymarket/gamma/markets/slug/\{slug}](https://docs.polymarket.com/api-reference/markets/get-market-by-slug) | 50 | Get market by slug |
| [direct/v1/Polymarket/gamma/markets](https://docs.polymarket.com/api-reference/markets/list-markets) | 50 | List markets |
| [direct/v1/Polymarket/gamma/sports](https://docs.polymarket.com/api-reference/sports/get-sports-metadata-information) | 50 | Get sports metadata information |
| [direct/v1/Polymarket/gamma/teams](https://docs.polymarket.com/api-reference/sports/list-teams) | 50 | List teams |
## Metadata
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------ |
| [direct/v1/Polymarket/gamma/events/\{id}/tags](https://docs.polymarket.com/api-reference/events/get-event-tags) | 50 | Get event tags |
| [direct/v1/Polymarket/gamma/markets/\{id}/tags](https://docs.polymarket.com/api-reference/markets/get-market-tags-by-id) | 50 | Get market tags by id |
| [direct/v1/Polymarket/gamma/tags/\{id} /related-tags](https://docs.polymarket.com/api-reference/tags/get-related-tags-relationships-by-tag-id) | 50 | Get related tags (relationships) by tag id |
| [direct/v1/Polymarket/gamma/series](https://docs.polymarket.com/api-reference/series/list-series) | 50 | List series |
| [direct/v1/Polymarket/gamma/series/\{id}](https://docs.polymarket.com/api-reference/series/get-series-by-id) | 50 | Get series by id |
| [direct/v1/Polymarket/gamma/sports/market-types](https://docs.polymarket.com/api-reference/sports/get-valid-sports-market-types) | 50 | Get valid sports market types |
| [direct/v1/Polymarket/gamma/tags/\{id}](https://docs.polymarket.com/api-reference/tags/get-tag-by-id) | 50 | Get tag by id |
| [direct/v1/Polymarket/gamma/tags/slug/\{slug}](https://docs.polymarket.com/api-reference/tags/get-tag-by-slug) | 50 | Get tag by slug |
| [direct/v1/Polymarket/gamma/tags](https://docs.polymarket.com/api-reference/tags/list-tags) | 50 | List tags |
| [direct/v1/Polymarket/gamma/tags/\{id} /related-tags/tags](https://docs.polymarket.com/api-reference/tags/get-tags-related-to-a-tag-id) | 50 | Get tags related to a tag id |
| [direct/v1/Polymarket/gamma/tags/slug/\{slug} /related-tags/tags](https://docs.polymarket.com/api-reference/tags/get-tags-related-to-a-tag-slug) | 50 | Get tags related to a tag slug |
## Other
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | -------------------------------------------- |
| [direct/v1/Polymarket/gamma/tags/slug/\{slug} /related-tags](https://docs.polymarket.com/api-reference/tags/get-related-tags-relationships-by-tag-slug) | 50 | Get related tags (relationships) by tag slug |
## Prediction Markets
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------- |
| [direct/v1/Polymarket/bridge/supported-assets](https://docs.polymarket.com/api-reference/bridge/get-supported-assets) | 50 | Get supported assets |
| [direct/v1/Polymarket/bridge/status/\{address}](https://docs.polymarket.com/api-reference/bridge/get-transaction-status) | 50 | Get transaction status |
| [direct/v1/Polymarket/clob/book](https://docs.polymarket.com/api-reference/market-data/get-order-book) | 50 | Get order book |
| [direct/v1/Polymarket/clob/fee-rate](https://docs.polymarket.com/api-reference/market-data/get-fee-rate) | 50 | Get fee rate |
| [direct/v1/Polymarket/clob/fee-rate/\{token\_id}](https://docs.polymarket.com/api-reference/market-data/get-fee-rate-by-path-parameter) | 50 | Get fee rate by path parameter |
| [direct/v1/Polymarket/clob/last-trade-price](https://docs.polymarket.com/api-reference/market-data/get-last-trade-price) | 50 | Get last trade price |
| [direct/v1/Polymarket/clob/last-trades-prices](https://docs.polymarket.com/api-reference/market-data/get-last-trade-prices-query-parameters) | 50 | Get last trade prices (query parameters) |
| [direct/v1/Polymarket/clob/midpoint](https://docs.polymarket.com/api-reference/data/get-midpoint-price) | 50 | Get midpoint price |
| [direct/v1/Polymarket/clob/midpoints](https://docs.polymarket.com/api-reference/market-data/get-midpoint-prices-query-parameters) | 50 | Get midpoint prices (query parameters) |
| [direct/v1/Polymarket/clob/price](https://docs.polymarket.com/api-reference/market-data/get-market-price) | 50 | Get market price |
| [direct/v1/Polymarket/clob/prices](https://docs.polymarket.com/api-reference/market-data/get-market-prices-query-parameters) | 50 | Get market prices (query parameters) |
| [direct/v1/Polymarket/clob/prices-history](https://docs.polymarket.com/api-reference/markets/get-prices-history) | 50 | Get prices history |
| [direct/v1/Polymarket/clob/sampling-markets](https://docs.polymarket.com/api-reference/markets/get-sampling-markets) | 50 | Get sampling markets |
| [direct/v1/Polymarket/clob /sampling-simplified-markets](https://docs.polymarket.com/api-reference/markets/get-sampling-simplified-markets) | 50 | Get sampling simplified markets |
| [direct/v1/Polymarket/clob/simplified-markets](https://docs.polymarket.com/api-reference/markets/get-simplified-markets) | 50 | Get simplified markets |
| [direct/v1/Polymarket/clob/spread](https://docs.polymarket.com/api-reference/market-data/get-spread) | 50 | Get spread |
| [direct/v1/Polymarket/clob/tick-size](https://docs.polymarket.com/api-reference/market-data/get-tick-size) | 50 | Get tick size |
| [direct/v1/Polymarket/clob/tick-size/\{token\_id}](https://docs.polymarket.com/api-reference/market-data/get-tick-size-by-path-parameter) | 50 | Get tick size by path parameter |
| [direct/v1/Polymarket/clob/time](https://docs.polymarket.com/api-reference/data/get-server-time) | 50 | Get server time |
| [direct/v1/Polymarket/data/v1/accounting/snapshot](https://docs.polymarket.com/api-reference/misc/download-an-accounting-snapshot-zip-of-csvs) | 50 | Download an accounting snapshot (ZIP of CSVs) |
| [direct/v1/Polymarket/data/v1/builders /leaderboard](https://docs.polymarket.com/api-reference/builders/get-aggregated-builder-leaderboard) | 50 | Get aggregated builder leaderboard |
| [direct/v1/Polymarket/data/v1/builders/volume](https://docs.polymarket.com/api-reference/builders/get-daily-builder-volume-time-series) | 50 | Get daily builder volume time-series |
| [direct/v1/Polymarket/data/closed-positions](https://docs.polymarket.com/api-reference/core/get-closed-positions-for-a-user) | 50 | Get closed positions for a user |
| [direct/v1/Polymarket/data/positions](https://docs.polymarket.com/api-reference/core/get-current-positions-for-a-user) | 50 | Get current positions for a user |
| [direct/v1/Polymarket/data/live-volume](https://docs.polymarket.com/api-reference/misc/get-live-volume-for-an-event) | 50 | Get live volume for an event |
| [direct/v1/Polymarket/data/v1/market-positions](https://docs.polymarket.com/api-reference/core/get-positions-for-a-market) | 50 | Get positions for a market |
| [direct/v1/Polymarket/data/oi](https://docs.polymarket.com/api-reference/misc/get-open-interest) | 50 | Get open interest |
| [direct/v1/Polymarket/data/value](https://docs.polymarket.com/api-reference/core/get-total-value-of-a-users-positions) | 50 | Get total value of a user's positions |
| [direct/v1/Polymarket/data/holders](https://docs.polymarket.com/api-reference/core/get-top-holders-for-markets) | 50 | Get top holders for markets |
| [direct/v1/Polymarket/data/traded](https://docs.polymarket.com/api-reference/misc/get-total-markets-a-user-has-traded) | 50 | Get total markets a user has traded |
| [direct/v1/Polymarket/data/v1/leaderboard](https://docs.polymarket.com/api-reference/core/get-trader-leaderboard-rankings) | 50 | Get trader leaderboard rankings |
| [direct/v1/Polymarket/data/trades](https://docs.polymarket.com/api-reference/core/get-trades-for-a-user-or-markets) | 50 | Get trades for a user or markets |
| [direct/v1/Polymarket/data/activity](https://docs.polymarket.com/api-reference/core/get-user-activity) | 50 | Get user activity |
| [direct/v1/Polymarket/gamma/comments/\{id}](https://docs.polymarket.com/api-reference/comments/get-comments-by-comment-id) | 50 | Get comments by comment id |
| [direct/v1/Polymarket/gamma/comments](https://docs.polymarket.com/api-reference/comments/list-comments) | 50 | List comments |
| [direct/v1/Polymarket/gamma/comments/user\_address /\{user\_address}](https://docs.polymarket.com/api-reference/comments/get-comments-by-user-address) | 50 | Get comments by user address |
| [direct/v1/Polymarket/gamma/events/\{id}](https://docs.polymarket.com/api-reference/events/get-event-by-id) | 50 | Get event by id |
| [direct/v1/Polymarket/gamma/events/slug/\{slug}](https://docs.polymarket.com/api-reference/events/get-event-by-slug) | 50 | Get event by slug |
| [direct/v1/Polymarket/gamma/events](https://docs.polymarket.com/api-reference/events/list-events) | 50 | List events |
| [direct/v1/Polymarket/gamma/events/\{id}/tags](https://docs.polymarket.com/api-reference/events/get-event-tags) | 50 | Get event tags |
| [direct/v1/Polymarket/gamma/markets/\{id}](https://docs.polymarket.com/api-reference/markets/get-market-by-id) | 50 | Get market by id |
| [direct/v1/Polymarket/gamma/markets/slug/\{slug}](https://docs.polymarket.com/api-reference/markets/get-market-by-slug) | 50 | Get market by slug |
| [direct/v1/Polymarket/gamma/markets](https://docs.polymarket.com/api-reference/markets/list-markets) | 50 | List markets |
| [direct/v1/Polymarket/gamma/markets/\{id}/tags](https://docs.polymarket.com/api-reference/markets/get-market-tags-by-id) | 50 | Get market tags by id |
| [direct/v1/Polymarket/gamma/profile](https://docs.polymarket.com/api-reference/profiles/get-profile-positions-and-activity) | 50 | Get profile positions and activity |
| [direct/v1/Polymarket/gamma/public-profile](https://docs.polymarket.com/api-reference/profiles/get-public-profile-by-wallet-address) | 50 | Get public profile by wallet address |
| [direct/v1/Polymarket/gamma/tags/\{id} /related-tags](https://docs.polymarket.com/api-reference/tags/get-related-tags-relationships-by-tag-id) | 50 | Get related tags (relationships) by tag id |
| [direct/v1/Polymarket/gamma/search](https://docs.polymarket.com/api-reference/search/search-markets-events-and-profiles) | 50 | Search markets, events, and profiles |
| [direct/v1/Polymarket/gamma/series](https://docs.polymarket.com/api-reference/series/list-series) | 50 | List series |
| [direct/v1/Polymarket/gamma/series/\{id}](https://docs.polymarket.com/api-reference/series/get-series-by-id) | 50 | Get series by id |
| [direct/v1/Polymarket/gamma/sports](https://docs.polymarket.com/api-reference/sports/get-sports-metadata-information) | 50 | Get sports metadata information |
| [direct/v1/Polymarket/gamma/sports/market-types](https://docs.polymarket.com/api-reference/sports/get-valid-sports-market-types) | 50 | Get valid sports market types |
| [direct/v1/Polymarket/gamma/tags/\{id}](https://docs.polymarket.com/api-reference/tags/get-tag-by-id) | 50 | Get tag by id |
| [direct/v1/Polymarket/gamma/tags/slug/\{slug}](https://docs.polymarket.com/api-reference/tags/get-tag-by-slug) | 50 | Get tag by slug |
| [direct/v1/Polymarket/gamma/tags](https://docs.polymarket.com/api-reference/tags/list-tags) | 50 | List tags |
| [direct/v1/Polymarket/gamma/tags/\{id} /related-tags/tags](https://docs.polymarket.com/api-reference/tags/get-tags-related-to-a-tag-id) | 50 | Get tags related to a tag id |
| [direct/v1/Polymarket/gamma/tags/slug/\{slug} /related-tags/tags](https://docs.polymarket.com/api-reference/tags/get-tags-related-to-a-tag-slug) | 50 | Get tags related to a tag slug |
| [direct/v1/Polymarket/gamma/teams](https://docs.polymarket.com/api-reference/sports/list-teams) | 50 | List teams |
## Price
### GET
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------- |
| [direct/v1/Polymarket/clob/last-trade-price](https://docs.polymarket.com/api-reference/market-data/get-last-trade-price) | 50 | Get last trade price |
| [direct/v1/Polymarket/clob/last-trades-prices](https://docs.polymarket.com/api-reference/market-data/get-last-trade-prices-query-parameters) | 50 | Get last trade prices (query parameters) |
| [direct/v1/Polymarket/clob/midpoint](https://docs.polymarket.com/api-reference/data/get-midpoint-price) | 50 | Get midpoint price |
| [direct/v1/Polymarket/clob/midpoints](https://docs.polymarket.com/api-reference/market-data/get-midpoint-prices-query-parameters) | 50 | Get midpoint prices (query parameters) |
| [direct/v1/Polymarket/clob/price](https://docs.polymarket.com/api-reference/market-data/get-market-price) | 50 | Get market price |
| [direct/v1/Polymarket/clob/prices](https://docs.polymarket.com/api-reference/market-data/get-market-prices-query-parameters) | 50 | Get market prices (query parameters) |
| [direct/v1/Polymarket/clob/spread](https://docs.polymarket.com/api-reference/market-data/get-spread) | 50 | Get spread |
## Ramp
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------ | ------: | ---------------------- |
| [direct/v1/Polymarket/bridge/supported-assets](https://docs.polymarket.com/api-reference/bridge/get-supported-assets) | 50 | Get supported assets |
| [direct/v1/Polymarket/bridge/status/\{address}](https://docs.polymarket.com/api-reference/bridge/get-transaction-status) | 50 | Get transaction status |
## SocialFi
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------ |
| [direct/v1/Polymarket/gamma/comments/\{id}](https://docs.polymarket.com/api-reference/comments/get-comments-by-comment-id) | 50 | Get comments by comment id |
| [direct/v1/Polymarket/gamma/comments](https://docs.polymarket.com/api-reference/comments/list-comments) | 50 | List comments |
| [direct/v1/Polymarket/gamma/comments/user\_address /\{user\_address}](https://docs.polymarket.com/api-reference/comments/get-comments-by-user-address) | 50 | Get comments by user address |
| [direct/v1/Polymarket/gamma/profile](https://docs.polymarket.com/api-reference/profiles/get-profile-positions-and-activity) | 50 | Get profile positions and activity |
| [direct/v1/Polymarket/gamma/public-profile](https://docs.polymarket.com/api-reference/profiles/get-public-profile-by-wallet-address) | 50 | Get public profile by wallet address |
## Trading
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | ----------------------------------- |
| [direct/v1/Polymarket/data/v1/builders /leaderboard](https://docs.polymarket.com/api-reference/builders/get-aggregated-builder-leaderboard) | 50 | Get aggregated builder leaderboard |
| [direct/v1/Polymarket/data/traded](https://docs.polymarket.com/api-reference/misc/get-total-markets-a-user-has-traded) | 50 | Get total markets a user has traded |
| [direct/v1/Polymarket/data/v1/leaderboard](https://docs.polymarket.com/api-reference/core/get-trader-leaderboard-rankings) | 50 | Get trader leaderboard rankings |
| [direct/v1/Polymarket/data/trades](https://docs.polymarket.com/api-reference/core/get-trades-for-a-user-or-markets) | 50 | Get trades for a user or markets |
| [direct/v1/Polymarket/data/activity](https://docs.polymarket.com/api-reference/core/get-user-activity) | 50 | Get user activity |
## Utility
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------- |
| [direct/v1/Polymarket/clob/time](https://docs.polymarket.com/api-reference/data/get-server-time) | 50 | Get server time |
| [direct/v1/Polymarket/data/v1/accounting/snapshot](https://docs.polymarket.com/api-reference/misc/download-an-accounting-snapshot-zip-of-csvs) | 50 | Download an accounting snapshot (ZIP of CSVs) |
| [direct/v1/Polymarket/gamma/search](https://docs.polymarket.com/api-reference/search/search-markets-events-and-profiles) | 50 | Search markets, events, and profiles |
# QuickNode direct API on Uniblock: multi-chain add-on APIs
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-quicknode
Reach QuickNode's 117 direct API endpoints on Uniblock, covering QuickNode's marketplace add-ons for tokens, NFTs, DeFi, and analytics across many chains.
# QuickNode: Direct API Endpoints
QuickNode provides 117 unique direct API endpoints across the following categories:
* Other (117 endpoints)
> **Learn more:** [QuickNode Documentation](https://www.quicknode.com/docs/tron)
## Prefix and Example
**Prefix:** No prefix is required for QuickNode, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/QuickNode + /[QuickNode_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/QuickNode/tron/wallet/getassetissuelist \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## Other
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------------------------------------------------ |
| [direct/v1/QuickNode/tron/wallet /getassetissuelist](https://www.quicknode.com/docs/tron/wallet-getassetissuelist) | 200 | Obtain a list of all TRC10 tokens. |
| [direct/v1/QuickNode/tron/walletsolidity /getassetissuelist](https://www.quicknode.com/docs/tron/walletsolidity-getassetissuelist) | 200 | Return the list of all the TRC10 tokens (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet /getbandwidthprices](https://www.quicknode.com/docs/tron/wallet-getbandwidthprices) | 200 | Retrieve historical bandwidth unit price information. |
| [direct/v1/QuickNode/tron/wallet/getburntrx](https://www.quicknode.com/docs/tron/wallet-getburntrx) | 200 | Retrieve information about TRX burned in the network. |
| [direct/v1/QuickNode/tron/walletsolidity /getburntrx](https://www.quicknode.com/docs/tron/walletsolidity-getburntrx) | 200 | Query the amount of TRX burned due to on-chain transaction fees since No. 54 Committee Proposal took effect (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet /getcanwithdrawunfreezeamount](https://www.quicknode.com/docs/tron/wallet-getcanwithdrawunfreezeamount) | 200 | Retrieve the amount that can be withdrawn after unfreezing. |
| [direct/v1/QuickNode/tron/wallet/getdiversifier](https://developers.tron.network/reference/getdiversifier) | 200 | Generate a diversifier for creating shielded addresses in privacy transactions. |
| [direct/v1/QuickNode/tron/wallet/getenergyprices](https://www.quicknode.com/docs/tron/wallet-getenergyprices) | 200 | Retrieve historical energy unit price information. |
| [direct/v1/QuickNode/tron/wallet /getnewshieldedaddress](https://www.quicknode.com/docs/tron/wallet-getnewshieldedaddress) | 200 | Generate a new shielded address for privacy transactions. |
| [direct/v1/QuickNode/tron/wallet/getnowblock](https://www.quicknode.com/docs/tron/wallet-getnowblock) | 400 | Retrieve the latest block information. |
| [direct/v1/QuickNode/tron/walletsolidity /getnowblock](https://www.quicknode.com/docs/tron/walletsolidity-getnowblock) | 200 | Returns the latest block information. |
| [direct/v1/QuickNode/tron/wallet/getpendingsize](https://developers.tron.network/reference/getpendingsize) | 200 | Return the number of transactions in the pending pool. |
| [direct/v1/QuickNode/tron/wallet/getspendingkey](https://developers.tron.network/reference/getspendingkey) | 200 | Generate a spending key for shielded transactions. |
| [direct/v1/QuickNode/tron/wallet /gettransactionlistfrompending](https://www.quicknode.com/docs/tron/wallet-gettransactionlistfrompending) | 200 | Retrieve a list of transaction IDs currently in the pending pool. |
| [direct/v1/QuickNode/tron/wallet/listexchanges](https://www.quicknode.com/docs/tron/wallet-listexchanges) | 200 | List all exchange pairs available on the TRON network. |
| [direct/v1/QuickNode/tron/walletsolidity /listexchanges](https://www.quicknode.com/docs/tron/walletsolidity-listexchanges) | 200 | List all exchange pairs (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet/listproposals](https://www.quicknode.com/docs/tron/wallet-listproposals) | 200 | List all proposals currently available on the TRON network. |
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [direct/v1/QuickNode/tron/wallet/broadcasthex](https://www.quicknode.com/docs/tron/wallet-broadcasthex) | 200 | Broadcast a protobuf-encoded transaction hex string after signing. |
| [direct/v1/QuickNode/tron/wallet /broadcasttransaction](https://www.quicknode.com/docs/tron/wallet-broadcasttransaction) | 200 | Broadcast a signed transaction to the TRON network. |
| [direct/v1/QuickNode/tron/wallet/clearabi](https://www.quicknode.com/docs/tron/wallet-clearabi) | 200 | Clear the ABI information of a smart contract. |
| [direct/v1/QuickNode/tron/wallet/createaccount](https://www.quicknode.com/docs/tron/wallet-createaccount) | 200 | Activate a new account using an already activated account. |
| [direct/v1/QuickNode/tron/wallet/createassetissue](https://www.quicknode.com/docs/tron/wallet-createassetissue) | 200 | Issue a TRC10 token. |
| [direct/v1/QuickNode/tron/wallet/exchangecreate](https://www.quicknode.com/docs/tron/wallet-exchangecreate) | 200 | Create an exchange pair between two assets. |
| [direct/v1/QuickNode/tron/wallet /createshieldedcontractparameters](https://www.quicknode.com/docs/tron/wallet-createshieldedcontractparameters) | 200 | Generate the shielded contract parameters. |
| [direct/v1/QuickNode/tron/wallet /createspendauthsig](https://www.quicknode.com/docs/tron/wallet-createspendauthsig) | 200 | Generate a spend authorization signature for a transaction. |
| [direct/v1/QuickNode/tron/wallet /createtransaction](https://www.quicknode.com/docs/tron/wallet-createtransaction) | 200 | Create a TRX transfer transaction. If the recipient address does not exist, it will be created on the blockchain. |
| [direct/v1/QuickNode/tron/wallet/delegateresource](https://www.quicknode.com/docs/tron/wallet-delegateresource) | 200 | Delegate bandwidth or energy resources to other accounts. |
| [direct/v1/QuickNode/tron/wallet/deploycontract](https://www.quicknode.com/docs/tron/wallet-deploycontract) | 200 | Deploy a smart contract to the TRON network. |
| [direct/v1/QuickNode/tron/wallet/estimateenergy](https://www.quicknode.com/docs/tron/wallet-estimateenergy) | 200 | Estimate the energy required for the successful execution of smart contract transactions. |
| [direct/v1/QuickNode/tron/walletsolidity /estimateenergy](https://www.quicknode.com/docs/tron/walletsolidity-estimateenergy) | 200 | Estimate the energy required for the successful execution of smart contract transactions (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet /exchangetransaction](https://www.quicknode.com/docs/tron/wallet-exchangetransaction) | 200 | Exchange one asset for another within the TRON network. |
| [direct/v1/QuickNode/tron/wallet/freezebalance](https://www.quicknode.com/docs/tron/wallet-freezebalance) | 200 | Freeze TRX to obtain bandwidth or energy and gain voting rights. |
| [direct/v1/QuickNode/tron/wallet/freezebalancev2](https://www.quicknode.com/docs/tron/wallet-freezebalancev2) | 200 | In Stake 2.0, stake TRX to obtain bandwidth or energy and receive TRON Power (TP). |
| [direct/v1/QuickNode/tron/wallet/getaccount](https://www.quicknode.com/docs/tron/wallet-getaccount) | 200 | Retrieve account information, including TRX balance, TRC-10 balances, stake details, vote information, and permissions. |
| [direct/v1/QuickNode/tron/walletsolidity /getaccount](https://www.quicknode.com/docs/tron/walletsolidity-getaccount) | 200 | Retrieve information about an account, including TRX balance, TRC-10 balances, stake information, vote information, and permissions (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet /getaccountbalance](https://www.quicknode.com/docs/tron/wallet-getaccountbalance) | 200 | Fetch the account balance at a specific block. |
| [direct/v1/QuickNode/tron/wallet/getaccountnet](https://www.quicknode.com/docs/tron/wallet-getaccountnet) | 200 | Query bandwidth information for an account. |
| [direct/v1/QuickNode/tron/wallet /getaccountresource](https://www.quicknode.com/docs/tron/wallet-getaccountresource) | 200 | Retrieve resource information (bandwidth, energy, etc.) for an account. |
| [direct/v1/QuickNode/tron/wallet/getakfromask](https://www.quicknode.com/docs/tron/wallet-getakfromask) | 200 | Derive an account key (AK) from an account signature key (ASK). |
| [direct/v1/QuickNode/tron/wallet /getassetissuebyaccount](https://www.quicknode.com/docs/tron/wallet-getassetissuebyaccount) | 200 | Retrieve TRC10 token information issued by a specific account. |
| [direct/v1/QuickNode/tron/walletsolidity /getassetissuebyid](https://www.quicknode.com/docs/tron/walletsolidity-getassetissuebyid) | 200 | Return a token by token ID. Returns the token object, which contains the token name (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet /getassetissuebyid](https://www.quicknode.com/docs/tron/wallet-getassetissuebyid) | 200 | Fetch TRC10 token details using the token ID. |
| [direct/v1/QuickNode/tron/wallet /getassetissuebyname](https://www.quicknode.com/docs/tron/wallet-getassetissuebyname) | 200 | Retrieve TRC10 token information by token name. |
| [direct/v1/QuickNode/tron/walletsolidity /getassetissuebyname](https://www.quicknode.com/docs/tron/walletsolidity-getassetissuebyname) | 200 | Return the token by name. Returns token info (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet /getassetissuelistbyname](https://www.quicknode.com/docs/tron/wallet-getassetissuelistbyname) | 200 | Retrieve a list of TRC10 tokens filtered by name. |
| [direct/v1/QuickNode/tron/walletsolidity /getassetissuelistbyname](https://www.quicknode.com/docs/tron/walletsolidity-getassetissuelistbyname) | 200 | Return the list of all the TRC10 tokens by a name (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet /getavailableunfreezecount](https://www.quicknode.com/docs/tron/wallet-getavailableunfreezecount) | 200 | Return the remaining number of times an account can execute unstake operations in Stake 2.0. |
| [direct/v1/QuickNode/tron/walletsolidity /getavailableunfreezecount](https://www.quicknode.com/docs/tron/walletsolidity-getavailableunfreezecount) | 200 | Return the remaining times of executing unstake operation in Stake 2.0 (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet/getblock](https://www.quicknode.com/docs/tron/wallet-getblock) | 65 | Return block header information or entire block details. |
| [direct/v1/QuickNode/tron/walletsolidity/getblock](https://www.quicknode.com/docs/tron/walletsolidity-getblock) | 65 | Retrieve a block by its ID or height (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet/getblockbalance](https://www.quicknode.com/docs/tron/wallet-getblockbalance) | 200 | Return all balance change operations within a specific block. |
| [direct/v1/QuickNode/tron/walletsolidity /getblockbyid](https://www.quicknode.com/docs/tron/walletsolidity-getblockbyid) | 200 | Retrieve a block by its ID (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet/getblockbyid](https://www.quicknode.com/docs/tron/wallet-getblockbyid) | 200 | Retrieve block information using the block ID (hash). |
| [direct/v1/QuickNode/tron/wallet /getblockbylatestnum](https://www.quicknode.com/docs/tron/wallet-getblockbylatestnum) | 400 | Return a list of the latest blocks based on a specified number. |
| [direct/v1/QuickNode/tron/walletsolidity /getblockbylatestnum](https://www.quicknode.com/docs/tron/walletsolidity-getblockbylatestnum) | 200 | Return the latest blocks (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet /getblockbylimitnext](https://www.quicknode.com/docs/tron/wallet-getblockbylimitnext) | 200 | Retrieve a list of blocks within a specified range of block heights. |
| [direct/v1/QuickNode/tron/walletsolidity /getblockbylimitnext](https://www.quicknode.com/docs/tron/walletsolidity-getblockbylimitnext) | 200 | Retrieve a range of blocks by block height (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet/getblockbynum](https://www.quicknode.com/docs/tron/wallet-getblockbynum) | 200 | Return the block object corresponding to a specific block height. |
| [direct/v1/QuickNode/tron/walletsolidity /getblockbynum](https://www.quicknode.com/docs/tron/walletsolidity-getblockbynum) | 200 | Retrieve a block by its height (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet /getcandelegatedmaxsize](https://www.quicknode.com/docs/tron/wallet-getcandelegatedmaxsize) | 200 | Return the maximum size of resources that can be delegated. |
| [direct/v1/QuickNode/tron/walletsolidity /getcandelegatedmaxsize](https://www.quicknode.com/docs/tron/walletsolidity-getcandelegatedmaxsize) | 200 | Returns the amount of delegatable resources share of the specified resource type for an address. |
| [direct/v1/QuickNode/tron/walletsolidity /getcanwithdrawunfreezeamount](https://www.quicknode.com/docs/tron/walletsolidity-getcanwithdrawunfreezeamount) | 200 | Returns withdrawable balance at the specified timestamp in Stake 2.0 (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet /getchainparameters](https://www.quicknode.com/docs/tron/wallet-getchainparameters) | 200 | Fetch the current parameters of the blockchain. |
| [direct/v1/QuickNode/tron/wallet/getcontract](https://www.quicknode.com/docs/tron/wallet-getcontract) | 200 | Retrieve a contract's information from the blockchain, including bytecode, ABI, and configuration parameters. |
| [direct/v1/QuickNode/tron/wallet/getcontractinfo](https://www.quicknode.com/docs/tron/wallet-getcontractinfo) | 200 | Fetch contract information including both bytecode and runtime bytecode. |
| [direct/v1/QuickNode/tron/wallet /getdelegatedresource](https://www.quicknode.com/docs/tron/wallet-getdelegatedresource) | 200 | Retrieve all resource delegations (Stake 1.0) from one account to another. |
| [direct/v1/QuickNode/tron/walletsolidity /getdelegatedresource](https://developers.tron.network/reference/getdelegatedresource) | 200 | Returns all resources delegations during Stake 1.0 phase from an account to another account. |
| [direct/v1/QuickNode/tron/wallet /getdelegatedresourceaccountindex](https://developers.tron.network/reference/getdelegatedresourceaccountindex) | 200 | List all addresses that have delegated resources to a specific account (Stake 1.0). |
| [direct/v1/QuickNode/tron/walletsolidity /getdelegatedresourceaccountindex](https://www.quicknode.com/docs/tron/walletsolidity-getdelegatedresourceaccountindex) | 200 | Lists all addresses that have delegated resources to an account (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet /getdelegatedresourceaccountindexv2](https://www.quicknode.com/docs/tron/wallet-getdelegatedresourceaccountindexv2) | 200 | In Stake 2.0, retrieve lists of addresses that have delegated resources to and from a specific account. |
| [direct/v1/QuickNode/tron/walletsolidity /getdelegatedresourceaccountindexv2](https://www.quicknode.com/docs/tron/walletsolidity-getdelegatedresourceaccountindexv2) | 200 | In Stake 2.0, the resource delegation index for an account yields two lists of addresses: one for addresses that have received resource delegation from the account (toAddress), and another for addresses that have delegated resources to the account (fromAddress). |
| [direct/v1/QuickNode/tron/wallet /getdelegatedresourcev2](https://www.quicknode.com/docs/tron/wallet-getdelegatedresourcev2) | 200 | In Stake 2.0, query detailed information of resource delegation from one account to another. |
| [direct/v1/QuickNode/tron/walletsolidity /getexchangebyid](https://www.quicknode.com/docs/tron/walletsolidity-getexchangebyid) | 200 | Query exchange pair based on id (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet/getexchangebyid](https://www.quicknode.com/docs/tron/wallet-getexchangebyid) | 200 | Query exchange pair information based on its ID. |
| [direct/v1/QuickNode/tron/wallet /getexpandedspendingkey](https://docs.watchdata.io/blockchain-apis/tron-api/tronz-shielded-smart-contract/getexpandedspendingkey) | 200 | Generate an expanded spending key from a given spending key. |
| [direct/v1/QuickNode/tron/wallet /getincomingviewingkey](https://developers.tron.network/reference/getincomingviewingkey) | 200 | Generate an incoming viewing key using account key and nullifier key. |
| [direct/v1/QuickNode/tron/wallet/getnkfromnsk](https://developers.tron.network/reference/getnkfromnsk) | 200 | Derive a nullifier key (nk) from a nullifier secret key (nsk). |
| [direct/v1/QuickNode/tron/wallet /getpaginatedassetissuelist](https://www.quicknode.com/docs/tron/wallet-getpaginatedassetissuelist) | 200 | Retrieve a paginated list of all TRC10 tokens. |
| [direct/v1/QuickNode/tron/walletsolidity /getpaginatedassetissuelist](https://www.quicknode.com/docs/tron/walletsolidity-getpaginatedassetissuelist) | 200 | Returns the list of all the TRC10 tokens by a name (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet/getproposalbyid](https://developers.tron.network/reference/getproposalbyid) | 200 | Retrieve proposal information using its ID. |
| [direct/v1/QuickNode/tron/walletsolidity /gettransactionbyid](https://www.quicknode.com/docs/tron/walletsolidity-gettransactionbyid) | 200 | Returns the transaction information by transaction id. |
| [direct/v1/QuickNode/tron/wallet /gettransactionbyid](https://www.quicknode.com/docs/tron/wallet-gettransactionbyid) | 400 | Retrieve transaction information using its ID. |
| [direct/v1/QuickNode/tron/walletsolidity /gettransactioncountbyblocknum](https://www.quicknode.com/docs/tron/walletsolidity-gettransactioncountbyblocknum) | 200 | Returns transaction count in a block by block number (Confirmed state). |
| [direct/v1/QuickNode/tron/wallet /gettransactionfrompending](https://www.quicknode.com/docs/tron/wallet-gettransactionfrompending) | 200 | Retrieve transaction details from the pending transaction pool using the transaction ID. |
| [direct/v1/QuickNode/tron/wallet /gettransactioninfobyblocknum](https://www.quicknode.com/docs/tron/wallet-gettransactioninfobyblocknum) | 400 | Return the TransactionInfo data of all transactions contained in the block of the specified height. |
| [direct/v1/QuickNode/tron/walletsolidity /gettransactioninfobyblocknum](https://www.quicknode.com/docs/tron/walletsolidity-gettransactioninfobyblocknum) | 200 | Returns the TransactionInfo data of all transactions contained in the block of the specified height. |
| [direct/v1/QuickNode/tron/wallet /gettransactioninfobyid](https://www.quicknode.com/docs/tron/wallet-gettransactioninfobyid) | 200 | Query the transaction fee and block height by transaction ID. |
| [direct/v1/QuickNode/tron/walletsolidity /gettransactioninfobyid](https://www.quicknode.com/docs/tron/walletsolidity-gettransactioninfobyid) | 200 | Returns the transaction fee and block height by transaction id. |
| [direct/v1/QuickNode/tron/wallet /gettriggerinputforshieldedtrc20contract](https://www.quicknode.com/docs/tron/wallet-gettriggerinputforshieldedtrc20contract) | 200 | Generate the trigger input parameters required for executing a shielded TRC20 contract transaction. |
| [direct/v1/QuickNode/tron/wallet /getzenpaymentaddress](https://www.quicknode.com/docs/tron/wallet-getzenpaymentaddress) | 200 | Return the payment address by providing the diversifier and the incoming viewing key (ivk). |
| [direct/v1/QuickNode/tron/wallet/exchangeinject](https://www.quicknode.com/docs/tron/wallet-exchangeinject) | 200 | Inject tokens into an existing exchange. |
| [direct/v1/QuickNode/tron/wallet /isshieldedtrc20contractnotespent](https://www.quicknode.com/docs/tron/wallet-isshieldedtrc20contractnotespent) | 200 | Check whether a specific shielded TRC20 contract note has been spent or not. |
| [direct/v1/QuickNode/tron/walletsolidity /isshieldedtrc20contractnotespent](https://www.quicknode.com/docs/tron/walletsolidity-isshieldedtrc20contractnotespent) | 200 | Check whether a specific shielded TRC20 contract note has been spent or not. |
| [direct/v1/QuickNode/tron/wallet /participateassetissue](https://www.quicknode.com/docs/tron/wallet-participateassetissue) | 200 | Participate in an asset issue by sending TRX to the asset issuer. |
| [direct/v1/QuickNode/tron/wallet/proposalapprove](https://www.quicknode.com/docs/tron/wallet-proposalapprove) | 200 | Approve a proposed transaction on the TRON network. |
| [direct/v1/QuickNode/tron/wallet/proposaldelete](https://developers.tron.network/reference/deleteproposal) | 200 | Delete a proposal from the TRON network. |
| [direct/v1/QuickNode/tron/wallet /scanshieldedtrc20notesbyivk](https://www.quicknode.com/docs/tron/wallet-scanshieldedtrc20notesbyivk) | 200 | Scan shielded TRC20 notes using the incoming viewing key (IVK). |
| [direct/v1/QuickNode/tron/walletsolidity /scanshieldedtrc20notesbyivk](https://developers.tron.network/reference/scanshieldedtrc20notesbyivk) | 200 | Scan shielded TRC20 notes using the incoming viewing key (IVK). |
| [direct/v1/QuickNode/tron/wallet /scanshieldedtrc20notesbyovk](https://developers.tron.network/reference/scanshieldedtrc20notesbyovk) | 200 | Scan shielded TRC20 notes using the outgoing viewing key (OVK). |
| [direct/v1/QuickNode/tron/walletsolidity /scanshieldedtrc20notesbyovk](https://developers.tron.network/reference/scanshieldedtrc20notesbyovk) | 200 | Scan shielded TRC20 notes using the outgoing viewing key (OVK). |
| [direct/v1/QuickNode/tron/wallet/transferasset](https://www.quicknode.com/docs/tron/wallet-transferasset) | 200 | Transfer TRC10 tokens from one account to another. |
| [direct/v1/QuickNode/tron/wallet /triggerconstantcontract](https://developers.tron.network/reference/triggerconstantcontract) | 200 | Trigger a smart contract on the TRON network without broadcasting a transaction. |
| [direct/v1/QuickNode/tron/walletsolidity /triggerconstantcontract](https://www.quicknode.com/docs/tron/walletsolidity-triggerconstantcontract) | 200 | Call a smart contract in a read-only manner on the TRON blockchain (confirmed state). This method simulates the contract execution without broadcasting a transaction to the network. |
| [direct/v1/QuickNode/tron/wallet /triggersmartcontract](https://developers.tron.network/reference/triggersmartcontract) | 200 | Trigger a smart contract on the TRON network by broadcasting a transaction. |
| [direct/v1/QuickNode/tron/wallet /undelegateresource](https://developers.tron.network/reference/undelegateresource) | 200 | Un-delegate previously delegated resources from another account. |
| [direct/v1/QuickNode/tron/wallet/unfreezeasset](https://developers.tron.network/reference/unfreezeasset) | 200 | Unfreeze TRC10 tokens that were previously frozen. |
| [direct/v1/QuickNode/tron/wallet/unfreezebalance](https://www.quicknode.com/docs/tron/wallet-unfreezebalance) | 200 | Unfreeze TRX to retrieve bandwidth or energy and revoke voting rights. |
| [direct/v1/QuickNode/tron/wallet /unfreezebalancev2](https://www.quicknode.com/docs/tron/wallet-unfreezebalancev2) | 200 | Unstake TRX staked in Stake 2.0, releasing the corresponding amount of bandwidth or energy, and voting rights. After initiating the unstaking process, users must wait for 14 days before they can withdraw the funds using the /wallet/withdrawexpireunfreeze endpoint. |
| [direct/v1/QuickNode/tron/wallet/updateaccount](https://developers.tron.network/v3.7/reference/walletupdateaccount) | 200 | Modify the account name of an existing account. |
| [direct/v1/QuickNode/tron/wallet/updateasset](https://www.quicknode.com/docs/tron/wallet-updateasset) | 200 | Update basic TRC10 token information. |
| [direct/v1/QuickNode/tron/wallet /updateenergylimit](https://www.quicknode.com/docs/tron/wallet-updateenergylimit) | 200 | Update the origin\_energy\_limit parameter of a smart contract. |
| [direct/v1/QuickNode/tron/wallet/updatesetting](https://www.quicknode.com/docs/tron/wallet-updatesetting) | 200 | Update the consume\_user\_resource\_percent parameter of a smart contract. |
| [direct/v1/QuickNode/tron/wallet /accountpermissionupdate](https://www.quicknode.com/docs/tron/wallet-accountpermissionupdate) | 200 | Update the account's permission. |
| [direct/v1/QuickNode/tron/wallet/validateaddress](https://www.quicknode.com/docs/tron/wallet-validateaddress) | 65 | Validate whether an address is a valid TRON address. |
| [direct/v1/QuickNode/tron/wallet /votewitnessaccount](https://www.quicknode.com/docs/tron/wallet-votewitnessaccount) | 100 | Vote for witnesses on the TRON network. |
| [direct/v1/QuickNode/tron/wallet/exchangewithdraw](https://www.quicknode.com/docs/tron/wallet-exchangewithdraw) | 200 | Withdraw tokens from an exchange. |
| [direct/v1/QuickNode/tron/wallet /withdrawexpireunfreeze](https://www.quicknode.com/docs/tron/wallet-withdrawexpireunfreeze) | 200 | Withdraw your unfrozen balance in Stake 2.0. After executing the /wallet/unfreezebalancev2 transaction and waiting for a specific number of days (N), users can use this API to retrieve their funds. |
# Shyft direct API on Uniblock: Solana wallets, NFTs, DeFi
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-shyft
Query Shyft's 79 direct API endpoints on Uniblock for Solana wallet lookups, NFT metadata, token data, DeFi analytics, and transaction history.
# Shyft: Direct API Endpoints
Shyft provides 79 unique direct API endpoints across the following categories:
* DeFi (8 endpoints)
* Market Data (8 endpoints)
* NFT (24 endpoints)
* Scan (1 endpoint)
* SocialFi (3 endpoints)
* Token (11 endpoints)
* Transaction (12 endpoints)
* Wallets (22 endpoints)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
> **Learn more:** [Shyft Documentation](https://docs.shyft.to/callbacks)
## Prefix and Example
**Prefix:** No prefix is required for Shyft, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/Shyft + /[Shyft_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/Shyft/sol/v1/callback/list \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## DeFi
### DELETE
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------- |
| [direct/v1/Shyft/sol/v1/sol/v1/callback/remove](https://docs.shyft.to/callbacks/callback-apis#remove-a-callback) | 100 | Use this endpoint to remove a callback |
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------- | ------: | ---------------------- |
| [direct/v1/Shyft/sol/v1/callback/list](https://docs.shyft.to/callbacks/callback-apis#list-callbacks) | 100 | List all the callbacks |
### POST
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------- |
| [direct/v1/Shyft/sol/v1/callback/add-addresses](https://docs.shyft.to/callbacks/callback-apis#add-addresses-in-callback) | 100 | Add addresses to a callback |
| [direct/v1/Shyft/sol/v1/sol/v1/callback/create](https://docs.shyft.to/callbacks/callback-apis#register-a-callback) | 100 | Create a callback |
| [direct/v1/Shyft/sol/v1/callback/pause](https://docs.shyft.to/callbacks/callback-apis#pause-a-callback) | 100 | Pause a callback |
| [direct/v1/Shyft/sol/v1/callback/remove-addresses](https://docs.shyft.to/callbacks/callback-apis#remove-addresses-from-callback) | 100 | Remove addresses from a callback |
| [direct/v1/Shyft/sol/v1/callback/resume](https://docs.shyft.to/callbacks/callback-apis#resume-a-callback) | 100 | Resume a callback |
| [direct/v1/Shyft/sol/v1/callback/update](https://docs.shyft.to/callbacks/callback-apis#update-a-callback) | 100 | Update a callback |
## Market Data
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------ | ------: | ---------------------------------------------------- |
| [direct/v1/Shyft/sol/v1/marketplace/find](https://docs.shyft.to/solana-apis/nft-marketplace#find-marketplace) | 100 | Find a marketplace |
| [direct/v1/Shyft/sol/v1/marketplace/stats](https://docs.shyft.to/solana-apis/nft-marketplace#get-stats) | 100 | Fetch the stats of the marketplace. |
| [direct/v1/Shyft/sol/v1/marketplace/my\_markets](https://docs.shyft.to/solana-apis/nft-marketplace#my-markets) | 100 | Get details of all the marketplaces you have created |
| [direct/v1/Shyft/sol/v1/marketplace /treasury\_balance](https://docs.shyft.to/solana-apis/nft-marketplace#get-treasury-balance) | 100 | Check the fund balance in the marketplace account. |
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------- |
| [direct/v1/Shyft/sol/v1/marketplace/create](https://docs.shyft.to/solana-apis/nft-marketplace#create-marketplace) | 100 | Create your own on-chain NFT marketplace. |
| [direct/v1/Shyft/sol/v1/marketplace/update](https://docs.shyft.to/solana-apis/nft-marketplace#update-marketplace) | 100 | Update an already created on-chain marketplace. |
| [direct/v1/Shyft/sol/v1/marketplace/withdraw\_fee](https://docs.shyft.to/solana-apis/nft-marketplace#withdraw-fees) | 100 | Withdraw fees from the marketplace. |
### PUT
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------- |
| [direct/v1/Shyft/sol/v1/marketplace/index](https://docs.shyft.to/solana-apis/nft-marketplace#index-marketplace) | 100 | Index the marketplace on the Shyft marketplace. |
## NFT
### DELETE
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------- | ------: | ----------------------------- |
| [direct/v1/Shyft/sol/v1/nft/burn\_many](https://docs.shyft.to/solana-apis/nft#burn-multiple-nfts) | 100 | Burn as many NFTs as you want |
| [direct/v1/Shyft/sol/v1/nft/burn\_detach](https://docs.shyft.to/solana-apis/nft#burn) | 100 | Burn an NFT |
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------------------------- |
| [direct/v1/Shyft/sol/v1/candy\_machine /nft\_addresses](https://docs.shyft.to/solana-apis/candy-machine#get-all-nft-addresses) | 100 | Get all the NFT addresses |
| [direct/v1/Shyft/sol/v1/candy\_machine/nfts](https://docs.shyft.to/solana-apis/candy-machine#get-all-nfts) | 100 | Get all the NFTs |
| [direct/v1/Shyft/sol/v1/collections/get\_nfts](https://docs.shyft.to/solana-apis/collections#get-nfts) | 100 | Get all the NFTs in a collection |
| [direct/v1/Shyft/sol/v1/wallet/collections](https://docs.shyft.to/solana-apis/wallet#get-collections-in-wallet) | 100 | For getting all the collections in a wallet |
| [direct/v1/Shyft/sol/v1/nft/read](https://docs.shyft.to/solana-apis/nft#read) | 100 | Get the properties, metadata and on-chain parameters of an already existing on-chian nft. |
| [direct/v1/Shyft/sol/v1/nft/read\_all](https://docs.shyft.to/solana-apis/nft#read-all) | 100 | Read all NFTs |
| [direct/v1/Shyft/sol/v1/nft/search](https://docs.shyft.to/solana-apis/nft#search) | 100 | Search for NFTs |
### POST
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------- |
| [direct/v1/Shyft/sol/v1/nft/read\_selected](https://docs.shyft.to/solana-apis/nft#read-selected-nfts) | 100 | Read selected NFTs |
| [direct/v1/Shyft/sol/v1/candy\_machine/create](https://docs.shyft.to/solana-apis/candy-machine#create) | 100 | Create a candy machine |
| [direct/v1/Shyft/sol/v1/metadata/create](https://docs.shyft.to/solana-apis/storage#create-nft-metadata) | 100 | Create metadata for an NFT |
| [direct/v1/Shyft/sol/v1/nft/create\_detach](https://docs.shyft.to/solana-apis/nft#create) | 100 | Create an NFT |
| [direct/v1/Shyft/sol/v1/nft/create\_from\_metadata](https://docs.shyft.to/solana-apis/nft#create-from-metadata) | 100 | Create an NFT from metadata |
| [direct/v1/Shyft/sol/v1/nft/create](https://docs.shyft.to/solana-apis/nft#create-v2) | 100 | Create an NFT |
| [direct/v1/Shyft/sol/v1/candy\_machine/insert](https://docs.shyft.to/solana-apis/candy-machine#insert) | 100 | Insert token in candy machine |
| [direct/v1/Shyft/sol/v1/candy\_machine/mint](https://docs.shyft.to/solana-apis/candy-machine#mint) | 100 | Mint from candy machine |
| [direct/v1/Shyft/sol/v1/nft/mint\_detach](https://docs.shyft.to/solana-apis/nft#mint) | 100 | Creates a new NFT and mints it to the wallet |
| [direct/v1/Shyft/sol/v1/nft/get\_owners](https://docs.shyft.to/solana-apis/nft#get-nft-owners) | 100 | Returns the owners of an NFT |
| [direct/v1/Shyft/sol/v1/nft/transfer\_many](https://docs.shyft.to/solana-apis/nft#transfer-multiple-nfts) | 100 | Transfer multiple NFTs |
| [direct/v1/Shyft/sol/v1/nft/transfer\_detach](https://docs.shyft.to/solana-apis/nft#transfer) | 100 | Transfer an NFT |
| [direct/v1/Shyft/sol/v1/nft/update\_detach](https://docs.shyft.to/solana-apis/nft#update) | 100 | Update an NFT |
| [direct/v1/Shyft/sol/v1/nft/update\_metadata\_uri](https://docs.shyft.to/solana-apis/nft#update-nft-metadata-uri) | 100 | Update the metadata URI of an NFT |
| [direct/v1/Shyft/sol/v1/nft/update](https://docs.shyft.to/solana-apis/nft#update-v2) | 100 | Update an NFT |
## Scan
### POST
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------- | ------: | --------------------------------------------------------- |
| [direct/v1/Shyft/sol/v1/storage/upload](https://docs.shyft.to/solana-apis/storage#upload) | 100 | Upload and store file on IPFS decentralized data storage. |
## SocialFi
### DELETE
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------ | ------: | --------------------------- |
| [direct/v1/Shyft/sol/v1/candy\_machine/unmonitor](https://docs.shyft.to/solana-apis/candy-machine#unmonitor) | 100 | Unmonitor the candy machine |
### POST
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------- |
| [direct/v1/Shyft/sol/v1/token/create\_detach](https://docs.shyft.to/solana-apis/fungible-tokens#create) | 100 | Create your own fungible token |
| [direct/v1/Shyft/sol/v1/candy\_machine/monitor](https://docs.shyft.to/solana-apis/candy-machine#monitor) | 100 | All mints from the candy machine will be monitored |
## Token
### DELETE
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------- | ------: | ---------------------------- |
| [direct/v1/Shyft/sol/v1/token/burn\_detach](https://docs.shyft.to/solana-apis/fungible-tokens#burn) | 100 | Burn your own fungible token |
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------- |
| [direct/v1/Shyft/sol/v1/wallet/all\_tokens](https://docs.shyft.to/solana-apis/wallet#get-all-tokens) | 100 | Get the balance of all tokens in a wallet |
| [direct/v1/Shyft/sol/v1/token/get\_owners](https://docs.shyft.to/solana-apis/fungible-tokens#get-owners) | 100 | Get the owners of a fungible token |
| [direct/v1/Shyft/sol/v1/wallet/get\_portfolio](https://docs.shyft.to/solana-apis/wallet#get-portfolio) | 100 | Get the portfolio of a wallet |
| [direct/v1/Shyft/sol/v1/wallet/token\_balance](https://docs.shyft.to/solana-apis/wallet#get-token-balance) | 100 | Get the balance of a particular token in a wallet (Supports Token 2022 token info 🆕) |
| [direct/v1/Shyft/sol/v1/token/get\_info](https://docs.shyft.to/solana-apis/fungible-tokens#get-token-info) | 100 | Get the info of a token |
### POST
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------- |
| [direct/v1/Shyft/sol/v1/token/airdrop](https://docs.shyft.to/solana-apis/fungible-tokens#airdrop) | 100 | Airdrop your own fungible token |
| [direct/v1/Shyft/sol/v1/token/create\_detach](https://docs.shyft.to/solana-apis/fungible-tokens#create) | 100 | Create your own fungible token |
| [direct/v1/Shyft/sol/v1/token /create\_from\_metadata](https://docs.shyft.to/solana-apis/fungible-tokens#create-token-from-metadata) | 100 | Create a fungible token from metadata |
| [direct/v1/Shyft/sol/v1/token/mint\_detach](https://docs.shyft.to/solana-apis/fungible-tokens#mint) | 100 | Mint your own fungible token |
| [direct/v1/Shyft/sol/v1/token/transfer\_detach](https://docs.shyft.to/solana-apis/fungible-tokens#transfer) | 100 | Transfer your own fungible token |
## Transaction
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------- |
| [direct/v1/Shyft/sol/v1/transaction/parsed](https://docs.shyft.to/solana-apis/transactions/transaction-apis#get-transaction-parsed) | 100 | Returns the parsed transaction details |
| [direct/v1/Shyft/sol/v1/wallet /parsed\_transaction\_history](https://docs.shyft.to/solana-apis/wallet#get-parsed-transaction-history) | 100 | Get the parsed transaction history of a wallet |
| [direct/v1/Shyft/sol/v1/wallet/transaction](https://docs.shyft.to/solana-apis/wallet#get-transaction-history-1) | 100 | Get the details of a transaction |
| [direct/v1/Shyft/sol/v1/wallet /transaction\_history](https://docs.shyft.to/solana-apis/wallet#get-transaction-history) | 100 | Get the transaction history of a wallet |
| [direct/v1/Shyft/sol/v1/transaction/history](https://docs.shyft.to/solana-apis/transactions/transaction-apis#transaction-history) | 100 | Fetch the transaction history |
### POST
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------- |
| [direct/v1/Shyft/sol/v1/txn\_relayer/create](https://docs.shyft.to/solana-apis/transaction-relayer#create) | 100 | Creates a new transaction |
| [direct/v1/Shyft/sol/v1/sol/v1/transaction /parse\_selected](https://docs.shyft.to/solana-apis/transactions/transaction-apis#parse-selected-transactions) | 100 | Fetch the parsed details of selected transactions |
| [direct/v1/Shyft/sol/v1/transaction /send\_many\_txns](https://docs.shyft.to/solana-apis/transactions/transaction-apis#send-multiple-transactions) | 100 | Send multiple transactions |
| [direct/v1/Shyft/sol/v1/transaction/send\_txn](https://docs.shyft.to/solana-apis/transactions/transaction-apis#send-transaction) | 100 | Send a transaction |
| [direct/v1/Shyft/sol/v1/txn\_relayer/sign\_many](https://docs.shyft.to/solana-apis/transaction-relayer#sign-multiple) | 100 | Sign multiple transactions |
| [direct/v1/Shyft/sol/v1/txn\_relayer/sign](https://docs.shyft.to/solana-apis/transaction-relayer#sign) | 100 | Creates a new transaction and signs it |
| [direct/v1/Shyft/sol/v1/wallet/sign\_transaction](https://docs.shyft.to/solana-apis/wallet#sign-transaction) | 100 | Sign a transaction |
## Wallets
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | ------------------------------------------------------------------------------------- |
| [direct/v1/Shyft/sol/v1/wallet/get\_domains](https://docs.shyft.to/solana-apis/wallet#get-all-domains) | 100 | Get all domains of a wallet |
| [direct/v1/Shyft/sol/v1/wallet/all\_tokens](https://docs.shyft.to/solana-apis/wallet#get-all-tokens) | 100 | Get the balance of all tokens in a wallet |
| [direct/v1/Shyft/sol/v1/wallet/balance](https://docs.shyft.to/solana-apis/wallet#get-balance) | 100 | lets you check the balance in your solana wallet |
| [direct/v1/Shyft/sol/v1/semi\_wallet/decrypt](https://docs.shyft.to/solana-apis/semi-custodial-wallet#decrypt-semi-custodial-wallet) | 100 | Decrypt a semi custodial wallet and get the keypair |
| [direct/v1/Shyft/sol/v1/wallet/get\_keypair](https://docs.shyft.to/solana-apis/wallet#get-keypair) | 100 | Get the keypair of a semi custodial wallet |
| [direct/v1/Shyft/sol/v1/semi\_wallet/get\_keypair](https://docs.shyft.to/solana-apis/semi-custodial-wallet#get-keypair-of-semi-custodial-wallet) | 100 | Get the keypair of a semi custodial wallet |
| [direct/v1/Shyft/sol/v1/wallet/collections](https://docs.shyft.to/solana-apis/wallet#get-collections-in-wallet) | 100 | For getting all the collections in a wallet |
| [direct/v1/Shyft/sol/v1/wallet /parsed\_transaction\_history](https://docs.shyft.to/solana-apis/wallet#get-parsed-transaction-history) | 100 | Get the parsed transaction history of a wallet |
| [direct/v1/Shyft/sol/v1/wallet/get\_portfolio](https://docs.shyft.to/solana-apis/wallet#get-portfolio) | 100 | Get the portfolio of a wallet |
| [direct/v1/Shyft/sol/v1/nft/read\_all](https://docs.shyft.to/solana-apis/nft#read-all) | 100 | Read all NFTs |
| [direct/v1/Shyft/sol/v1/wallet/resolve\_address](https://docs.shyft.to/solana-apis/wallet#resolve-address) | 100 | Get the address of a domain |
| [direct/v1/Shyft/sol/v1/wallet/stake\_accounts](https://docs.shyft.to/solana-apis/wallet#get-stake-accounts) | 100 | Get the stake accounts of a wallet |
| [direct/v1/Shyft/sol/v1/wallet/token\_balance](https://docs.shyft.to/solana-apis/wallet#get-token-balance) | 100 | Get the balance of a particular token in a wallet (Supports Token 2022 token info 🆕) |
| [direct/v1/Shyft/sol/v1/wallet/transaction](https://docs.shyft.to/solana-apis/wallet#get-transaction-history-1) | 100 | Get the details of a transaction |
| [direct/v1/Shyft/sol/v1/wallet /transaction\_history](https://docs.shyft.to/solana-apis/wallet#get-transaction-history) | 100 | Get the transaction history of a wallet |
| [direct/v1/Shyft/sol/v1/wallet /decrypt\_semi\_wallet](https://docs.shyft.to/solana-apis/wallet#decrypt-semi-custodial-wallet) | 100 | Decrypt a semi custodial wallet |
### POST
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------- |
| [direct/v1/Shyft/sol/v1/semi\_wallet /change\_password](https://docs.shyft.to/solana-apis/semi-custodial-wallet#change-password-of-semi-custodial-wallet) | 100 | Change the password of a semi custodial wallet |
| [direct/v1/Shyft/sol/v1/semi\_wallet/create](https://docs.shyft.to/solana-apis/semi-custodial-wallet#create-semi-custodial-wallet) | 100 | Create a semi custodial wallet |
| [direct/v1/Shyft/sol/v1/wallet/send\_sol](https://docs.shyft.to/solana-apis/wallet#send-sol) | 100 | allows you to transfer SOL from your account to another. |
| [direct/v1/Shyft/sol/v1/wallet/send\_sol\_detach](https://docs.shyft.to/solana-apis/wallet#post-sol-v1-wallet-send_sol) | 100 | Send SOL to another wallet |
| [direct/v1/Shyft/sol/v1/wallet/create\_semi\_wallet](https://docs.shyft.to/solana-apis/wallet#create-semi-custodial-wallet) | 100 | Create a semi custodial wallet |
| [direct/v1/Shyft/sol/v1/wallet/sign\_transaction](https://docs.shyft.to/solana-apis/wallet#sign-transaction) | 100 | Sign a transaction |
# SolScan direct API on Uniblock: Solana tokens and activity
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-solscan
Query SolScan's 47 direct API endpoints on Uniblock for Solana token metadata, transaction history, wallet activity, DeFi flows, and NFT collection data.
# SolScan: Direct API Endpoints
SolScan provides 47 unique direct API endpoints across the following categories:
* DeFi (12 endpoints)
* Market Data (3 endpoints)
* NFT (4 endpoints)
* Other (2 endpoints)
* Scan (1 endpoint)
* SocialFi (1 endpoint)
* Token (20 endpoints)
* Transaction (16 endpoints)
* Wallets (9 endpoints)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
> **Learn more:** [SolScan Documentation](https://pro-api.solscan.io/pro-api-docs)
## Prefix and Example
**Prefix:** No prefix is required for SolScan, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/SolScan + /[SolScan_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/SolScan/v1.0/account/exportRewards \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## DeFi
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------------------------- |
| [direct/v1/SolScan/v1.0/account/solTransfers](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get SOL transfers for a specific account on Solana. |
| [direct/v1/SolScan/v1.0/account/splTransfers](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get SPL transfers for a specific account on Solana. |
| [direct/v1/SolScan/v1.0/account/stakeAccounts](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get staking accounts for a specific account on Solana. |
| [direct/v1/SolScan/v1.0/account/exportRewards](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Export rewards for a specific account on Solana. |
| [direct/v1/SolScan/v1.0/account /exportTransactions](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Export transactions for a specific account on Solana. |
| [direct/v1/SolScan/v1.0/token/holders](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get the list of token holders on Solana. |
| [direct/v1/SolScan/v2.0/account/balance\_change](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-balance_change) | 100 | Get balance change activities for a specific account on Solana. |
| [direct/v1/SolScan/v2.0/account/defi/activities](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-defi-activities) | 100 | Get DeFi activities for a specific account on Solana. |
| [direct/v1/SolScan/v2.0/account/detail](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-detail) | 100 | Get detailed information for a specific account on Solana. |
| [direct/v1/SolScan/v2.0/account/stake](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-stake) | 100 | Get staking information for a specific account on Solana. |
| [direct/v1/SolScan/v2.0/account/transfer](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-transfer) | 100 | Get transfer information for a specific account on Solana. |
| [direct/v1/SolScan/v2.0/account/reward/export](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-reward-export) | 100 | Export rewards for a specific account on Solana. |
## Market Data
### GET
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------- |
| [direct/v1/SolScan/v1.0/market/token /\{tokenAddress}](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get market data for a specific token using the token address on Solana. |
| [direct/v1/SolScan/v2.0/token/markets](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-markets) | 100 | Get market data for a specific token on Solana. |
| [direct/v1/SolScan/v2.0/token/price](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-price) | 100 | Get price data for a specific token on Solana. |
## NFT
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------------- |
| [direct/v1/SolScan/v2.0/nft/activities](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-nft-activities) | 100 | Get NFT activities on Solana. |
| [direct/v1/SolScan/v2.0/nft/collection/items](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-nft-collection-items) | 100 | Get items from a specific NFT collection on Solana. |
| [direct/v1/SolScan/v2.0/nft/collection/lists](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-nft-collection-lists) | 100 | Get a list of NFT collections on Solana. |
| [direct/v1/SolScan/v2.0/nft/news](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-nft-news) | 100 | Get news related to NFTs on Solana. |
## Other
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------- |
| [direct/v1/SolScan/v2.0/account/portfolio](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-portfolio) | 100 | Get the portfolio for a given address. |
| [direct/v1/SolScan/v2.0/token/meta/multi](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-meta-multi) | 100 | Get metadata for multiple tokens on Solana. |
## Scan
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------- |
| [direct/v1/SolScan/v2.0/account/transfer/export](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-transfer-export) | 100 | Export transfer information for a specific account on Solana. |
## SocialFi
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------ |
| [direct/v1/SolScan/v2.0/token/trending](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-trending) | 100 | Get trending tokens on Solana. |
## Token
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------- |
| [direct/v1/SolScan/v1.0/account/splTransfers](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get SPL transfers for a specific account on Solana. |
| [direct/v1/SolScan/v1.0/account/tokens](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get the tokens of a specific account on Solana. |
| [direct/v1/SolScan/v1.0/block/\{block}](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get detailed information for a specific block on Solana. |
| [direct/v1/SolScan/v1.0/block/last](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get the latest block information on Solana. |
| [direct/v1/SolScan/v1.0/market/token /\{tokenAddress}](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get market data for a specific token using the token address on Solana. |
| [direct/v1/SolScan/v1.0/token/holders](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get the list of token holders on Solana. |
| [direct/v1/SolScan/v1.0/token/list](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get a list of all tokens available on Solana. |
| [direct/v1/SolScan/v1.0/token/meta](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get metadata for a specific token on Solana. |
| [direct/v1/SolScan/v1.0/token/transfer](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get transfer information for a specific token on Solana. |
| [direct/v1/SolScan/v2.0/account/token-accounts](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-token-accounts) | 100 | Get token accounts for a specific account on Solana. |
| [direct/v1/SolScan/v2.0/block/detail](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-block-detail) | 100 | Get detailed information for a specific block on Solana. |
| [direct/v1/SolScan/v2.0/block/last](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-block-last) | 100 | Get the latest block information on Solana. |
| [direct/v1/SolScan/v2.0/token/defi/activities](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-defi-activities) | 100 | Get DeFi activities for a specific token on Solana. |
| [direct/v1/SolScan/v2.0/token/holders](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-holders) | 100 | Get the list of token holders on Solana. |
| [direct/v1/SolScan/v2.0/token/list](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-list) | 100 | Get a list of all tokens available on Solana. |
| [direct/v1/SolScan/v2.0/token/markets](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-markets) | 100 | Get market data for a specific token on Solana. |
| [direct/v1/SolScan/v2.0/token/meta](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-meta) | 100 | Get metadata for a specific token on Solana. |
| [direct/v1/SolScan/v2.0/token/price](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-price) | 100 | Get price data for a specific token on Solana. |
| [direct/v1/SolScan/v2.0/token/transfer](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-transfer) | 100 | Get transfer information for a specific token on Solana. |
| [direct/v1/SolScan/v2.0/token/trending](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-trending) | 100 | Get trending tokens on Solana. |
## Transaction
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------------------------------------------------- |
| [direct/v1/SolScan/v1.0/account/transactions](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get the transaction history of a specific account on Solana. |
| [direct/v1/SolScan/v1.0/block/\{block}](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get detailed information for a specific block on Solana. |
| [direct/v1/SolScan/v1.0/block/transactions](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get transactions for the latest block on Solana. |
| [direct/v1/SolScan/v1.0/account /exportTransactions](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Export transactions for a specific account on Solana. |
| [direct/v1/SolScan/v1.0/block/last](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get the latest block information on Solana. |
| [direct/v1/SolScan/v1.0/transaction/last](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get the latest transactions on Solana. |
| [direct/v1/SolScan/v1.0/transaction/\{signature}](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get detailed information for a specific transaction on Solana. |
| [direct/v1/SolScan/v2.0/account/transactions](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-transactions) | 100 | Get transactions for a specific account on Solana. |
| [direct/v1/SolScan/v2.0/account/transfer](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-transfer) | 100 | Get transfer information for a specific account on Solana. |
| [direct/v1/SolScan/v2.0/block/detail](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-block-detail) | 100 | Get detailed information for a specific block on Solana. |
| [direct/v1/SolScan/v2.0/block/transactions](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-block-transactions) | 100 | Get transactions for the latest block on Solana. |
| [direct/v1/SolScan/v2.0/block/last](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-block-last) | 100 | Get the latest block information on Solana. |
| [direct/v1/SolScan/v2.0/transaction/last](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-transaction-last) | 100 | Get the latest transactions on Solana. |
| [direct/v1/SolScan/v2.0/token/transfer](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-transfer) | 100 | Get transfer information for a specific token on Solana. |
| [direct/v1/SolScan/v2.0/transaction/actions](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-transaction-actions) | 100 | Get actions performed within a specific transaction on Solana. |
| [direct/v1/SolScan/v2.0/transaction/detail](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-transaction-detail) | 100 | Get the detail of a transaction. Return transaction data after parsed by Solscan Parser |
## Wallets
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------------------------- |
| [direct/v1/SolScan/v1.0/account/\{account}](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get detailed information for a specific account on Solana. |
| [direct/v1/SolScan/v1.0/account/solTransfers](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get SOL transfers for a specific account on Solana. |
| [direct/v1/SolScan/v1.0/account/stakeAccounts](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get staking accounts for a specific account on Solana. |
| [direct/v1/SolScan/v1.0/account/transactions](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Get the transaction history of a specific account on Solana. |
| [direct/v1/SolScan/v1.0/account/exportRewards](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Export rewards for a specific account on Solana. |
| [direct/v1/SolScan/v1.0/account /exportTransactions](https://pro-api.solscan.io/pro-api-docs/v2.0/reference) | 100 | Export transactions for a specific account on Solana. |
| [direct/v1/SolScan/v2.0/account/balance\_change](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-balance_change) | 100 | Get balance change activities for a specific account on Solana. |
| [direct/v1/SolScan/v2.0/account/transfer](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-transfer) | 100 | Get transfer information for a specific account on Solana. |
| [direct/v1/SolScan/v2.0/account/transfer/export](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-transfer-export) | 100 | Export transfer information for a specific account on Solana. |
# TonAPI direct API on Uniblock: TON blockchain scan and data
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-tonapi
Query TonAPI's 92 direct API endpoints on Uniblock for TON block scan lookups, transactions, NFT and jetton data, wallet activity, and DeFi metrics.
# TonAPI: Direct API Endpoints
TonAPI provides 92 unique direct API endpoints across the following categories:
* DeFi (6 endpoints)
* Market Data (2 endpoints)
* NFT (8 endpoints)
* Scan (60 endpoints)
* Token (3 endpoints)
* Transaction (15 endpoints)
* Wallets (8 endpoints)
*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*
> **Learn more:** [TonAPI Documentation](https://tonapi.io/api-v2)
## Prefix and Example
**Prefix:** No prefix is required for TonAPI, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/TonAPI + /[TonAPI_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/TonAPI/v2/rates \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## DeFi
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------ |
| [direct/v1/TonAPI/v2/staking/nominator /\{account\_id}/pools](https://tonapi.io/api-v2#operations-Staking-getAccountNominatorsPools) | 100 | All pools where account participates |
| [direct/v1/TonAPI/v2/rates/chart](https://tonapi.io/api-v2#operations-Rates-getChartRates) | 100 | Get chart by token |
| [direct/v1/TonAPI/v2/rates](https://tonapi.io/api-v2#operations-Rates-getRates) | 100 | Get the token price to the currency |
| [direct/v1/TonAPI/v2/staking/pool/\{account\_id} /history](https://tonapi.io/api-v2#operations-Staking-getStakingPoolHistory) | 100 | Pool history |
| [direct/v1/TonAPI/v2/staking/pool/\{account\_id}](https://tonapi.io/api-v2#operations-Staking-getStakingPoolInfo) | 100 | Stacking pool info |
| [direct/v1/TonAPI/v2/staking/pools](https://tonapi.io/api-v2#operations-Staking-getStakingPools) | 100 | All pools available in network |
## Market Data
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------- | ------: | ----------------------------------- |
| [direct/v1/TonAPI/v2/rates/markets](https://tonapi.io/api-v2#operations-Rates-getMarketsRates) | 100 | Get the TON price from markets |
| [direct/v1/TonAPI/v2/rates](https://tonapi.io/api-v2#operations-Rates-getRates) | 100 | Get the token price to the currency |
## NFT
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------------- |
| [direct/v1/TonAPI/v2/accounts/\{account\_id}/nfts /history](https://tonapi.io/api-v2#operations-Accounts-getAccountNftHistory) | 100 | Get the transfer nft history |
| [direct/v1/TonAPI/v2/accounts/\{account\_id}/nfts](https://tonapi.io/api-v2#operations-Accounts-getAccountNftItems) | 100 | Get all NFT items by owner address |
| [direct/v1/TonAPI/v2/nfts/collections /\{account\_id}/items](https://tonapi.io/api-v2#operations-NFT-getItemsFromCollection) | 100 | Get NFT items from collection by collection address |
| [direct/v1/TonAPI/v2/nfts/collections /\{account\_id}](https://tonapi.io/api-v2#operations-NFT-getNftCollection) | 100 | Get NFT collection by collection address |
| [direct/v1/TonAPI/v2/nfts/collections](https://tonapi.io/api-v2#operations-NFT-getNftCollections) | 100 | Get NFT collections |
| [direct/v1/TonAPI/v2/nfts/\{account\_id}/history](https://tonapi.io/api-v2#operations-NFT-getNftHistoryByID) | 100 | Get the transfer nfts history for account |
| [direct/v1/TonAPI/v2/nfts/\{account\_id}](https://tonapi.io/api-v2#operations-NFT-getNftItemByAddress) | 100 | Get NFT item by its address |
### POST
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------------- | ------: | -------------------------------- |
| [direct/v1/TonAPI/v2/nfts/\_bulk](https://tonapi.io/api-v2#operations-NFT-getNftItemByAddress) | 100 | Get NFT items by their addresses |
## Scan
### GET
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/TonAPI/v2/accounts/\{account\_id}](https://tonapi.io/api-v2#operations-Accounts-getAccount) | 100 | Get human-friendly information about an account without low-level details. |
| [direct/v1/TonAPI/v2/accounts/\{account\_id}/diff](https://tonapi.io/api-v2#operations-Accounts-getAccountDiff) | 100 | Get account's balance change |
| [direct/v1/TonAPI/v2/accounts/\{account\_id}/dns /backresolve](https://tonapi.io/api-v2#operations-Accounts-getAccountDnsBackResolve) | 100 | Get account's domains |
| [direct/v1/TonAPI/v2/accounts/\{account\_id}/dns /expiring](https://tonapi.io/api-v2#operations-Accounts-getAccountDnsExpiring) | 100 | Get expiring account .ton dns |
| [direct/v1/TonAPI/v2/accounts/\{account\_id}/events /\{event\_id}](https://tonapi.io/api-v2#operations-Accounts-getAccountEvent) | 100 | Get event for an account by event\_id |
| [direct/v1/TonAPI/v2/accounts/\{account\_id}/events](https://tonapi.io/api-v2#operations-Accounts-getAccountEvents) | 100 | Get events for an account. Each event is built on top of a trace which is a series of transactions caused by one inbound message. TonAPI looks for known patterns inside the trace and splits the trace into actions, where a single action represents a meaningful high-level operation like a Jetton Transfer or an NFT Purchase. Actions are expected to be shown to users. It is advised not to build any logic on top of actions because actions can be changed at any time. |
| [direct/v1/TonAPI/v2/experimental/accounts /\{account\_id}/inscriptions](https://tonapi.io/api-v2#operations-Inscriptions-getAccountInscriptions) | 100 | Get all inscriptions by owner address. It's experimental API and can be dropped in the future. |
| [direct/v1/TonAPI/v2/experimental/accounts /\{account\_id}/inscriptions/history](https://tonapi.io/api-v2#operations-Inscriptions-getAccountInscriptionsHistory) | 100 | Get the transfer inscriptions history for account. It's experimental API and can be dropped in the future. |
| [direct/v1/TonAPI/v2/experimental/accounts /\{account\_id}/inscriptions/\{ticker}/history](https://tonapi.io/api-v2#operations-Inscriptions-getAccountInscriptionsHistoryByTicker) | 100 | Get the transfer inscriptions history for account. It's experimental API and can be dropped in the future. |
| [direct/v1/TonAPI/v2/accounts/\{account\_id} /jettons/\{jetton\_id}/history](https://tonapi.io/api-v2#operations-Accounts-getAccountJettonHistoryByID) | 100 | Get the transfer jetton history for account and jetton |
| [direct/v1/TonAPI/v2/accounts/\{account\_id} /jettons](https://tonapi.io/api-v2#operations-Accounts-getAccountJettonsBalances) | 100 | Get all Jettons balances by owner address |
| [direct/v1/TonAPI/v2/accounts/\{account\_id} /publickey](https://tonapi.io/api-v2#operations-Accounts-getAccountPublicKey) | 100 | Get public key by account id |
| [direct/v1/TonAPI/v2/accounts/\{account\_id} /subscriptions](https://tonapi.io/api-v2#operations-Accounts-getAccountSubscriptions) | 100 | Get all subscriptions by wallet address |
| [direct/v1/TonAPI/v2/address/\{account\_id}/parse](https://tonapi.io/api-v2#operations-Address-getAddressParse) | 100 | parse address and display in all formats |
| [direct/v1/TonAPI/v2/liteserver /get\_all\_shards\_info/\{block\_id}](https://tonapi.io/api-v2#operations-Lite%20Server-getAllRawShardsInfo) | 100 | Get all raw shards info |
| [direct/v1/TonAPI/v2/blockchain/accounts /\{account\_id}/inspect](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainAccountInspect) | 100 | Blockchain account inspect |
| [direct/v1/TonAPI/v2/blockchain/blocks/\{block\_id}](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainBlock) | 100 | Get blockchain block data |
| [direct/v1/TonAPI/v2/blockchain/config](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainConfig) | 100 | Get blockchain config |
| [direct/v1/TonAPI/v2/blockchain/masterchain /\{masterchain\_seqno}/config](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainConfigFromBlock) | 100 | Get blockchain config from a specific block, if present. |
| [direct/v1/TonAPI/v2/blockchain/masterchain /\{masterchain\_seqno}/blocks](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainMasterchainBlocks) | 100 | Get all blocks in all shards and workchains between target and previous masterchain block according to shards last blocks snapshot in masterchain. We don't recommend to build your app around this method because it has problem with scalability and will work very slow in the future. |
| [direct/v1/TonAPI/v2/blockchain/masterchain-head](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainMasterchainHead) | 100 | Get last known masterchain block |
| [direct/v1/TonAPI/v2/blockchain/masterchain /\{masterchain\_seqno}/shards](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainMasterchainShards) | 100 | Get blockchain block shards |
| [direct/v1/TonAPI/v2/blockchain/accounts /\{account\_id}](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainRawAccount) | 100 | Get low-level information about an account taken directly from the blockchain. |
| [direct/v1/TonAPI/v2/blockchain/validators](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainValidators) | 100 | Get blockchain validators |
| [direct/v1/TonAPI/v2/dns/auctions](https://tonapi.io/api-v2#operations-DNS-getAllAuctions) | 100 | Get all auctions |
| [direct/v1/TonAPI/v2/dns/\{domain\_name}](https://tonapi.io/api-v2#operations-DNS-getDnsInfo) | 100 | Get full information about domain name |
| [direct/v1/TonAPI/v2/dns/\{domain\_name}/resolve](https://tonapi.io/api-v2#operations-DNS-getDnsResolve) | 100 | DNS resolve for domain name |
| [direct/v1/TonAPI/v2/dns/\{domain\_name}/bids](https://tonapi.io/api-v2#operations-DNS-getDomainBids) | 100 | Get domain bids |
| [direct/v1/TonAPI/v2/events/\{event\_id}](https://tonapi.io/api-v2#operations-Events-getEvent) | 100 | Get an event either by event ID or a hash of any transaction in a trace. An event is built on top of a trace which is a series of transactions caused by one inbound message. TonAPI looks for known patterns inside the trace and splits the trace into actions, where a single action represents a meaningful high-level operation like a Jetton Transfer or an NFT Purchase. Actions are expected to be shown to users. It is advised not to build any logic on top of actions because actions can be changed at any time. |
| [direct/v1/TonAPI/v2/blockchain/accounts /\{account\_id}/methods/\{method\_name}](https://tonapi.io/api-v2#operations-Blockchain-getExecGetMethodForBlockchainAccount) | 100 | Execute get method for account |
| [direct/v1/TonAPI/v2/experimental/inscriptions /op-template](https://tonapi.io/api-v2#operations-Inscriptions-getInscriptionOpTemplate) | 100 | return comment for making operation with inscription. please don't use it if you don't know what you are doing |
| [direct/v1/TonAPI/v2/jettons/\{account\_id}/holders](https://tonapi.io/api-v2#operations-Jettons-getJettonHolders) | 100 | Get jetton's holders |
| [direct/v1/TonAPI/v2/jettons/\{account\_id}](https://tonapi.io/api-v2#operations-Jettons-getJettonInfo) | 100 | Get jetton metadata by jetton master address |
| [direct/v1/TonAPI/v2/jettons](https://tonapi.io/api-v2#operations-Jettons-getJettons) | 100 | Get a list of all indexed jetton masters in the blockchain. |
| [direct/v1/TonAPI/v2/events/\{event\_id}/jettons](https://tonapi.io/api-v2#operations-Events-getJettonsEvents) | 100 | Get only jetton transfers in the event |
| [direct/v1/TonAPI/v2/liteserver /get\_out\_msg\_queue\_sizes](https://tonapi.io/api-v2#operations-Lite%20Server-getOutMsgQueueSizes) | 100 | Get out msg queue sizes |
| [direct/v1/TonAPI/v2/liteserver/get\_account\_state /\{account\_id}](https://tonapi.io/api-v2#operations-Lite%20Server-getRawAccountState) | 100 | Get raw account state |
| [direct/v1/TonAPI/v2/liteserver/get\_block /\{block\_id}](https://tonapi.io/api-v2#operations-Lite%20Server-getRawBlockchainBlock) | 100 | Get raw blockchain block |
| [direct/v1/TonAPI/v2/liteserver/get\_block\_header /\{block\_id}](https://tonapi.io/api-v2#operations-Lite%20Server-getRawBlockchainBlockHeader) | 100 | Get raw blockchain block header |
| [direct/v1/TonAPI/v2/liteserver/get\_state /\{block\_id}](https://tonapi.io/api-v2#operations-Lite%20Server-getRawBlockchainBlockState) | 100 | Get raw blockchain block state |
| [direct/v1/TonAPI/v2/blockchain/config/raw](https://tonapi.io/api-v2#operations-Blockchain-getRawBlockchainConfig) | 100 | Get raw blockchain config |
| [direct/v1/TonAPI/v2/blockchain/masterchain /\{masterchain\_seqno}/config/raw](https://tonapi.io/api-v2#operations-Blockchain-getRawBlockchainConfigFromBlock) | 100 | Get raw blockchain config from a specific block, if present. |
| [direct/v1/TonAPI/v2/liteserver/get\_block\_proof](https://tonapi.io/api-v2#operations-Lite%20Server-getRawBlockProof) | 100 | Get raw block proof |
| [direct/v1/TonAPI/v2/liteserver/get\_config\_all /\{block\_id}](https://tonapi.io/api-v2#operations-Lite%20Server-getRawConfig) | 100 | Get raw config |
| [direct/v1/TonAPI/v2/liteserver /get\_masterchain\_info](https://tonapi.io/api-v2#operations-Lite%20Server-getRawMasterchainInfo) | 100 | Get raw masterchain info |
| [direct/v1/TonAPI/v2/liteserver /get\_masterchain\_info\_ext](https://tonapi.io/api-v2#operations-Lite%20Server-getRawMasterchainInfoExt) | 100 | Get raw masterchain info ext |
| [direct/v1/TonAPI/v2/liteserver /get\_shard\_block\_proof/\{block\_id}](https://tonapi.io/api-v2#operations-Lite%20Server-getRawShardBlockProof) | 100 | Get raw shard block proof |
| [direct/v1/TonAPI/v2/liteserver/get\_shard\_info /\{block\_id}](https://tonapi.io/api-v2#operations-Lite%20Server-getRawShardInfo) | 100 | Get raw shard info |
| [direct/v1/TonAPI/v2/liteserver/get\_time](https://tonapi.io/api-v2#operations-Lite%20Server-getRawTime) | 100 | Get raw time |
| [direct/v1/TonAPI/v2/accounts/search](https://tonapi.io/api-v2#operations-Accounts-searchAccounts) | 100 | Search by account domain name |
| [direct/v1/TonAPI/v2/storage/providers](https://tonapi.io/api-v2#operations-Storage-getStorageProviders) | 100 | Get TON storage providers deployed to the blockchain. |
| [direct/v1/TonAPI/v2/tonconnect/payload](https://tonapi.io/api-v2#operations-Connect-getTonConnectPayload) | 100 | Get a payload for further token receipt |
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------------------------------------ | ------: | --------------------------------------------------------------------------------- |
| [direct/v1/TonAPI/v2/tonconnect/stateinit](https://tonapi.io/api-v2#operations-Connect-getAccountInfoByStateInit) | 100 | Get account info by state init |
| [direct/v1/TonAPI/v2/message/decode](https://tonapi.io/api-v2#operations-Emulation-decodeMessage) | 100 | Decode a given message. Only external incoming messages can be decoded currently. |
| [direct/v1/TonAPI/v2/accounts/\{account\_id}/events /emulate](https://tonapi.io/api-v2#operations-Accounts-emulateAccountEvent) | 100 | Emulate sending message to blockchain |
| [direct/v1/TonAPI/v2/events/emulate](https://tonapi.io/api-v2#operations-Events-emulateMessageToEvent) | 100 | Emulate sending message to blockchain |
| [direct/v1/TonAPI/v2/accounts/\_bulk](https://tonapi.io/api-v2#operations-Accounts-getAccounts) | 100 | Get human-friendly information about several accounts without low-level details. |
| [direct/v1/TonAPI/v2/accounts/\{account\_id} /reindex](https://tonapi.io/api-v2#operations-Accounts-reindexAccount) | 100 | Update internal cache for a particular account |
| [direct/v1/TonAPI/v2/blockchain/message](https://tonapi.io/api-v2#operations-Blockchain-sendBlockchainMessage) | 100 | Send message to blockchain |
| [direct/v1/TonAPI/v2/liteserver/send\_message](https://tonapi.io/api-v2#operations-Lite%20Server-sendRawMessage) | 100 | Send raw message to blockchain |
## Token
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------- |
| [direct/v1/TonAPI/v2/address/\{account\_id}/parse](https://tonapi.io/api-v2#operations-Address-getAddressParse) | 100 | parse address and display in all formats |
| [direct/v1/TonAPI/v2/blockchain/blocks/\{block\_id}](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainBlock) | 100 | Get blockchain block data |
| [direct/v1/TonAPI/v2/status](https://tonapi.io/api-v2#operations-Status-getStatus) | 100 | Status |
## Transaction
### GET
| Path | Est. CU | Description |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/TonAPI/v2/accounts/\{account\_id} /jettons/history](https://tonapi.io/api-v2#operations-Accounts-getAccountJettonsHistory) | 100 | Get the transfer jettons history for account |
| [direct/v1/TonAPI/v2/accounts/\{account\_id}/nfts /history](https://tonapi.io/api-v2#operations-Accounts-getAccountNftHistory) | 100 | Get the transfer nft history |
| [direct/v1/TonAPI/v2/accounts/\{account\_id}/traces](https://tonapi.io/api-v2#operations-Accounts-getAccountTraces) | 100 | Get traces for account |
| [direct/v1/TonAPI/v2/blockchain/accounts /\{account\_id}/transactions](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainAccountTransactions) | 100 | Get account transactions |
| [direct/v1/TonAPI/v2/blockchain/blocks/\{block\_id}](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainBlock) | 100 | Get blockchain block data |
| [direct/v1/TonAPI/v2/blockchain/blocks/\{block\_id} /transactions](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainBlockTransactions) | 100 | Get transactions from block |
| [direct/v1/TonAPI/v2/blockchain/masterchain /\{masterchain\_seqno}/transactions](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainMasterchainTransactions) | 100 | Get all transactions in all shards and workchains between target and previous masterchain block according to shards last blocks snapshot in masterchain. We don't recommend to build your app around this method because it has problem with scalability and will work very slow in the future. |
| [direct/v1/TonAPI/v2/blockchain/transactions /\{transaction\_id}](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainTransaction) | 100 | Get transaction data |
| [direct/v1/TonAPI/v2/blockchain/messages/\{msg\_id} /transaction](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainTransactionByMessageHash) | 100 | Get transaction data by message hash |
| [direct/v1/TonAPI/v2/events/\{event\_id}](https://tonapi.io/api-v2#operations-Events-getEvent) | 100 | Get an event either by event ID or a hash of any transaction in a trace. An event is built on top of a trace which is a series of transactions caused by one inbound message. TonAPI looks for known patterns inside the trace and splits the trace into actions, where a single action represents a meaningful high-level operation like a Jetton Transfer or an NFT Purchase. Actions are expected to be shown to users. It is advised not to build any logic on top of actions because actions can be changed at any time. |
| [direct/v1/TonAPI/v2/nfts/\{account\_id}/history](https://tonapi.io/api-v2#operations-NFT-getNftHistoryByID) | 100 | Get the transfer nfts history for account |
| [direct/v1/TonAPI/v2/liteserver /list\_block\_transactions/\{block\_id}](https://tonapi.io/api-v2#operations-Lite%20Server-getRawListBlockTransactions) | 100 | Get raw list block transactions |
| [direct/v1/TonAPI/v2/liteserver/get\_transactions /\{account\_id}](https://tonapi.io/api-v2#operations-Lite%20Server-getRawTransactions) | 100 | Get raw transactions |
| [direct/v1/TonAPI/v2/traces/\{trace\_id}](https://tonapi.io/api-v2#operations-Traces-getTrace) | 100 | Get the trace by trace ID or hash of any transaction in trace |
### POST
| Path | Est. CU | Description |
| --------------------------------------------------------------------------------------------- | ------: | ------------------------------------- |
| [direct/v1/TonAPI/v2/traces/emulate](https://tonapi.io/api-v2#operations-Traces-emulateTrace) | 100 | Emulate sending message to blockchain |
## Wallets
### GET
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------ |
| [direct/v1/TonAPI/v2/wallet/\{account\_id}/seqno](https://tonapi.io/api-v2#operations-Wallet-getAccountSeqno) | 100 | Get account seqno |
| [direct/v1/TonAPI/v2/blockchain/accounts /\{account\_id}](https://tonapi.io/api-v2#operations-Blockchain-getBlockchainRawAccount) | 100 | Get low-level information about an account taken directly from the blockchain. |
| [direct/v1/TonAPI/v2/liteserver/get\_account\_state /\{account\_id}](https://tonapi.io/api-v2#operations-Lite%20Server-getRawAccountState) | 100 | Get raw account state |
| [direct/v1/TonAPI/v2/liteserver/get\_transactions /\{account\_id}](https://tonapi.io/api-v2#operations-Lite%20Server-getRawTransactions) | 100 | Get raw transactions |
| [direct/v1/TonAPI/v2/pubkeys/\{public\_key}/wallets](https://tonapi.io/api-v2#operations-Wallet-getWalletsByPublicKey) | 100 | Get wallets by public key |
### POST
| Path | Est. CU | Description |
| ------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------- |
| [direct/v1/TonAPI/v2/wallet/emulate](https://tonapi.io/api-v2#operations-Wallet-emulateMessageToWallet) | 100 | Emulate sending message to blockchain |
| [direct/v1/TonAPI/v2/wallet/auth/proof](https://tonapi.io/api-v2#operations-Wallet-tonConnectProof) | 100 | Account verification and token issuance |
### PUT
| Path | Est. CU | Description |
| ----------------------------------------------------------------------------------------------- | ------: | --------------- |
| [direct/v1/TonAPI/v2/wallet/backup](https://tonapi.io/api-v2#operations-Wallet-setWalletBackup) | 100 | Set backup info |
# xStocks direct API on Uniblock: tokenized equity data
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-xstocks
Reach xStocks's 24 direct API endpoints on Uniblock for tokenized equity quotes, market data, and metadata across supported real-world asset tickers.
# XStocks: Direct API Endpoints
XStocks provides 24 unique direct API endpoints across the following categories:
* Other (24 endpoints)
## Prefix and Example
**Prefix:** No prefix is required for XStocks, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/XStocks + /[XStocks_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/XStocks/v2/bridges \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## Other
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------- | ------: | -------------------------------------------------------- |
| direct/v1/XStocks/v2/public/assets/\{symbol} | 100 | Get full details for a specific tokenized asset. |
| direct/v1/XStocks/v2/public/assets/\{symbol} /multiplier | 100 | Get current and pending multiplier for an asset. |
| direct/v1/XStocks/v2/public/assets/\{symbol} /multiplier/history | 100 | List multiplier change history for an asset. |
| direct/v1/XStocks/v2/public/assets/\{symbol} /price-data | 100 | Get the latest indicative price for an asset. |
| direct/v1/XStocks/v2/public/system/status /\{symbol} | 100 | Get market and atomic trading halt status for an asset. |
| direct/v1/XStocks/v2/trades/market/fees | 100 | Get the fee schedule for all operation types. |
| direct/v1/XStocks/v2/public/proof-of-reserves /\{symbol} | 100 | Get proof of reserves for a specific asset. |
| direct/v1/XStocks/v2/trades/\{id} | 100 | Get details for a specific trade. |
| direct/v1/XStocks/v2/trades/summary | 100 | Daily trade count breakdown by status. |
| direct/v1/XStocks/v2/client/limits | 100 | Get minimum transaction thresholds per operation type. |
| direct/v1/XStocks/v2/client/usage | 100 | Get cumulative transaction volume totals for the client. |
| direct/v1/XStocks/v2/trades/xchange/assets /\{identifier} | 100 | Get xChange trading config for a specific asset. |
| direct/v1/XStocks/v2/trades/xchange/quote/\{id} | 100 | Get the current state of an xChange quote. |
| direct/v1/XStocks/v2/public/assets | 100 | List all publicly available tokenized assets. |
| direct/v1/XStocks/v2/bridges | 100 | List all bridge operations for the client. |
| direct/v1/XStocks/v2/trades | 100 | List all trades for the authenticated client. |
| direct/v1/XStocks/v2/bridges/sweeping-wallets | 100 | Get deposit addresses for cross-chain bridge operations. |
| direct/v1/XStocks/v2/public/corporate-actions /history | 100 | List historical corporate actions for tokenized assets. |
| direct/v1/XStocks/v2/trades/inkind /sweeping-wallets | 100 | Get deposit addresses for in-kind redemption. |
| direct/v1/XStocks/v2/trades/market/issuance /sweeping-wallets | 100 | Get deposit addresses for market issuance. |
| direct/v1/XStocks/v2/trades/market/redemption /sweeping-wallets | 100 | Get deposit addresses for market redemption. |
| direct/v1/XStocks/v2/client/registered-wallets | 100 | List all registered and whitelisted wallets. |
| direct/v1/XStocks/v2/public/corporate-actions /upcoming | 100 | List upcoming announced corporate actions. |
| direct/v1/XStocks/v2/trades/xchange/assets | 100 | List all assets available for trading via xChange. |
# Zerion direct API on Uniblock: portfolios and DeFi positions
Source: https://docs.uniblock.dev/reference/direct/direct-providers/direct-api-zerion
Reach Zerion's 20 direct API endpoints on Uniblock for wallet portfolios, DeFi position tracking, tokens, and multi-chain balance aggregation.
# Zerion: Direct API Endpoints
Zerion provides 20 unique direct API endpoints across the following categories:
* Other (20 endpoints)
## Prefix and Example
**Prefix:** No prefix is required for Zerion, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/Zerion + /[Zerion_endpoint]`.
**Example Request:**
```bash theme={null}
curl --request GET \
--url https://api.uniblock.dev/direct/v1/Zerion/v1/chains/ \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```
## Other
### GET
| Path | Est. CU | Description |
| ---------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| direct/v1/Zerion/v1/chains/\{chain\_id} | 100 | This endpoint returns chain by unique chain identifier. |
| direct/v1/Zerion/v1/dapps | 100 | This endpoint returns list of DApps by using different parameters. |
| direct/v1/Zerion/v1/dapps/\{dapp\_id} | 100 | This endpoint returns single DApp by its unique identifier. |
| direct/v1/Zerion/v1/fungibles/\{fungible\_id} | 100 | This endpoint returns a fungible asset by unique identifier |
| direct/v1/Zerion/v1/fungibles/\{fungible\_id} /charts/\{chart\_period} | 100 | This endpoint returns the chart for the fungible asset for a selected period |
| direct/v1/Zerion/v1/nfts/\{nft\_id} | 100 | This endpoint returns single NFT by its unique identifier. |
| direct/v1/Zerion/v1/wallets/\{address}/charts /\{chart\_period} | 100 | This endpoint returns a portfolio balance chart for a wallet. This is over a specified time period, based on the provided start and end timestamps. Results can be filtered by blockchain and asset type, offering flexible and detailed visualizations of wallet performance, similar to what you see in the Zerion interface. Note: We do not support historical protocol positions data. |
| direct/v1/Zerion/v1/wallets/\{address} /nft-portfolio | 100 | This endpoint returns the NFT portfolio overview of a web3 wallet. |
| direct/v1/Zerion/v1/wallets/\{address}/pnl | 100 | This endpoint returns the Profit and Loss (PnL) details of a web3 wallet. This includes Unrealized PnL, Realized PnL, Net Invested amounts and filters for asset categories like Non Fungible Tokens (NFTs). It uses the FIFO (First In, First Out) standard for calculations, providing accurate insights into wallet performance. Ideal for tracking and analyzing financial outcomes of wallet activity. |
| direct/v1/Zerion/v1/wallets/\{address}/portfolio | 100 | This endpoint returns the portfolio overview of a web3 wallet. |
| direct/v1/Zerion/v1/chains/ | 100 | This endpoint returns list of all chains supported by Zerion. |
| direct/v1/Zerion/v1/fungibles/ | 100 | This endpoint returns a paginated list of fungible assets supported by Zerion. It also provides the ability to search for fungibles. If no fungible assets are found for given filters, the empty list with 200 status is returned. |
| direct/v1/Zerion/v1/gas-prices/ | 100 | This endpoint provides real-time information on the current gas prices across all supported blockchain networks. |
| direct/v1/Zerion/v1/nfts/ | 100 | This endpoint returns list of NFTs by using different parameters. It returns NFTs of both types - ERC721 and ERC1155. |
| direct/v1/Zerion/v1/wallets/\{address} /nft-collections/ | 100 | This endpoint returns a list of the NFT collections held by a specific wallet. |
| direct/v1/Zerion/v1/wallets/\{address} /nft-positions/ | 100 | This endpoint returns a list of the NFT positions held by a specific wallet. |
| direct/v1/Zerion/v1/wallets/\{address}/positions/ | 100 | This endpoint returns a list of wallet positions. |
| direct/v1/Zerion/v1/wallets/\{address} /transactions/ | 100 | This endpoint returns a list of transactions associated with the wallet. |
| direct/v1/Zerion/v1/swap/fungibles/ | 100 | The endpoint provides a list of fungibles available for bridge exchange. This endpoint is specifically designed for situations where the input and output chains are different. |
| direct/v1/Zerion/v1/swap/offers/ | 100 | The endpoint offers a comprehensive overview of relevant trades and bridge exchanges. |
# Direct API providers on Uniblock: index by vendor
Source: https://docs.uniblock.dev/reference/direct/direct-providers/overview
Browse every Direct API provider on Uniblock and jump to their endpoints, from Alchemy and Moralis to Birdeye, Polymarket, HelloMoon, and more.
# Direct API: Providers
Browse Direct API endpoints organized by blockchain data provider. Each provider specializes in different data categories and networks.
## Alchemy
Alchemy provides 29 unique endpoints across: DeFi, Market Data, NFT, Other, Token, Wallets.
[View Alchemy endpoints →](/reference/direct/direct-providers/direct-api-alchemy)
## Allium
Allium provides 44 unique endpoints across: DeFi, Market Data, Prediction Markets, Scan, Stablecoins, Token, Transaction, Wallets.
[View Allium endpoints →](/reference/direct/direct-providers/direct-api-allium)
## Birdeye
Birdeye provides 83 unique endpoints across: DeFi, Market Data, Scan, Token, Transaction, Wallets.
[View Birdeye endpoints →](/reference/direct/direct-providers/direct-api-birdeye)
## Codex
Codex provides 61 unique endpoints across: DeFi, Market Data, NFT, Token, Transaction, Wallets.
[View Codex endpoints →](/reference/direct/direct-providers/direct-api-codex)
## CoinGecko
CoinGecko provides 79 unique endpoints across: DeFi, Market Data, NFT, Other, SocialFi, Token, Wallets.
[View CoinGecko endpoints →](/reference/direct/direct-providers/direct-api-coingecko)
## CoinMarketCap
CoinMarketCap provides 81 unique endpoints across: DeFi, Market Data, Other, Prediction Markets, Scan, SocialFi, Stablecoins, Token, Transactions.
[View CoinMarketCap endpoints →](/reference/direct/direct-providers/direct-api-coinmarketcap)
## Dwellir
Dwellir provides 1 unique endpoint across: Other.
[View Dwellir endpoints →](/reference/direct/direct-providers/direct-api-dwellir)
## GeniiData
GeniiData provides 23 unique endpoints across: Other.
[View GeniiData endpoints →](/reference/direct/direct-providers/direct-api-geniidata)
## GoldRush
GoldRush provides 48 unique endpoints across: DeFi, Market Data, NFT, Scan, Token, Transaction, Wallets.
[View GoldRush endpoints →](/reference/direct/direct-providers/direct-api-goldrush)
## Helius
Helius provides 2 unique endpoints across: Transaction.
[View Helius endpoints →](/reference/direct/direct-providers/direct-api-helius)
## HelloMoon
HelloMoon provides 180 unique endpoints across: DeFi, Market Data, NFT, SocialFi, Token, Transaction, Wallets.
[View HelloMoon endpoints →](/reference/direct/direct-providers/direct-api-hellomoon)
## Kraken
Kraken provides 55 unique endpoints across: Centralized Finance, Historical, Market Data, Token, Trading, Utility, Wallets.
[View Kraken endpoints →](/reference/direct/direct-providers/direct-api-kraken)
## LunarCrush
LunarCrush provides 32 unique endpoints across: DeFi, Market Data, NFT, SocialFi, Token.
[View LunarCrush endpoints →](/reference/direct/direct-providers/direct-api-lunarcrush)
## MagicEden
MagicEden provides 41 unique endpoints across: Other.
[View MagicEden endpoints →](/reference/direct/direct-providers/direct-api-magiceden)
## Mempool
Mempool provides 83 unique endpoints across: Other.
[View Mempool endpoints →](/reference/direct/direct-providers/direct-api-mempool)
## Moralis
Moralis provides 111 unique endpoints across: DeFi, Market Data, NFT, Other, Scan, SocialFi, Token, Transaction, Wallets.
[View Moralis endpoints →](/reference/direct/direct-providers/direct-api-moralis)
## Polymarket
Polymarket provides 59 unique endpoints across: Balance, Historical, Liquidity, Market Data, Metadata, Other, Prediction Markets, Price, Ramp, SocialFi, Trading, Utility.
[View Polymarket endpoints →](/reference/direct/direct-providers/direct-api-polymarket)
## QuickNode
QuickNode provides 117 unique endpoints across: Other.
[View QuickNode endpoints →](/reference/direct/direct-providers/direct-api-quicknode)
## Shyft
Shyft provides 79 unique endpoints across: DeFi, Market Data, NFT, Scan, SocialFi, Token, Transaction, Wallets.
[View Shyft endpoints →](/reference/direct/direct-providers/direct-api-shyft)
## SolScan
SolScan provides 47 unique endpoints across: DeFi, Market Data, NFT, Other, Scan, SocialFi, Token, Transaction, Wallets.
[View SolScan endpoints →](/reference/direct/direct-providers/direct-api-solscan)
## TonAPI
TonAPI provides 92 unique endpoints across: DeFi, Market Data, NFT, Scan, Token, Transaction, Wallets.
[View TonAPI endpoints →](/reference/direct/direct-providers/direct-api-tonapi)
## XStocks
XStocks provides 24 unique endpoints across: Other.
[View XStocks endpoints →](/reference/direct/direct-providers/direct-api-xstocks)
## Zerion
Zerion provides 20 unique endpoints across: Other.
[View Zerion endpoints →](/reference/direct/direct-providers/direct-api-zerion)
# Solana gRPC streaming through Uniblock
Source: https://docs.uniblock.dev/reference/grpc/solana
Yellowstone-compatible Solana gRPC streaming: connect with an x-token, apply server-side filters, and replay up to 48 hours of history.
Solana gRPC streaming carries account, transaction, slot, entry and block metadata updates over one long-lived connection. The wire schema is stock Yellowstone, also called Dragon's Mouth, at proto 12.5. There are no custom extensions, no added fields and no added methods, so any standard Yellowstone client connects unchanged and there is nothing proprietary to install.
## Access
Solana gRPC streaming is available as an add-on. Onboarding runs through the Uniblock team: provisioning is handled per customer, and the endpoint and credential are issued during setup.
Onboarding for the Solana gRPC add-on runs through the Uniblock team.
## Pricing
Solana gRPC streaming is billed on data transferred, at \$50 USD per TB, with partial terabytes rounded up. Enterprise discounts are available.
Replayed data is metered the same as live data, so a full-window catch-up bills like the equivalent live stream. Narrow filters and `accounts_data_slice` are the levers that reduce transferred volume.
## Connect
### Endpoint
```plaintext theme={null}
https://solana-grpc.uniblock.dev
```
TCP 443, HTTP/2. One hostname serves both live and historical subscriptions.
### Authentication
**Solana gRPC does not use the Uniblock API key.** Streaming traffic does not pass through the Uniblock HTTP gateway, and the credential is a dedicated token issued during onboarding. The `X-API-Key` header that authenticates the Unified API, the Unified JSON-RPC endpoint and the Direct APIs has no effect on this endpoint.
The credential is a single bearer token carried in gRPC metadata under `x-token`. There is no mTLS, no basic auth, no signing step and no handshake exchange. Authorization is evaluated once, when the stream is established, and is not re-checked while a stream runs. The token is opaque, with no meaningful internal structure.
An IP allow-list is available and is configured during onboarding. It is empty by default, so a token authenticates from any address unless addresses are added.
### TLS
TLS only, on 443, against a public CA chain. No client certificate and no mTLS. The system trust store is sufficient.
```rust theme={null}
GeyserGrpcClient::build_from_shared("https://solana-grpc.uniblock.dev")?
.x_token(Some(""))?
.tls_config(ClientTlsConfig::new().with_native_roots())?
.connect().await?
```
### Stubs and client libraries
Stubs are generated from the upstream Yellowstone repository at [github.com/rpcpool/yellowstone-grpc](https://github.com/rpcpool/yellowstone-grpc). Uniblock distributes no `.proto` of its own.
| File | Path in the upstream repository |
| -------------------------------------- | --------------------------------------------------- |
| Service and streaming messages | `yellowstone-grpc-proto/proto/geyser.proto` |
| Transaction and block types it imports | `yellowstone-grpc-proto/proto/solana-storage.proto` |
`geyser.proto` declares `package geyser` and imports `solana-storage.proto` publicly, so generating from `geyser.proto` alone pulls in both. Stubs generated from the earlier v11 protos are wire-identical across all 26 streaming messages and remain compatible.
| Language | Client |
| -------------------------- | ------------------------------------------------------------- |
| Rust | crates `yellowstone-grpc-client` and `yellowstone-grpc-proto` |
| Go | `examples/golang` in the upstream repository |
| TypeScript, Python, others | `examples/` in the upstream repository |
## What streams
Five update kinds are produced: **accounts, transactions, slots, entries and block metadata**, at `PROCESSED`, `CONFIRMED` or `FINALIZED`. Each update is delivered once. Slot status transitions and block metadata each arrive a single time per slot.
Every update carries `filters`, the list of filter names that matched it, and `created_at`, a server-side `google.protobuf.Timestamp`. One update lists every filter name it matched, so a single message can satisfy more than one filter.
**Two filters are accepted and never produce data.** `blocks` and `transactions_status` are validated and held on the subscription, and neither ever fires. A subscription using only those filters receives nothing and reports no error. `transactions` covers the transaction status case. `blocks_meta` combined with `transactions` covers the block case.
### Methods
All eight RPCs are implemented. `Subscribe` is the bidirectional stream. The seven unary methods answer from the same data the stream is built on, so a client holding a stream reads a blockhash or a slot without opening a JSON-RPC connection.
| Method | Kind |
| --------------------- | -------------------- |
| `Subscribe` | bidirectional stream |
| `SubscribeReplayInfo` | unary |
| `Ping` | unary |
| `GetLatestBlockhash` | unary |
| `GetBlockHeight` | unary |
| `GetSlot` | unary |
| `IsBlockhashValid` | unary |
| `GetVersion` | unary |
## Filters
Each filter map key is an independent entry. An update is delivered if **any** entry matches it fully, and within one entry every populated field must hold. Sub-filters belong to their own entry and never gate frames matched by a different entry.
The consequence in practice: a subscription carrying thirty owner filters plus one narrow `memcmp` filter receives everything the thirty owners produce, plus the `memcmp` matches. The `memcmp` does not narrow the other thirty. Constraints that must apply together belong in a single entry.
The map key is a label. It comes back in `filters` to tell streams apart and is never compared against chain data. The addresses do the matching.
### Transaction filters
`SubscribeRequestFilterTransactions`:
| Field | Semantics when set |
| ------------------ | ---------------------------------------------- |
| `vote` | delivered only if `is_vote` equals this |
| `failed` | delivered only if the failure flag equals this |
| `account_include` | the transaction touches at least one of these |
| `account_exclude` | the transaction touches none of these |
| `signature` | exact signature match |
| `account_required` | the transaction touches every one of these |
An unset field is not a constraint, and an empty list is the same as unset. Leaving every field unset is a wildcard that streams every transaction, which is permitted and is how a firehose subscription is expressed. `account_include` is an OR across addresses. `account_required` is the AND version, which suits pinning a program and pool pair. Vote transactions dominate the raw feed by volume, so `vote: false` and `failed: false` is the usual starting point.
### Account filters
`SubscribeRequestFilterAccounts`:
| Field | Semantics |
| ------------------------ | ----------------------------------------------------------------------- |
| `account` | match these account addresses |
| `owner` | match accounts owned by these programs |
| `filters` | repeated sub-filters, all of which must hold, maximum 4 |
| `nonempty_txn_signature` | require, or require the absence of, an associated transaction signature |
Sub-filters, from `SubscribeRequestFilterAccountsFilter`:
| Sub-filter | Shape | Notes |
| --------------------- | -------------------------------------------------- | -------------------------------- |
| `memcmp` | `offset` plus one of `bytes`, `base58` or `base64` | data capped at 128 bytes decoded |
| `datasize` | account data length in bytes | may appear once per entry |
| `lamports` | one of `eq`, `ne`, `lt`, `gt` | `cmp` must be set |
| `token_account_state` | SPL token account state | **not supported, rejected** |
`memcmp` requires decoding account data and is the expensive one. `owner` or `datasize` as the first cut, with `memcmp` refining inside the same entry, costs less.
### Slot, entry and block metadata filters
`SubscribeRequestFilterSlots` takes `filter_by_commitment`, which delivers only slot updates whose status matches the requested commitment, and `interslot_updates`, which controls whether the intermediate transitions arrive. `SubscribeRequestFilterEntry` and `SubscribeRequestFilterBlocksMeta` are empty messages, so a named entry subscribes to the whole kind.
### Encoding
Pubkeys, owners, signatures and hashes are raw bytes on the wire. Filters are given as base58 strings. Forgetting to encode when logging and decode when filtering is the most common cause of a filter that matches nothing.
### Reducing payload size
`accounts_data_slice` is a repeated `{offset, length}` on the request rather than on a filter. When present, account updates are re-encoded so `data` carries only the requested ranges. For a subscription watching one field in a large account layout this is the difference between kilobytes and tens of bytes per update, and it is the cheapest bandwidth reduction available.
### Cardinality limits
Checked when a `SubscribeRequest` arrives, on live and historical subscriptions alike. Exceeding one ends the stream with `INVALID_ARGUMENT` and a message naming the limit.
| Limit | Value |
| ------------------------------ | --------------------------------------------------------------------------- |
| Transaction filter entries | 64, counting `transactions` and `transactions_status` together |
| Account filter entries | 64 |
| Pubkeys per transaction filter | 100,000, across `account_include`, `account_exclude` and `account_required` |
| Pubkeys per account filter | 100,000, across `account` and `owner` |
| Sub-filters per account entry | 4 |
| Wildcard subscriptions | Allowed, for both transactions and accounts |
The 64 counts distinct named map keys rather than addresses, so one entry holding several thousand pubkeys is one entry. The 100,000 ceiling is theoretical, because a request that large exceeds the 4 MB message cap first.
### Rejection rather than silent widening
An address that fails base58 decoding, a signature of the wrong length, a `lamports` sub-filter with no comparator, a `datasize` given twice, an oversized `memcmp` payload and an unsupported `token_account_state` all end the subscription with `INVALID_ARGUMENT` and a message naming the offending field and value.
A filter entry that lost its only address constraint would be a wildcard over the whole kind, so the request fails rather than quietly turning a narrow subscription into a firehose.
### A worked request
Non-vote, non-failed transactions touching two programs, plus slot updates:
```rust theme={null}
SubscribeRequest {
transactions: HashMap::from([
(
"pump-amm".to_string(),
SubscribeRequestFilterTransactions {
vote: Some(false),
failed: Some(false),
account_include: vec![
"pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA".to_string(),
],
..Default::default()
},
),
(
"raydium-v4".to_string(),
SubscribeRequestFilterTransactions {
vote: Some(false),
failed: Some(false),
account_include: vec![
"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8".to_string(),
],
..Default::default()
},
),
]),
slots: HashMap::from([("slots".to_string(), SubscribeRequestFilterSlots::default())]),
commitment: Some(CommitmentLevel::Processed as i32),
..Default::default()
}
```
Updates arrive with `filters: ["pump-amm"]`, `filters: ["raydium-v4"]` or `filters: ["slots"]`. A transaction touching both programs lists both names.
## Commitment and slot status
Commitment is set once per request through the `commitment` field and applies to the whole subscription. Three levels are accepted: `PROCESSED`, `CONFIRMED` and `FINALIZED`.
Commitment promotion is buffered per slot rather than re-fetched, so a `CONFIRMED` or `FINALIZED` subscriber receives the same bytes the `PROCESSED` subscriber saw, promoted when the status transition arrives.
A slot's fate is reported by `SubscribeUpdateSlot.status`:
| Value | Meaning |
| --------------------------- | --------------------------------- |
| `SLOT_FIRST_SHRED_RECEIVED` | first shred seen |
| `SLOT_CREATED_BANK` | bank created |
| `SLOT_PROCESSED` | processed |
| `SLOT_COMPLETED` | all shreds received |
| `SLOT_CONFIRMED` | confirmed |
| `SLOT_FINALIZED` | finalized, terminal |
| `SLOT_DEAD` | abandoned, reason in `dead_error` |
Slots are never retracted and a replaced slot is not re-sent. A fork-aware client follows these transitions, treats anything below `SLOT_FINALIZED` as provisional, and unwinds work built on a slot that reports `SLOT_DEAD`. `interslot_updates` on a slot filter delivers the intermediate transitions rather than only the commitment-level ones. Each status fires once per slot.
## Historical replay
Replay is triggered by setting `from_slot` on a `SubscribeRequest`. It is field 11 of the stock upstream message, so no special client, no SDK and no separate endpoint is involved. The stream replays forward from that slot and tails into live on the same connection, with no second reconnect and no gap.
| | Value |
| -------------------------- | ---------------------- |
| Retention window | 48 hours |
| Concurrent replay sessions | 64 |
| Catch-up rate | Capped at 10x realtime |
`SubscribeReplayInfo` returns `first_available`, the oldest slot currently held. The window drifts above the 48 hour floor because pruning runs on a schedule rather than instantly, so `first_available` is the value to branch on in code and 48 hours is the figure to plan against.
The 64 session limit applies per customer rather than across the platform. Beyond it, a new replay subscription receives `grpc-status: 8` and a retry message. Live subscriptions are never affected by replay load.
**Account updates are not retained.** A `from_slot` subscription carrying an `accounts` filter returns nothing for the historical portion and begins delivering at the live edge. Transactions, entries, blocks and block metadata are retained.
Every filter applies to replayed data exactly as it applies to live data. Addresses, owners, data size, lamports, the vote and failed flags, `memcmp` sub-filters and exact `signature` matching all behave identically on either path.
A `from_slot` older than the retained window is rejected with `grpc-status: 11` and a message naming the oldest slot still held. The available window is read out of that message rather than by retrying the same slot, because a reconnect loop that always sets the same `from_slot` after a rejection spins forever.
The 10x cap is a real constraint on catching up. A full day of history takes roughly two and a half hours to replay. A subscription that needs to be current quickly starts from a nearer `from_slot`.
## Limits and client behavior
### Message sizes
| Direction | Limit |
| ------------------------------------- | ---------- |
| Client to server (`SubscribeRequest`) | 4 MB |
| Server to client (`SubscribeUpdate`) | Not capped |
A `SubscribeRequest` over 4 MB is rejected and the stream ends with a status rather than staying open.
Because outbound messages are not capped, the binding constraint is the client's own decode limit. Most gRPC stacks default to 4 MB. A subscription covering large accounts or busy blocks raises `max_decoding_message_size` on the Yellowstone client builder rather than relying on that default.
### Subscriptions and connections
One `SubscribeRequest` per stream, replaceable in place: sending another replaces the active filter without reconnecting. A request carrying only `ping` is not treated as a filter update. There is no per-credential connection cap, and `max_concurrent_streams` is unset, so subscriptions multiplex freely over one connection.
### Compression
Compression is not enabled and not negotiated. The server advertises no accepted or sent encodings, so every stream is uncompressed protobuf regardless of what a client offers in `grpc-accept-encoding`.
### Keepalives
A `SubscribeUpdate` carrying `UpdateOneof::Ping` arrives on every stream every 15 seconds, including idle ones, so a filtered subscription that matches nothing still survives NAT and load-balancer idle timeouts. It is a keepalive and does not count as data. Keepalives carry `created_at` like every other update, so staleness computed from that field needs no special case.
There is no server-side idle timeout. A stream lives until the client ends it, the connection breaks, or the client falls behind.
`Ping` and `Pong` also exist as a client-initiated pair: a `SubscribeRequest` carrying only `ping` with an id returns the same id as `SubscribeUpdatePong`.
### Falling behind
**Drops are not signaled.** There is no dropped-message count, no gap marker and no error status. When a client cannot keep up, its queue fills, the server removes it, and the stream simply ends. A client that logs only gRPC errors sees nothing at all, so an unexpected clean end of stream means the client fell behind rather than a normal shutdown.
Ordinary HTTP/2 flow control applies first. A slow reader stalls its own stream and affects neither other streams on its connection nor other subscribers. The stream closes only once the per-client queue fills and does not recover.
Remedies, in the order they usually work: move processing off the thread that drains the stream, narrow the filter, apply `accounts_data_slice` to cut payload size, read faster.
### Resuming
There is no server-side cursor. Consumption is not tracked, so a reconnect starts live unless the request asks for something else. Resumption is the client's decision, through `from_slot`: track the last slot processed, set `from_slot` to it on reconnect, and the stream replays forward and tails into live on the same connection.
A client that does not need gap-free delivery reconnects with no `from_slot`. That path is cheaper and cannot fail on a retention boundary. `from_slot` resumption suits state reconciliation that genuinely cannot tolerate a hole.
## Errors and retries
Rejections carry an HTTP status, a gRPC status code, an `x-error-code` header and a `grpc-message`. `x-error-code` is stable and unique per condition and is the field to branch on. The prose is not stable and is better displayed than matched. `grpc-message` is always ` (code: )`.
| Condition | HTTP | `grpc-status` | `x-error-code` | Retry |
| --------------------------------------------------------------------- | ---- | ------------- | ----------------------- | --------------------------------------------------- |
| Token missing, invalid, expired, or from a non-allow-listed address | 401 | 16 | `UNAUTHENTICATED` | No |
| Credentials could not be verified, authentication briefly unavailable | 500 | 13 | `AUTH_UNAVAILABLE` | Yes, backoff |
| Too many distinct invalid credentials from this address | 429 | 8 | `AUTH_RATE_LIMITED` | Yes, once the block expires, with valid credentials |
| Credential checking saturated, load being shed | 503 | 14 | `AUTH_BUSY` | Yes, backoff |
| Not a gRPC request, wrong `content-type` | 415 | 3 | `INVALID_CONTENT_TYPE` | No |
| No node currently available | 503 | 14 | `NO_CAPACITY` | Yes, backoff |
| All nodes briefly out of service | 503 | 14 | `UPSTREAMS_UNAVAILABLE` | Yes, backoff |
| Node did not complete the request | 502 | 14 | `UPSTREAM_ERROR` | Yes, backoff |
`UNAUTHENTICATED` covers a missing token, an invalid one, an expired one and a disallowed source address under one code, so a report of it is checked against the IP allow-list as well as against the credential.
`AUTH_RATE_LIMITED` counts distinct invalid credentials from one address rather than failed attempts. A client stuck in a reconnect loop with one stale or revoked token retries it indefinitely without being blocked, and keeps receiving `UNAUTHENTICATED`. It is a configuration error to surface rather than a transient to retry.
Conditions raised on the streaming path carry a status and a message but no `x-error-code`:
| Condition | `grpc-status` | Retry |
| -------------------------------------------- | ------------------------- | --------------------------------------------------- |
| Too many transaction filters, maximum 64 | 3 | No. Narrow the filter |
| Too many account filters, maximum 64 | 3 | No |
| Too many pubkeys, maximum 100,000 | 3 | No |
| Malformed address, signature or sub-filter | 3 | No. The message names the offending field and value |
| `SubscribeRequest` above 4 MB | 3 | No |
| `from_slot` older than the retained window | 11 | No. Resubscribe from the slot named in the message |
| Replay session capacity reached | 8 | Yes, backoff |
| No `SubscribeRequest` within 30 s of opening | 1 | Yes |
| Client fell behind and its queue filled | none, clean end of stream | Reconnect |
| Connection dropped before the TLS handshake | none, connection failure | Yes, backoff |
Both `OUT_OF_RANGE` wordings name the oldest retained slot, so parsing for `retained from` is more reliable than matching either string whole.
### Backoff
Statuses 13 and 14 retry with exponential backoff starting at 100 ms, capped at 30 seconds, with jitter. That covers `AUTH_UNAVAILABLE`, `AUTH_BUSY`, `NO_CAPACITY`, `UPSTREAMS_UNAVAILABLE` and `UPSTREAM_ERROR`. Status 8 carrying the replay capacity message retries the same way, as does a bare connection failure.
Retrying 16 or 3 without changing the credential or the request repeats the same failure. On 11, the available window is read out of the message and the subscription resumes from there.
# debug_accountRange
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-account-range
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the accounts within a specific key range for the given block state.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier, startKey, maxResults, context?].
Positional parameters for debug\_accountRange:
params\[0]: Block number or hash at which to inspect state (hex quantity or 32-byte hash).
params\[3]: Optional context returned from a previous call to continue iteration.
### Returns
Account range response including account details and continuation token.
Next account key to resume iteration, or null if complete.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_accountRange",
"params": [
"",
"",
0,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_chaindbCompact
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-chaindb-compact
POST https://api.uniblock.dev/uni/v1/json-rpc
Triggers LevelDB compaction for the chain database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
True if compaction finished successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_chaindbCompact",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_chaindbProperty
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-chaindb-property
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns diagnostic information about the chain database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[property].
Positional parameters for debug\_chaindbProperty:
params\[]: Name of the database property to query (e.g., "leveldb.stats").
### Returns
Property value returned by the key-value store.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_chaindbProperty",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncient
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-db-ancient
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the ancient (freezer) data item at the given index for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table, index].
Positional parameters for debug\_dbAncient:
params\[0]: Ancient table name (e.g., "headers", "bodies").
params\[1]: Zero-based index within the ancient table.
### Returns
Hex-encoded RLP payload stored at the requested slot.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncient",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncients
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-db-ancients
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the number of ancient entries stored for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table].
Positional parameters for debug\_dbAncients:
params\[]: Ancient table name.
### Returns
Count of stored ancient items. Example: 1024.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncients",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": 1024
}
```
# debug_gcStats
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-gc-stats
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns garbage collection statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Garbage collection stats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_gcStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getAccessibleState
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-get-accessible-state
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the oldest block whose state is still retained locally.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Hex block number representing the earliest accessible state. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getAccessibleState",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-get-bad-blocks
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_getModifiedAccountsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-get-modified-accounts-by-hash
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the addresses of accounts modified by the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for debug\_getModifiedAccountsByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getModifiedAccountsByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-get-modified-accounts-by-number
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the addresses of accounts modified in the specified block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for debug\_getModifiedAccountsByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByNumber",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getRawBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-get-raw-block
POST https://api.uniblock.dev/uni/v1/json-rpc
Retrieves and returns the RLP encoded block by number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawBlock: \[blockNrOrHash].
Positional parameters for debug\_getRawBlock:
params\[]: The block number or hash.
### Returns
The RLP encoded data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawBlock",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawHeader
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-get-raw-header
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns an RLP-encoded header.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[blockNrOrHash].
Positional parameters for debug\_getRawHeader:
params\[]: The block number or hash.
### Returns
The RLP encoded header data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawHeader",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-get-raw-receipts
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the consensus-encoding of all receipts in a single block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawReceipts: \[blockNrOrHash].
Positional parameters for debug\_getRawReceipts:
params\[]: The block number or hash.
### Returns
The consensus-encoding of all receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawReceipts",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-get-raw-transaction
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the bytes of the transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[transactionHash].
Positional parameters for debug\_getRawTransaction:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
The bytes of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_goTrace
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-go-trace
POST https://api.uniblock.dev/uni/v1/json-rpc
Starts a Go execution trace and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_goTrace:
params\[0]: Destination file for the execution trace.
params\[1]: Duration to trace in seconds.
### Returns
True if tracing completed successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_goTrace",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_intermediateRoots
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-intermediate-roots
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the intermediate state trie roots for each transaction in the given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier].
Positional parameters for debug\_intermediateRoots:
params\[]: Block number or hash in hex.
### Returns
State root hashes after each transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_intermediateRoots",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_memStats
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-mem-stats
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns current runtime memory statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Statistics mirroring Go runtime.MemStats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_memStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_mutexProfile
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-mutex-profile
POST https://api.uniblock.dev/uni/v1/json-rpc
Captures mutex contention profile information and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_mutexProfile:
params\[0]: Destination file for the mutex profile.
params\[1]: Duration to capture in seconds.
### Returns
True if the mutex profile was written successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_mutexProfile",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_printBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-print-block
POST https://api.uniblock.dev/uni/v1/json-rpc
Pretty-prints the specified block for human inspection.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier].
Positional parameters for debug\_printBlock:
params\[]: Block number or hash.
### Returns
True if the block information was written to the log output. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_printBlock",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_stacks
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-stacks
POST https://api.uniblock.dev/uni/v1/json-rpc
Collects and writes all goroutine stack traces to the given file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath].
Positional parameters for debug\_stacks:
params\[]: Destination file path.
### Returns
True if stack traces were written. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_stacks",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_storageRangeAt
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-storage-range-at
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the storage at the given block height and transaction index. The result can be paged by providing a maxResult to cap the number of storage slots returned as well as specifying the offset via keyStart (hash of storage key).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, txIdx, contractAddress, keyStart, maxResult]
Positional parameters for debug\_storageRangeAt:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Index of the transaction within the block.
params\[2]: 20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
params\[3]: Starting key (32-byte hex string) used for filtering storage or entries.
params\[4]: Maximum number of results to return.
### Returns
The array of storage items.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": [
"0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
0,
"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"0x0000000000000000000000000000000000000000000000000000000000000000",
1
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBadBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-trace-bad-block
POST https://api.uniblock.dev/uni/v1/json-rpc
Executes the transactions in a bad block and returns the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, options?].
Positional parameters for debug\_traceBadBlock:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBadBlock",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-trace-block
POST https://api.uniblock.dev/uni/v1/json-rpc
The traceBlock method will return a full stack trace of all invoked opcodes of all transaction that were included in this block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_traceBlock: \[blockRlp, traceConfig].
Positional parameters for debug\_traceBlock:
params\[0]: The RLP encoded block.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlock",
"params": [
"RLP_ENCODED_BLOCK",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-trace-block-by-hash
POST https://api.uniblock.dev/uni/v1/json-rpc
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-trace-block-by-number
POST https://api.uniblock.dev/uni/v1/json-rpc
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-trace-call
POST https://api.uniblock.dev/uni/v1/json-rpc
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceCallMany
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-trace-call-many
POST https://api.uniblock.dev/uni/v1/json-rpc
Executes a list of bundles (a bundle is a collection of transactions), without creating transactions on the blockchain. Returns their traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for debug\_traceCallMany. 1. Bundles (required): an array of bundles. Each bundle is an object with: - transactions: an array of transaction objects (each with fields such as from, to, value, data), - blockOverride (optional): an object with overrides (blockNumber, blockHash mapping, coinbase, timestamp, difficulty, gasLimit, baseFee). 2. Simulation context (required): an object with blockIdentifier (a hex block number or one of "latest", "earliest", "pending", "safe", "finalized") and transactionIndex (integer, default -1). 3. State overrides (optional): an object mapping addresses to state override objects (here, at least a balance override as a hex string). 4. Timeout (optional): integer timeout in milliseconds (default 5000). 5. Trace type (optional): an object with tracer (string, enum: callTracer, prestateTracer), tracerConfig (object), and onlyTopCall (boolean).
Positional parameters for debug\_traceCallMany:
params\[0]: List of bundles. Each bundle is an object with transactions and an optional blockOverride.
params\[1]: Simulation context. Contains blockIdentifier (a hex block number or tag) and transactionIndex (default -1).
params\[2]: Optional state overrides: a mapping from address to an override object (e.g. balance).
### Returns
Array of trace responses corresponding to each simulated bundle. Each trace response is one of: callTracer response, prestateTracer response, or opcode (struct) response.
CallTracer response.
CallTracer response.
Type of the call.
Sender address.
Recipient address.
Gas provided by the sender.
Actual value deducted from the sender (per gas).
Total gas used by the call.
Input data (4-byte method selector).
Return value (hex).
Error message if execution failed.
List of sub-calls (nested call frames).
A nested call frame with additional details.
Revert reason, if available.
PrestateTracer response.
Smart contract address associated with the result.
Balance of the contract in wei (hex).
Bytecode of the contract (hex).
Nonce of the contract account.
Mapping of storage slots (hex keys and values).
Opcode (struct) trace response.
Indicates whether the execution failed.
Total consumed gas (hex).
Return value of the executed call (hex).
Array of execution step logs.
Program counter.
Operation name.
Available gas at this step.
Gas cost of the operation.
Call depth.
Stack values at this step.
Storage state at this step.
Refund amount (hex).
Error message, if any.
Memory snapshot at this step (array of hex strings).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCallMany",
"params": [
[],
{},
{},
5000,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1/debug/debug-trace-transaction
POST https://api.uniblock.dev/uni/v1/json-rpc
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# erigon_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1/erigon/erigon-block-number
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_forks
Source: https://docs.uniblock.dev/reference/jsonrpc/1/erigon/erigon-forks
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_forks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getBlockByTimestamp
Source: https://docs.uniblock.dev/reference/jsonrpc/1/erigon/erigon-get-block-by-timestamp
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getBlockByTimestamp",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getBlockReceiptsByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1/erigon/erigon-get-block-receipts-by-block-hash
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getBlockReceiptsByBlockHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getHeaderByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1/erigon/erigon-get-header-by-hash
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getHeaderByHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getHeaderByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1/erigon/erigon-get-header-by-number
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getHeaderByNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getLatestLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1/erigon/erigon-get-latest-logs
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getLatestLogs",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getLogsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1/erigon/erigon-get-logs-by-hash
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getLogsByHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# Ethereum (ETH) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/1/ethereum-overview
Ethereum is an EVM-compatible mainnet. Its ticker symbol is `ETH`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Ethereum
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=1`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=1' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ---------------- | ------ | ------- | ---------- |
| Ethereum | `ETH` | Mainnet | `1` |
| Ethereum Holesky | `ETH` | Testnet | `17000` |
| Ethereum Hoodi | `ETH` | Testnet | `560048` |
| Ethereum Sepolia | `ETH` | Testnet | `11155111` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/1/debug/debug-account-range)
* [Erigon](/reference/jsonrpc/1/erigon/erigon-block-number)
* [EVM](/reference/jsonrpc/1/evm/eth-accounts)
* [Otterscan](/reference/jsonrpc/1/otterscan/ots-get-api-level)
* [Parity](/reference/jsonrpc/1/parity/parity-enode)
* [Trace](/reference/jsonrpc/1/trace/trace-block)
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-accounts
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_baseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-base-fee
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the base fee for the next block, in hexadecimal format representing wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
Hex-encoded base fee for the next block (in wei). Example: "0x2e90edd000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_baseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2e90edd000"
}
```
# eth_blobBaseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-blob-base-fee
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the expected base fee for blobs in the next block, in wei (hexadecimal format).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The expected blob base fee for the next block (QUANTITY in wei, 64 bits). Example: "0x174876e800".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blobBaseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x174876e800"
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-block-number
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-call
POST https://api.uniblock.dev/uni/v1/json-rpc
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-call-many
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_callMany",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-chain-id
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-coinbase
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-create-access-list
POST https://api.uniblock.dev/uni/v1/json-rpc
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-estimate-gas
POST https://api.uniblock.dev/uni/v1/json-rpc
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-fee-history
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-gas-price
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getAccount
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-account
POST https://api.uniblock.dev/uni/v1/json-rpc
Retrieves detailed account information for a given address at a specific block number or tag.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, blockReference]
Positional parameters for eth\_getAccount:
params\[0]: The address of the account (20-byte hex string).
params\[1]: Block reference: block number in hex, integer, or tag ("latest", "pending", "safe", "finalized").
### Returns
Account information at the specified block.
32-byte hash of the account’s code.
Hash of the account’s storage trie.
Account balance in wei (hexadecimal).
Number of transactions sent from the account.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getAccount",
"params": [
"0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"codeHash": "0x3f30cbb24e7a53efc981dcf566da48e6e9b5418d26c4763fdb4e83e7bcd0c9c5",
"storageRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"balance": "0x38d7ea4c68000",
"nonce": "0x10"
}
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-balance
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-block-by-hash
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-block-by-number
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-block-receipts
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-block-transaction-count-by-hash
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-block-transaction-count-by-number
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-code
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-filter-changes
POST https://api.uniblock.dev/uni/v1/json-rpc
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-filter-logs
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-logs
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-proof
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getRawTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-raw-transaction-by-block-hash-and-index
POST https://api.uniblock.dev/uni/v1/json-rpc
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockHashAndIndex:
params\[0]: The hash of the block containing the transaction.
params\[1]: The index position of the transaction in the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the signature. Example: "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockHashAndIndex",
"params": [
"0x7e4aea365093a183b0df5f003f26144ef04ec8a6e7f4910356590c5fc7b1671f",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b..."
}
```
# eth_getRawTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-raw-transaction-by-block-number-and-index
POST https://api.uniblock.dev/uni/v1/json-rpc
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockNumberAndIndex:
params\[0]: The block number (hex string or tag like "latest", "finalized", "safe").
params\[1]: The index of the transaction within the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the full signed transaction. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockNumberAndIndex",
"params": [
"0x10fb78",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getRawTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-raw-transaction-by-hash
POST https://api.uniblock.dev/uni/v1/json-rpc
Retrieves the raw transaction data as a hexadecimal string for the given transaction hash, including all signature components.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionHash]
Positional parameters for eth\_getRawTransactionByHash:
params\[]: The hash of the transaction (32-byte hex string).
### Returns
Raw transaction data in hexadecimal format, including sender, recipient, gas, data, and signature. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-storage-at
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-transaction-by-block-hash-and-index
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-transaction-by-block-number-and-index
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-transaction-by-hash
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-transaction-count
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-transaction-receipt
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-uncle-by-block-hash-and-index
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-uncle-by-block-number-and-index
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-uncle-count-by-block-hash
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-uncle-count-by-block-number
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getWork
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-get-work
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the hash of the current block, the seedHash, and the boundary condition to be met (“target”).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array returned by eth\_getWork. Contains \[powHash, seedHash, boundary, blockNumber].
32-byte current block header pow-hash.
32-byte current block header pow-hash.
32-byte seed hash used for the DAG.
32-byte boundary condition (target = 2^256 / difficulty).
Quantity - current block number (hex string).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getWork",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"0x5EED00000000000000000000000000005EED0000000000000000000000000000",
"0xd1ff1c01710000000000000000000000d1ff1c01710000000000000000000000",
"0x1"
]
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-hashrate
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-max-priority-fee-per-gas
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-mining
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-new-block-filter
POST https://api.uniblock.dev/uni/v1/json-rpc
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-new-filter
POST https://api.uniblock.dev/uni/v1/json-rpc
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-new-pending-transaction-filter
POST https://api.uniblock.dev/uni/v1/json-rpc
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-protocol-version
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendPrivateTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-send-private-transaction
POST https://api.uniblock.dev/uni/v1/json-rpc
Sends a signed transaction to a private relay (like Flashbots Protect) for inclusion in a block without exposure to the public mempool. Provides frontrunning and revert protection.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionPayload]
Positional parameters for eth\_sendPrivateTransaction:
params\[]: Payload object containing raw transaction and optional execution constraints.
### Returns
Returns true if the transaction was successfully accepted, false otherwise. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendPrivateTransaction",
"params": [
{
"tx": "0xf86c808504a817c80082520894a0df350d2637096571f7a701cb5b1660d90cecb380b844a9059cbb000000000000000000000000b60e8dd61c5d32be8058bb8eb970870f07233155",
"maxBlockNumber": "0x10fb80",
"preferences": {
"fast": true
}
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-send-raw-transaction
POST https://api.uniblock.dev/uni/v1/json-rpc
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sendTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-send-transaction
POST https://api.uniblock.dev/uni/v1/json-rpc
Creates new message call transaction or a contract creation, if the data field contains code.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendTransaction: \[transactionObject]
Positional parameters for eth\_sendTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sign
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-sign
POST https://api.uniblock.dev/uni/v1/json-rpc
The sign method calculates an Ethereum specific signature with: sign(keccak256("Ethereum Signed Message: " + len(message) + message))).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sign: \[address, data].
Positional parameters for eth\_sign:
params\[0]: The address.
params\[1]: Data which hash to sign.
### Returns
Data - Signed data. Example: "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a539310c6ecd1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sign",
"params": [
"0xcd2a3d9f938e13cd947ec05abc7fe734df8dd826",
"0x5363686f6f6c627573"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a5..."
}
```
# eth_signTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-sign-transaction
POST https://api.uniblock.dev/uni/v1/json-rpc
Signs transactions without dispatching it to the network. It can be later submitted using eth_sendRawTransaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_signTransaction: \[transactionObject]
Positional parameters for eth\_signTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
Signed transaction and its details.
Data - The signed, RLP encoded transaction.
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_signTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"raw": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
"tx": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
}
```
# eth_simulateV1
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-simulate-v1
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_simulateV1",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_submitHashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-submit-hashrate
POST https://api.uniblock.dev/uni/v1/json-rpc
Used for submitting mining hashrate.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_submitHashrate: \[hashrate, id].
Positional parameters for eth\_submitHashrate:
params\[0]: Data - a hexadecimal string representation (32 bytes) of the hash rate.
params\[1]: Data - A random hexadecimal(32 bytes) ID identifying the client.
### Returns
Boolean - Returns true if submitting hash rate was successful. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_submitHashrate",
"params": [
"0x0000000000000000000000000000000000000000000000000000000000500000",
"0x59daa26581d0acd1fce254fb7e85952f4c09d0915afd33d3886cd914bc7d283c"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_submitWork
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-submit-work
POST https://api.uniblock.dev/uni/v1/json-rpc
Used for submitting a proof-of-work solution.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_submitWork: \[nonce, powHash, mixHash].
Positional parameters for eth\_submitWork:
params\[0]: 8 Bytes - The nonce found (64 bits).
params\[1]: 32 Bytes - The header’s pow-hash (256 bits)
params\[2]: Data - 32 Bytes - The mix digest (256 bits).
### Returns
Boolean - returns true if the provided solution is valid, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_submitWork",
"params": [
"0x0000000000000001",
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"0xD1FE5700000000000000000000000000D1FE5700000000000000000000000000"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_subscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-subscribe
POST https://api.uniblock.dev/uni/v1/json-rpc
Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_subscribe: \[subscriptionType, options]. The second parameter is required only for "logs".
Positional parameters for eth\_subscribe:
params\[0]: Subscription type. Must be either "newHeads" or "logs".
params\[1]: Filter options for "logs" subscription, or empty object for "newHeads".
### Returns
Assigned subscription ID Example: "0xb53c4832f1dca4a5".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_subscribe",
"params": [
"logs",
{
"fromBlock": "latest",
"toBlock": "latest"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb53c4832f1dca4a5"
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-syncing
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-uninstall-filter
POST https://api.uniblock.dev/uni/v1/json-rpc
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/eth-unsubscribe
POST https://api.uniblock.dev/uni/v1/json-rpc
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/net-listening
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/net-peer-count
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/net-version
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/txpool-content
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# txpool_contentFrom
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/txpool-content-from
POST https://api.uniblock.dev/uni/v1/json-rpc
Retrieves the pending and queued transactions from the txpool that were sent by the specified address, grouped by nonce.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Array containing the address to filter transactions by.
Positional parameters for txpool\_contentFrom:
params\[]: The sender address (20-byte hex string).
### Returns
Pending and queued transactions for the specified address.
List of pending transactions grouped by nonce.
List of queued transactions grouped by nonce.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_contentFrom",
"params": [
"0x9431D1615FA755Faa25A74da7f34C8Bd6963bd0A"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# txpool_inspect
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/txpool-inspect
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns a human-readable summary of all pending and queued transactions in the txpool. Supported only on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept parameters.
### Returns
Textual summaries of pending and queued transactions indexed by sender and nonce.
Pending transactions indexed by sender address and nonce.
Queued transactions indexed by sender address and nonce.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_inspect",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# txpool_status
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/txpool-status
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the number of transactions in the pending and queued state in the txpool. Supported only on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept parameters.
### Returns
Summary of transaction counts in the txpool.
Total number of pending transactions in hex format.
Total number of queued transactions in hex format.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_status",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/web3-client-version
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/1/evm/web3-sha3
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# ots_getApiLevel
Source: https://docs.uniblock.dev/reference/jsonrpc/1/otterscan/ots-get-api-level
POST https://api.uniblock.dev/uni/v1/json-rpc
Very simple API versioning scheme. Every time we add a new capability, the number is incremented. This allows for Otterscan to check if the Erigon node contains all API it needs.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Number - containing the API version.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getApiLevel",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": 0
}
```
# ots_getBlockDetails
Source: https://docs.uniblock.dev/reference/jsonrpc/1/otterscan/ots-get-block-details
POST https://api.uniblock.dev/uni/v1/json-rpc
Given a block number, return its data. Similar to the standard eth_getBlockByNumber/Hash method, but optimized.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for ots\_getBlockDetails: \[blockNumber].
Positional parameters for ots\_getBlockDetails:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Modified block object with additional fields and stripped transaction list.
Block data (similar to eth\_getBlockByNumber/Hash but modified).
Block number (hex quantity) or null if pending.
Block hash or null if pending.
Always null in this format to reduce bandwidth.
Base fee per gas (EIP-1559 blocks only).
Number of transactions in the block (as a hex quantity).
Issuance details for the block.
Block reward issued to the miner.
Total uncle rewards.
Total ETH issued (blockReward + uncleReward).
Total fees paid by senders in this block (includes base fee; not all fees go to miner).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getBlockDetails",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# ots_getBlockDetailsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1/otterscan/ots-get-block-details-by-hash
POST https://api.uniblock.dev/uni/v1/json-rpc
Given a block hash, return its data. Similar to the standard eth_getBlockByNumber/Hash method, but optimized.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for ots\_getBlockDetailsByHash: \[blockHash].
Positional parameters for ots\_getBlockDetailsByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Modified block object with additional fields and stripped transaction list.
Block data (similar to eth\_getBlockByNumber/Hash but modified).
Block number (hex quantity) or null if pending.
Block hash or null if pending.
Always null in this format to reduce bandwidth.
Base fee per gas (EIP-1559 blocks only).
Number of transactions in the block (as a hex quantity).
Issuance details for the block.
Block reward issued to the miner.
Total uncle rewards.
Total ETH issued (blockReward + uncleReward).
Total fees paid by senders in this block (includes base fee; not all fees go to miner).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getBlockDetailsByHash",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# ots_getBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/1/otterscan/ots-get-block-transactions
POST https://api.uniblock.dev/uni/v1/json-rpc
Gets paginated transaction data for a certain block. Think of an optimized eth_getBlockBy* + eth_getTransactionReceipt.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for ots\_getBlockTransactions: \[defaultBlock].
Positional parameters for ots\_getBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Block object with full transactions and their receipts, optimized for pagination. Includes truncated input data and simplified receipts.
Block number (hex quantity).
Hash of the block.
List of transaction bodies with truncated input fields.
Only the 4-byte method selector is included.
List of simplified receipts matching the order of the transactions.
Logs are omitted to save bandwidth.
LogsBloom is omitted to save bandwidth.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getBlockTransactions",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# ots_getContractCreator
Source: https://docs.uniblock.dev/reference/jsonrpc/1/otterscan/ots-get-contract-creator
POST https://api.uniblock.dev/uni/v1/json-rpc
Given an ETH contract address, returns the tx hash and the direct address who created the contract.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for ots\_getContractCreator: \[address].
Positional parameters for ots\_getContractCreator:
params\[]: The address.
### Returns
object containing the following attributes, or null if the address does not contain a contract. hash - The tx hash of the transaction who created the contract. creator - The address which created the contract. Note that for simple transactions that directly deploy a contract this corresponds to the EOA in the from field of the transaction. For deployer contracts, i.e., the contract is created as a result of a method call, this corresponds to the address of the contract which created it.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getContractCreator",
"params": [
"0xc0a47dFe034B400B47bDaD5FecDa2621de6c4d95"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xe881c43cd88063e84a1d0283f41ee5348239b259c0d17a7e2e4552da3f4b2bc7",
"creator": "0x6c9fc64a53c1b71fb3f9af64d1ae3a4931a5f4e9"
}
}
```
# ots_getInternalOperations
Source: https://docs.uniblock.dev/reference/jsonrpc/1/otterscan/ots-get-internal-operations
POST https://api.uniblock.dev/uni/v1/json-rpc
Trace internal ETH transfers, contract creations (CREATE/CREATE2) and self-destructs for a certain transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for the method ots\_getInternalOperations: \[txHash].
Positional parameters for ots\_getInternalOperations:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
Array of operations sorted by their occurrence inside the transaction.
Represents an individual ETH operation within a transaction.
Operation type: 0 = transfer, 1 = self-destruct, 2 = create, 3 = create2.
Sender address: ETH sender, contract creator, or contract being self-destructed.
Receiver address: ETH recipient, newly created contract address, or target of a self-destruct.
Amount of ETH transferred, in hexadecimal Wei.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getInternalOperations",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# ots_getTransactionError
Source: https://docs.uniblock.dev/reference/jsonrpc/1/otterscan/ots-get-transaction-error
POST https://api.uniblock.dev/uni/v1/json-rpc
Given a transaction hash, returns its raw revert reason.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for the method ots\_getTransactionError: \[txHash].
Positional parameters for ots\_getTransactionError:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
string containing the hexadecimal-formatted error blob or simply a "0x" if the transaction was successfully executed. It returns "0x" if it failed with no revert reason or out of gas, so make sure to analyze this return value together with the transaction success/fail result. Example: "0x08c379a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000135472616e73616374696f6e20746f6f206f6c6400000000000000000000000000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getTransactionError",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x08c379a000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000..."
}
```
# ots_hasCode
Source: https://docs.uniblock.dev/reference/jsonrpc/1/otterscan/ots-has-code
POST https://api.uniblock.dev/uni/v1/json-rpc
Check if an ETH address contains a deployed code.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for the method ots\_hasCode: \[address, defaultBlock].
Positional parameters for ots\_hasCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
boolean indicating if the address contains a bytecode or not.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_hasCode",
"params": [
"0xc0a47dFe034B400B47bDaD5FecDa2621de6c4d95",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": false
}
```
# ots_searchTransactionsAfter
Source: https://docs.uniblock.dev/reference/jsonrpc/1/otterscan/ots-search-transactions-after
POST https://api.uniblock.dev/uni/v1/json-rpc
Address history navigation method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method ots\_searchTransactionsAfter: \[address, defaultBlock, pageSize].
Positional parameters for ots\_searchTransactionsAfter:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[2]: The page size for the number of results to return.
### Returns
Paginated list of transactions and receipts for a given address before or after a specified block number.
List of transactions (inbound, outbound, or internal) touching the target address, sorted from most recent to oldest.
Transaction hash.
Sender address.
Recipient address, or null if contract creation.
Amount of ETH transferred, in hexadecimal Wei.
Method selector or calldata (possibly truncated).
Transaction type: "external", "internal", or "contract".
List of receipts corresponding to the returned transactions.
Logs are omitted to reduce payload size.
Logs bloom is omitted to reduce payload size.
True if this page starts from the most recent block (for `Before`) or if no more results follow (for `After`).
True if this page reaches the genesis block (for `After`) or no more results follow (for `Before`).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_searchTransactionsAfter",
"params": [
"0xc0a47dFe034B400B47bDaD5FecDa2621de6c4d95",
0,
5
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# ots_searchTransactionsBefore
Source: https://docs.uniblock.dev/reference/jsonrpc/1/otterscan/ots-search-transactions-before
POST https://api.uniblock.dev/uni/v1/json-rpc
Address history navigation method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method ots\_searchTransactionsBefore: \[address, defaultBlock, pageSize].
Positional parameters for ots\_searchTransactionsBefore:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[2]: The page size for the number of results to return.
### Returns
Paginated list of transactions and receipts for a given address before or after a specified block number.
List of transactions (inbound, outbound, or internal) touching the target address, sorted from most recent to oldest.
Transaction hash.
Sender address.
Recipient address, or null if contract creation.
Amount of ETH transferred, in hexadecimal Wei.
Method selector or calldata (possibly truncated).
Transaction type: "external", "internal", or "contract".
List of receipts corresponding to the returned transactions.
Logs are omitted to reduce payload size.
Logs bloom is omitted to reduce payload size.
True if this page starts from the most recent block (for `Before`) or if no more results follow (for `After`).
True if this page reaches the genesis block (for `After`) or no more results follow (for `Before`).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_searchTransactionsBefore",
"params": [
"0xc0a47dFe034B400B47bDaD5FecDa2621de6c4d95",
0,
5
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# ots_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1/otterscan/ots-trace-transaction
POST https://api.uniblock.dev/uni/v1/json-rpc
Trace a transaction and generate a trace call tree.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for ots\_traceTransaction: \[transactionHash].
Positional parameters for ots\_traceTransaction:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
object containing the trace tree.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# parity_enode
Source: https://docs.uniblock.dev/reference/jsonrpc/1/parity/parity-enode
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_enode",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# parity_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/1/parity/parity-get-block-receipts
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_getBlockReceipts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# parity_netPeers
Source: https://docs.uniblock.dev/reference/jsonrpc/1/parity/parity-net-peers
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_netPeers",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# parity_pendingTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/1/parity/parity-pending-transactions
POST https://api.uniblock.dev/uni/v1/json-rpc
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_pendingTransactions",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/1/trace/trace-block
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1/trace/trace-call
POST https://api.uniblock.dev/uni/v1/json-rpc
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/1/trace/trace-call-many
POST https://api.uniblock.dev/uni/v1/json-rpc
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/1/trace/trace-filter
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/1/trace/trace-get
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1/trace/trace-raw-transaction
POST https://api.uniblock.dev/uni/v1/json-rpc
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/1/trace/trace-replay-block-transactions
POST https://api.uniblock.dev/uni/v1/json-rpc
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1/trace/trace-replay-transaction
POST https://api.uniblock.dev/uni/v1/json-rpc
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayTransaction",
"params": [
"0x02d4a872e096445e80d05276ee756cefef7f3b376bcec14246469c0cd97dad8f",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_transaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1/trace/trace-transaction
POST https://api.uniblock.dev/uni/v1/json-rpc
Returns all traces of given transaction
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_transaction: \[transactionHash].
Positional parameters for trace\_transaction:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# debug_accountRange
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-account-range
Returns the accounts within a specific key range for the given block state.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier, startKey, maxResults, context?].
Positional parameters for debug\_accountRange:
params\[0]: Block number or hash at which to inspect state (hex quantity or 32-byte hash).
params\[3]: Optional context returned from a previous call to continue iteration.
### Returns
Account range response including account details and continuation token.
Next account key to resume iteration, or null if complete.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_accountRange",
"params": [
"",
"",
0,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_chaindbCompact
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-chaindb-compact
Triggers LevelDB compaction for the chain database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
True if compaction finished successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_chaindbCompact",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_chaindbProperty
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-chaindb-property
Returns diagnostic information about the chain database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[property].
Positional parameters for debug\_chaindbProperty:
params\[]: Name of the database property to query (e.g., "leveldb.stats").
### Returns
Property value returned by the key-value store.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_chaindbProperty",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncient
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-db-ancient
Returns the ancient (freezer) data item at the given index for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table, index].
Positional parameters for debug\_dbAncient:
params\[0]: Ancient table name (e.g., "headers", "bodies").
params\[1]: Zero-based index within the ancient table.
### Returns
Hex-encoded RLP payload stored at the requested slot.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncient",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncients
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-db-ancients
Returns the number of ancient entries stored for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table].
Positional parameters for debug\_dbAncients:
params\[]: Ancient table name.
### Returns
Count of stored ancient items. Example: 1024.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncients",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": 1024
}
```
# debug_gcStats
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-gc-stats
Returns garbage collection statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Garbage collection stats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_gcStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getAccessibleState
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-get-accessible-state
Returns the oldest block whose state is still retained locally.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Hex block number representing the earliest accessible state. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getAccessibleState",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-get-bad-blocks
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_getModifiedAccountsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-get-modified-accounts-by-hash
Returns the addresses of accounts modified by the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for debug\_getModifiedAccountsByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getModifiedAccountsByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-get-modified-accounts-by-number
Returns the addresses of accounts modified in the specified block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for debug\_getModifiedAccountsByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByNumber",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getRawBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-get-raw-block
Retrieves and returns the RLP encoded block by number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawBlock: \[blockNrOrHash].
Positional parameters for debug\_getRawBlock:
params\[]: The block number or hash.
### Returns
The RLP encoded data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawBlock",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawHeader
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-get-raw-header
Returns an RLP-encoded header.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[blockNrOrHash].
Positional parameters for debug\_getRawHeader:
params\[]: The block number or hash.
### Returns
The RLP encoded header data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawHeader",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-get-raw-receipts
Returns the consensus-encoding of all receipts in a single block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawReceipts: \[blockNrOrHash].
Positional parameters for debug\_getRawReceipts:
params\[]: The block number or hash.
### Returns
The consensus-encoding of all receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawReceipts",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-get-raw-transaction
Returns the bytes of the transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[transactionHash].
Positional parameters for debug\_getRawTransaction:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
The bytes of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getTrieFlushInterval
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-get-trie-flush-interval
Retrieves the current value of in-memory trie flush interval.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current value of in-memory trie flush interval.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getTrieFlushInterval",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_goTrace
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-go-trace
Starts a Go execution trace and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_goTrace:
params\[0]: Destination file for the execution trace.
params\[1]: Duration to trace in seconds.
### Returns
True if tracing completed successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_goTrace",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_intermediateRoots
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-intermediate-roots
Returns the intermediate state trie roots for each transaction in the given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier].
Positional parameters for debug\_intermediateRoots:
params\[]: Block number or hash in hex.
### Returns
State root hashes after each transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_intermediateRoots",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_memStats
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-mem-stats
Returns current runtime memory statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Statistics mirroring Go runtime.MemStats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_memStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_mutexProfile
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-mutex-profile
Captures mutex contention profile information and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_mutexProfile:
params\[0]: Destination file for the mutex profile.
params\[1]: Duration to capture in seconds.
### Returns
True if the mutex profile was written successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_mutexProfile",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_printBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-print-block
Pretty-prints the specified block for human inspection.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier].
Positional parameters for debug\_printBlock:
params\[]: Block number or hash.
### Returns
True if the block information was written to the log output. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_printBlock",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_stacks
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-stacks
Collects and writes all goroutine stack traces to the given file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath].
Positional parameters for debug\_stacks:
params\[]: Destination file path.
### Returns
True if stack traces were written. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_stacks",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_storageRangeAt
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-storage-range-at
Returns the storage at the given block height and transaction index. The result can be paged by providing a maxResult to cap the number of storage slots returned as well as specifying the offset via keyStart (hash of storage key).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, txIdx, contractAddress, keyStart, maxResult]
Positional parameters for debug\_storageRangeAt:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Index of the transaction within the block.
params\[2]: 20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
params\[3]: Starting key (32-byte hex string) used for filtering storage or entries.
params\[4]: Maximum number of results to return.
### Returns
The array of storage items.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": [
"0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
0,
"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"0x0000000000000000000000000000000000000000000000000000000000000000",
1
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBadBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-trace-bad-block
Executes the transactions in a bad block and returns the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, options?].
Positional parameters for debug\_traceBadBlock:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBadBlock",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-trace-block
The traceBlock method will return a full stack trace of all invoked opcodes of all transaction that were included in this block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_traceBlock: \[blockRlp, traceConfig].
Positional parameters for debug\_traceBlock:
params\[0]: The RLP encoded block.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlock",
"params": [
"RLP_ENCODED_BLOCK",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceCallMany
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-trace-call-many
Executes a list of bundles (a bundle is a collection of transactions), without creating transactions on the blockchain. Returns their traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for debug\_traceCallMany. 1. Bundles (required): an array of bundles. Each bundle is an object with: - transactions: an array of transaction objects (each with fields such as from, to, value, data), - blockOverride (optional): an object with overrides (blockNumber, blockHash mapping, coinbase, timestamp, difficulty, gasLimit, baseFee). 2. Simulation context (required): an object with blockIdentifier (a hex block number or one of "latest", "earliest", "pending", "safe", "finalized") and transactionIndex (integer, default -1). 3. State overrides (optional): an object mapping addresses to state override objects (here, at least a balance override as a hex string). 4. Timeout (optional): integer timeout in milliseconds (default 5000). 5. Trace type (optional): an object with tracer (string, enum: callTracer, prestateTracer), tracerConfig (object), and onlyTopCall (boolean).
Positional parameters for debug\_traceCallMany:
params\[0]: List of bundles. Each bundle is an object with transactions and an optional blockOverride.
params\[1]: Simulation context. Contains blockIdentifier (a hex block number or tag) and transactionIndex (default -1).
params\[2]: Optional state overrides: a mapping from address to an override object (e.g. balance).
### Returns
Array of trace responses corresponding to each simulated bundle. Each trace response is one of: callTracer response, prestateTracer response, or opcode (struct) response.
CallTracer response.
CallTracer response.
Type of the call.
Sender address.
Recipient address.
Gas provided by the sender.
Actual value deducted from the sender (per gas).
Total gas used by the call.
Input data (4-byte method selector).
Return value (hex).
Error message if execution failed.
List of sub-calls (nested call frames).
A nested call frame with additional details.
Revert reason, if available.
PrestateTracer response.
Smart contract address associated with the result.
Balance of the contract in wei (hex).
Bytecode of the contract (hex).
Nonce of the contract account.
Mapping of storage slots (hex keys and values).
Opcode (struct) trace response.
Indicates whether the execution failed.
Total consumed gas (hex).
Return value of the executed call (hex).
Array of execution step logs.
Program counter.
Operation name.
Available gas at this step.
Gas cost of the operation.
Call depth.
Stack values at this step.
Storage state at this step.
Refund amount (hex).
Error message, if any.
Memory snapshot at this step (array of hex strings).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCallMany",
"params": [
[],
{},
{},
5000,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# erigon_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10/erigon/erigon-block-number
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_forks
Source: https://docs.uniblock.dev/reference/jsonrpc/10/erigon/erigon-forks
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_forks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getBlockByTimestamp
Source: https://docs.uniblock.dev/reference/jsonrpc/10/erigon/erigon-get-block-by-timestamp
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getBlockByTimestamp",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getBlockReceiptsByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10/erigon/erigon-get-block-receipts-by-block-hash
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getBlockReceiptsByBlockHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getHeaderByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10/erigon/erigon-get-header-by-hash
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getHeaderByHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getHeaderByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10/erigon/erigon-get-header-by-number
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getHeaderByNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getLatestLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/10/erigon/erigon-get-latest-logs
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getLatestLogs",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getLogsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10/erigon/erigon-get-logs-by-hash
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getLogsByHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_baseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-base-fee
Returns the base fee for the next block, in hexadecimal format representing wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
Hex-encoded base fee for the next block (in wei). Example: "0x2e90edd000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_baseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2e90edd000"
}
```
# eth_blobBaseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-blob-base-fee
Returns the expected base fee for blobs in the next block, in wei (hexadecimal format).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The expected blob base fee for the next block (QUANTITY in wei, 64 bits). Example: "0x174876e800".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blobBaseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x174876e800"
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-call-many
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_callMany",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getAccount
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-account
Retrieves detailed account information for a given address at a specific block number or tag.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, blockReference]
Positional parameters for eth\_getAccount:
params\[0]: The address of the account (20-byte hex string).
params\[1]: Block reference: block number in hex, integer, or tag ("latest", "pending", "safe", "finalized").
### Returns
Account information at the specified block.
32-byte hash of the account’s code.
Hash of the account’s storage trie.
Account balance in wei (hexadecimal).
Number of transactions sent from the account.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getAccount",
"params": [
"0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"codeHash": "0x3f30cbb24e7a53efc981dcf566da48e6e9b5418d26c4763fdb4e83e7bcd0c9c5",
"storageRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"balance": "0x38d7ea4c68000",
"nonce": "0x10"
}
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getRawTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-raw-transaction-by-block-hash-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockHashAndIndex:
params\[0]: The hash of the block containing the transaction.
params\[1]: The index position of the transaction in the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the signature. Example: "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockHashAndIndex",
"params": [
"0x7e4aea365093a183b0df5f003f26144ef04ec8a6e7f4910356590c5fc7b1671f",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b..."
}
```
# eth_getRawTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-raw-transaction-by-block-number-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockNumberAndIndex:
params\[0]: The block number (hex string or tag like "latest", "finalized", "safe").
params\[1]: The index of the transaction within the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the full signed transaction. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockNumberAndIndex",
"params": [
"0x10fb78",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getRawTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-raw-transaction-by-hash
Retrieves the raw transaction data as a hexadecimal string for the given transaction hash, including all signature components.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionHash]
Positional parameters for eth\_getRawTransactionByHash:
params\[]: The hash of the transaction (32-byte hex string).
### Returns
Raw transaction data in hexadecimal format, including sender, recipient, gas, data, and signature. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getWork
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-get-work
Returns the hash of the current block, the seedHash, and the boundary condition to be met (“target”).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array returned by eth\_getWork. Contains \[powHash, seedHash, boundary, blockNumber].
32-byte current block header pow-hash.
32-byte current block header pow-hash.
32-byte seed hash used for the DAG.
32-byte boundary condition (target = 2^256 / difficulty).
Quantity - current block number (hex string).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getWork",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"0x5EED00000000000000000000000000005EED0000000000000000000000000000",
"0xd1ff1c01710000000000000000000000d1ff1c01710000000000000000000000",
"0x1"
]
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-hashrate
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-mining
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendPrivateTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-send-private-transaction
Sends a signed transaction to a private relay (like Flashbots Protect) for inclusion in a block without exposure to the public mempool. Provides frontrunning and revert protection.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionPayload]
Positional parameters for eth\_sendPrivateTransaction:
params\[]: Payload object containing raw transaction and optional execution constraints.
### Returns
Returns true if the transaction was successfully accepted, false otherwise. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendPrivateTransaction",
"params": [
{
"tx": "0xf86c808504a817c80082520894a0df350d2637096571f7a701cb5b1660d90cecb380b844a9059cbb000000000000000000000000b60e8dd61c5d32be8058bb8eb970870f07233155",
"maxBlockNumber": "0x10fb80",
"preferences": {
"fast": true
}
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sendTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-send-transaction
Creates new message call transaction or a contract creation, if the data field contains code.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendTransaction: \[transactionObject]
Positional parameters for eth\_sendTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sign
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-sign
The sign method calculates an Ethereum specific signature with: sign(keccak256("Ethereum Signed Message: " + len(message) + message))).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sign: \[address, data].
Positional parameters for eth\_sign:
params\[0]: The address.
params\[1]: Data which hash to sign.
### Returns
Data - Signed data. Example: "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a539310c6ecd1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sign",
"params": [
"0xcd2a3d9f938e13cd947ec05abc7fe734df8dd826",
"0x5363686f6f6c627573"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a5..."
}
```
# eth_signTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-sign-transaction
Signs transactions without dispatching it to the network. It can be later submitted using eth_sendRawTransaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_signTransaction: \[transactionObject]
Positional parameters for eth\_signTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
Signed transaction and its details.
Data - The signed, RLP encoded transaction.
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_signTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"raw": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
"tx": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
}
```
# eth_simulateV1
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-simulate-v1
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_simulateV1",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_submitHashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-submit-hashrate
Used for submitting mining hashrate.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_submitHashrate: \[hashrate, id].
Positional parameters for eth\_submitHashrate:
params\[0]: Data - a hexadecimal string representation (32 bytes) of the hash rate.
params\[1]: Data - A random hexadecimal(32 bytes) ID identifying the client.
### Returns
Boolean - Returns true if submitting hash rate was successful. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_submitHashrate",
"params": [
"0x0000000000000000000000000000000000000000000000000000000000500000",
"0x59daa26581d0acd1fce254fb7e85952f4c09d0915afd33d3886cd914bc7d283c"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_submitWork
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-submit-work
Used for submitting a proof-of-work solution.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_submitWork: \[nonce, powHash, mixHash].
Positional parameters for eth\_submitWork:
params\[0]: 8 Bytes - The nonce found (64 bits).
params\[1]: 32 Bytes - The header’s pow-hash (256 bits)
params\[2]: Data - 32 Bytes - The mix digest (256 bits).
### Returns
Boolean - returns true if the provided solution is valid, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_submitWork",
"params": [
"0x0000000000000001",
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"0xD1FE5700000000000000000000000000D1FE5700000000000000000000000000"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_subscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-subscribe
Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_subscribe: \[subscriptionType, options]. The second parameter is required only for "logs".
Positional parameters for eth\_subscribe:
params\[0]: Subscription type. Must be either "newHeads" or "logs".
params\[1]: Filter options for "logs" subscription, or empty object for "newHeads".
### Returns
Assigned subscription ID Example: "0xb53c4832f1dca4a5".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_subscribe",
"params": [
"logs",
{
"fromBlock": "latest",
"toBlock": "latest"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb53c4832f1dca4a5"
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# txpool_contentFrom
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/txpool-content-from
Retrieves the pending and queued transactions from the txpool that were sent by the specified address, grouped by nonce.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Array containing the address to filter transactions by.
Positional parameters for txpool\_contentFrom:
params\[]: The sender address (20-byte hex string).
### Returns
Pending and queued transactions for the specified address.
List of pending transactions grouped by nonce.
List of queued transactions grouped by nonce.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_contentFrom",
"params": [
"0x9431D1615FA755Faa25A74da7f34C8Bd6963bd0A"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# txpool_inspect
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/txpool-inspect
Returns a human-readable summary of all pending and queued transactions in the txpool. Supported only on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept parameters.
### Returns
Textual summaries of pending and queued transactions indexed by sender and nonce.
Pending transactions indexed by sender address and nonce.
Queued transactions indexed by sender address and nonce.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_inspect",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# txpool_status
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/txpool-status
Returns the number of transactions in the pending and queued state in the txpool. Supported only on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept parameters.
### Returns
Summary of transaction counts in the txpool.
Total number of pending transactions in hex format.
Total number of queued transactions in hex format.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_status",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/10/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# Optimism (ETH) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/10/optimism-overview
Optimism is an EVM-compatible mainnet. Its ticker symbol is `ETH`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Optimism
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=10`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=10' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ---------------- | ------ | ------- | ---------- |
| Optimism | `ETH` | Mainnet | `10` |
| Optimism Sepolia | `ETH` | Testnet | `11155420` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/10/debug/debug-account-range)
* [Erigon](/reference/jsonrpc/10/erigon/erigon-block-number)
* [EVM](/reference/jsonrpc/10/evm/eth-accounts)
* [Otterscan](/reference/jsonrpc/10/otterscan/ots-get-api-level)
* [Trace](/reference/jsonrpc/10/trace/trace-block)
# ots_getApiLevel
Source: https://docs.uniblock.dev/reference/jsonrpc/10/otterscan/ots-get-api-level
Very simple API versioning scheme. Every time we add a new capability, the number is incremented. This allows for Otterscan to check if the Erigon node contains all API it needs.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Number - containing the API version.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getApiLevel",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": 0
}
```
# ots_getBlockDetails
Source: https://docs.uniblock.dev/reference/jsonrpc/10/otterscan/ots-get-block-details
Given a block number, return its data. Similar to the standard eth_getBlockByNumber/Hash method, but optimized.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for ots\_getBlockDetails: \[blockNumber].
Positional parameters for ots\_getBlockDetails:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Modified block object with additional fields and stripped transaction list.
Block data (similar to eth\_getBlockByNumber/Hash but modified).
Block number (hex quantity) or null if pending.
Block hash or null if pending.
Always null in this format to reduce bandwidth.
Base fee per gas (EIP-1559 blocks only).
Number of transactions in the block (as a hex quantity).
Issuance details for the block.
Block reward issued to the miner.
Total uncle rewards.
Total ETH issued (blockReward + uncleReward).
Total fees paid by senders in this block (includes base fee; not all fees go to miner).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getBlockDetails",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# ots_getBlockDetailsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10/otterscan/ots-get-block-details-by-hash
Given a block hash, return its data. Similar to the standard eth_getBlockByNumber/Hash method, but optimized.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for ots\_getBlockDetailsByHash: \[blockHash].
Positional parameters for ots\_getBlockDetailsByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Modified block object with additional fields and stripped transaction list.
Block data (similar to eth\_getBlockByNumber/Hash but modified).
Block number (hex quantity) or null if pending.
Block hash or null if pending.
Always null in this format to reduce bandwidth.
Base fee per gas (EIP-1559 blocks only).
Number of transactions in the block (as a hex quantity).
Issuance details for the block.
Block reward issued to the miner.
Total uncle rewards.
Total ETH issued (blockReward + uncleReward).
Total fees paid by senders in this block (includes base fee; not all fees go to miner).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getBlockDetailsByHash",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# ots_getBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/10/otterscan/ots-get-block-transactions
Gets paginated transaction data for a certain block. Think of an optimized eth_getBlockBy* + eth_getTransactionReceipt.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for ots\_getBlockTransactions: \[defaultBlock].
Positional parameters for ots\_getBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Block object with full transactions and their receipts, optimized for pagination. Includes truncated input data and simplified receipts.
Block number (hex quantity).
Hash of the block.
List of transaction bodies with truncated input fields.
Only the 4-byte method selector is included.
List of simplified receipts matching the order of the transactions.
Logs are omitted to save bandwidth.
LogsBloom is omitted to save bandwidth.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getBlockTransactions",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# ots_getContractCreator
Source: https://docs.uniblock.dev/reference/jsonrpc/10/otterscan/ots-get-contract-creator
Given an ETH contract address, returns the tx hash and the direct address who created the contract.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for ots\_getContractCreator: \[address].
Positional parameters for ots\_getContractCreator:
params\[]: The address.
### Returns
object containing the following attributes, or null if the address does not contain a contract. hash - The tx hash of the transaction who created the contract. creator - The address which created the contract. Note that for simple transactions that directly deploy a contract this corresponds to the EOA in the from field of the transaction. For deployer contracts, i.e., the contract is created as a result of a method call, this corresponds to the address of the contract which created it.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getContractCreator",
"params": [
"0xc0a47dFe034B400B47bDaD5FecDa2621de6c4d95"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xe881c43cd88063e84a1d0283f41ee5348239b259c0d17a7e2e4552da3f4b2bc7",
"creator": "0x6c9fc64a53c1b71fb3f9af64d1ae3a4931a5f4e9"
}
}
```
# ots_getInternalOperations
Source: https://docs.uniblock.dev/reference/jsonrpc/10/otterscan/ots-get-internal-operations
Trace internal ETH transfers, contract creations (CREATE/CREATE2) and self-destructs for a certain transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for the method ots\_getInternalOperations: \[txHash].
Positional parameters for ots\_getInternalOperations:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
Array of operations sorted by their occurrence inside the transaction.
Represents an individual ETH operation within a transaction.
Operation type: 0 = transfer, 1 = self-destruct, 2 = create, 3 = create2.
Sender address: ETH sender, contract creator, or contract being self-destructed.
Receiver address: ETH recipient, newly created contract address, or target of a self-destruct.
Amount of ETH transferred, in hexadecimal Wei.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getInternalOperations",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# ots_getTransactionError
Source: https://docs.uniblock.dev/reference/jsonrpc/10/otterscan/ots-get-transaction-error
Given a transaction hash, returns its raw revert reason.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for the method ots\_getTransactionError: \[txHash].
Positional parameters for ots\_getTransactionError:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
string containing the hexadecimal-formatted error blob or simply a "0x" if the transaction was successfully executed. It returns "0x" if it failed with no revert reason or out of gas, so make sure to analyze this return value together with the transaction success/fail result. Example: "0x08c379a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000135472616e73616374696f6e20746f6f206f6c6400000000000000000000000000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getTransactionError",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x08c379a000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000..."
}
```
# ots_hasCode
Source: https://docs.uniblock.dev/reference/jsonrpc/10/otterscan/ots-has-code
Check if an ETH address contains a deployed code.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for the method ots\_hasCode: \[address, defaultBlock].
Positional parameters for ots\_hasCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
boolean indicating if the address contains a bytecode or not.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_hasCode",
"params": [
"0xc0a47dFe034B400B47bDaD5FecDa2621de6c4d95",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": false
}
```
# ots_searchTransactionsAfter
Source: https://docs.uniblock.dev/reference/jsonrpc/10/otterscan/ots-search-transactions-after
Address history navigation method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method ots\_searchTransactionsAfter: \[address, defaultBlock, pageSize].
Positional parameters for ots\_searchTransactionsAfter:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[2]: The page size for the number of results to return.
### Returns
Paginated list of transactions and receipts for a given address before or after a specified block number.
List of transactions (inbound, outbound, or internal) touching the target address, sorted from most recent to oldest.
Transaction hash.
Sender address.
Recipient address, or null if contract creation.
Amount of ETH transferred, in hexadecimal Wei.
Method selector or calldata (possibly truncated).
Transaction type: "external", "internal", or "contract".
List of receipts corresponding to the returned transactions.
Logs are omitted to reduce payload size.
Logs bloom is omitted to reduce payload size.
True if this page starts from the most recent block (for `Before`) or if no more results follow (for `After`).
True if this page reaches the genesis block (for `After`) or no more results follow (for `Before`).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_searchTransactionsAfter",
"params": [
"0xc0a47dFe034B400B47bDaD5FecDa2621de6c4d95",
0,
5
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# ots_searchTransactionsBefore
Source: https://docs.uniblock.dev/reference/jsonrpc/10/otterscan/ots-search-transactions-before
Address history navigation method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method ots\_searchTransactionsBefore: \[address, defaultBlock, pageSize].
Positional parameters for ots\_searchTransactionsBefore:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[2]: The page size for the number of results to return.
### Returns
Paginated list of transactions and receipts for a given address before or after a specified block number.
List of transactions (inbound, outbound, or internal) touching the target address, sorted from most recent to oldest.
Transaction hash.
Sender address.
Recipient address, or null if contract creation.
Amount of ETH transferred, in hexadecimal Wei.
Method selector or calldata (possibly truncated).
Transaction type: "external", "internal", or "contract".
List of receipts corresponding to the returned transactions.
Logs are omitted to reduce payload size.
Logs bloom is omitted to reduce payload size.
True if this page starts from the most recent block (for `Before`) or if no more results follow (for `After`).
True if this page reaches the genesis block (for `After`) or no more results follow (for `Before`).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_searchTransactionsBefore",
"params": [
"0xc0a47dFe034B400B47bDaD5FecDa2621de6c4d95",
0,
5
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# ots_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10/otterscan/ots-trace-transaction
Trace a transaction and generate a trace call tree.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for ots\_traceTransaction: \[transactionHash].
Positional parameters for ots\_traceTransaction:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
object containing the trace tree.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/10/trace/trace-block
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/10/trace/trace-call
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/10/trace/trace-call-many
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/10/trace/trace-filter
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/10/trace/trace-get
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10/trace/trace-raw-transaction
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/10/trace/trace-replay-block-transactions
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10/trace/trace-replay-transaction
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# debug_accountRange
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-account-range
Returns the accounts within a specific key range for the given block state.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier, startKey, maxResults, context?].
Positional parameters for debug\_accountRange:
params\[0]: Block number or hash at which to inspect state (hex quantity or 32-byte hash).
params\[3]: Optional context returned from a previous call to continue iteration.
### Returns
Account range response including account details and continuation token.
Next account key to resume iteration, or null if complete.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_accountRange",
"params": [
"",
"",
0,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_gcStats
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-gc-stats
Returns garbage collection statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Garbage collection stats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_gcStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-get-bad-blocks
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_getModifiedAccountsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-get-modified-accounts-by-hash
Returns the addresses of accounts modified by the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for debug\_getModifiedAccountsByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getModifiedAccountsByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-get-modified-accounts-by-number
Returns the addresses of accounts modified in the specified block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for debug\_getModifiedAccountsByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByNumber",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getRawBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-get-raw-block
Retrieves and returns the RLP encoded block by number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawBlock: \[blockNrOrHash].
Positional parameters for debug\_getRawBlock:
params\[]: The block number or hash.
### Returns
The RLP encoded data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawBlock",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawHeader
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-get-raw-header
Returns an RLP-encoded header.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[blockNrOrHash].
Positional parameters for debug\_getRawHeader:
params\[]: The block number or hash.
### Returns
The RLP encoded header data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawHeader",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-get-raw-receipts
Returns the consensus-encoding of all receipts in a single block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawReceipts: \[blockNrOrHash].
Positional parameters for debug\_getRawReceipts:
params\[]: The block number or hash.
### Returns
The consensus-encoding of all receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawReceipts",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-get-raw-transaction
Returns the bytes of the transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[transactionHash].
Positional parameters for debug\_getRawTransaction:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
The bytes of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_memStats
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-mem-stats
Returns current runtime memory statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Statistics mirroring Go runtime.MemStats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_memStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_storageRangeAt
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-storage-range-at
Returns the storage at the given block height and transaction index. The result can be paged by providing a maxResult to cap the number of storage slots returned as well as specifying the offset via keyStart (hash of storage key).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, txIdx, contractAddress, keyStart, maxResult]
Positional parameters for debug\_storageRangeAt:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Index of the transaction within the block.
params\[2]: 20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
params\[3]: Starting key (32-byte hex string) used for filtering storage or entries.
params\[4]: Maximum number of results to return.
### Returns
The array of storage items.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": [
"0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
0,
"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"0x0000000000000000000000000000000000000000000000000000000000000000",
1
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-trace-block
The traceBlock method will return a full stack trace of all invoked opcodes of all transaction that were included in this block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_traceBlock: \[blockRlp, traceConfig].
Positional parameters for debug\_traceBlock:
params\[0]: The RLP encoded block.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlock",
"params": [
"RLP_ENCODED_BLOCK",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockFromFile
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-trace-block-from-file
Traces all transactions contained within an RLP-encoded block file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, options?].
Positional parameters for debug\_traceBlockFromFile:
params\[0]: Path to the block file.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockFromFile",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceCallMany
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-trace-call-many
Executes a list of bundles (a bundle is a collection of transactions), without creating transactions on the blockchain. Returns their traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for debug\_traceCallMany. 1. Bundles (required): an array of bundles. Each bundle is an object with: - transactions: an array of transaction objects (each with fields such as from, to, value, data), - blockOverride (optional): an object with overrides (blockNumber, blockHash mapping, coinbase, timestamp, difficulty, gasLimit, baseFee). 2. Simulation context (required): an object with blockIdentifier (a hex block number or one of "latest", "earliest", "pending", "safe", "finalized") and transactionIndex (integer, default -1). 3. State overrides (optional): an object mapping addresses to state override objects (here, at least a balance override as a hex string). 4. Timeout (optional): integer timeout in milliseconds (default 5000). 5. Trace type (optional): an object with tracer (string, enum: callTracer, prestateTracer), tracerConfig (object), and onlyTopCall (boolean).
Positional parameters for debug\_traceCallMany:
params\[0]: List of bundles. Each bundle is an object with transactions and an optional blockOverride.
params\[1]: Simulation context. Contains blockIdentifier (a hex block number or tag) and transactionIndex (default -1).
params\[2]: Optional state overrides: a mapping from address to an override object (e.g. balance).
### Returns
Array of trace responses corresponding to each simulated bundle. Each trace response is one of: callTracer response, prestateTracer response, or opcode (struct) response.
CallTracer response.
CallTracer response.
Type of the call.
Sender address.
Recipient address.
Gas provided by the sender.
Actual value deducted from the sender (per gas).
Total gas used by the call.
Input data (4-byte method selector).
Return value (hex).
Error message if execution failed.
List of sub-calls (nested call frames).
A nested call frame with additional details.
Revert reason, if available.
PrestateTracer response.
Smart contract address associated with the result.
Balance of the contract in wei (hex).
Bytecode of the contract (hex).
Nonce of the contract account.
Mapping of storage slots (hex keys and values).
Opcode (struct) trace response.
Indicates whether the execution failed.
Total consumed gas (hex).
Return value of the executed call (hex).
Array of execution step logs.
Program counter.
Operation name.
Available gas at this step.
Gas cost of the operation.
Call depth.
Stack values at this step.
Storage state at this step.
Refund amount (hex).
Error message, if any.
Memory snapshot at this step (array of hex strings).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCallMany",
"params": [
[],
{},
{},
5000,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/100/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# erigon_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/100/erigon/erigon-block-number
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_forks
Source: https://docs.uniblock.dev/reference/jsonrpc/100/erigon/erigon-forks
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_forks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getBlockByTimestamp
Source: https://docs.uniblock.dev/reference/jsonrpc/100/erigon/erigon-get-block-by-timestamp
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getBlockByTimestamp",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getBlockReceiptsByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/100/erigon/erigon-get-block-receipts-by-block-hash
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getBlockReceiptsByBlockHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getHeaderByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/100/erigon/erigon-get-header-by-hash
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getHeaderByHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getHeaderByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/100/erigon/erigon-get-header-by-number
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getHeaderByNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getLatestLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/100/erigon/erigon-get-latest-logs
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getLatestLogs",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getLogsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/100/erigon/erigon-get-logs-by-hash
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getLogsByHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_baseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-base-fee
Returns the base fee for the next block, in hexadecimal format representing wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
Hex-encoded base fee for the next block (in wei). Example: "0x2e90edd000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_baseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2e90edd000"
}
```
# eth_blobBaseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-blob-base-fee
Returns the expected base fee for blobs in the next block, in wei (hexadecimal format).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The expected blob base fee for the next block (QUANTITY in wei, 64 bits). Example: "0x174876e800".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blobBaseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x174876e800"
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-call-many
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_callMany",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getAccount
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-account
Retrieves detailed account information for a given address at a specific block number or tag.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, blockReference]
Positional parameters for eth\_getAccount:
params\[0]: The address of the account (20-byte hex string).
params\[1]: Block reference: block number in hex, integer, or tag ("latest", "pending", "safe", "finalized").
### Returns
Account information at the specified block.
32-byte hash of the account’s code.
Hash of the account’s storage trie.
Account balance in wei (hexadecimal).
Number of transactions sent from the account.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getAccount",
"params": [
"0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"codeHash": "0x3f30cbb24e7a53efc981dcf566da48e6e9b5418d26c4763fdb4e83e7bcd0c9c5",
"storageRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"balance": "0x38d7ea4c68000",
"nonce": "0x10"
}
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getNFTBalances
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-nft-balances
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getNFTBalances",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_getNFTCollections
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-nft-collections
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getNFTCollections",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getRawTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-raw-transaction-by-block-hash-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockHashAndIndex:
params\[0]: The hash of the block containing the transaction.
params\[1]: The index position of the transaction in the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the signature. Example: "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockHashAndIndex",
"params": [
"0x7e4aea365093a183b0df5f003f26144ef04ec8a6e7f4910356590c5fc7b1671f",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b..."
}
```
# eth_getRawTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-raw-transaction-by-block-number-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockNumberAndIndex:
params\[0]: The block number (hex string or tag like "latest", "finalized", "safe").
params\[1]: The index of the transaction within the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the full signed transaction. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockNumberAndIndex",
"params": [
"0x10fb78",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getRawTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-raw-transaction-by-hash
Retrieves the raw transaction data as a hexadecimal string for the given transaction hash, including all signature components.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionHash]
Positional parameters for eth\_getRawTransactionByHash:
params\[]: The hash of the transaction (32-byte hex string).
### Returns
Raw transaction data in hexadecimal format, including sender, recipient, gas, data, and signature. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-hashrate
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-mining
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sendTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-send-transaction
Creates new message call transaction or a contract creation, if the data field contains code.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendTransaction: \[transactionObject]
Positional parameters for eth\_sendTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sign
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-sign
The sign method calculates an Ethereum specific signature with: sign(keccak256("Ethereum Signed Message: " + len(message) + message))).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sign: \[address, data].
Positional parameters for eth\_sign:
params\[0]: The address.
params\[1]: Data which hash to sign.
### Returns
Data - Signed data. Example: "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a539310c6ecd1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sign",
"params": [
"0xcd2a3d9f938e13cd947ec05abc7fe734df8dd826",
"0x5363686f6f6c627573"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a5..."
}
```
# eth_signTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-sign-transaction
Signs transactions without dispatching it to the network. It can be later submitted using eth_sendRawTransaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_signTransaction: \[transactionObject]
Positional parameters for eth\_signTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
Signed transaction and its details.
Data - The signed, RLP encoded transaction.
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_signTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"raw": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
"tx": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
}
```
# eth_simulateV1
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-simulate-v1
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_simulateV1",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_submitWork
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-submit-work
Used for submitting a proof-of-work solution.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_submitWork: \[nonce, powHash, mixHash].
Positional parameters for eth\_submitWork:
params\[0]: 8 Bytes - The nonce found (64 bits).
params\[1]: 32 Bytes - The header’s pow-hash (256 bits)
params\[2]: Data - 32 Bytes - The mix digest (256 bits).
### Returns
Boolean - returns true if the provided solution is valid, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_submitWork",
"params": [
"0x0000000000000001",
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"0xD1FE5700000000000000000000000000D1FE5700000000000000000000000000"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_subscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-subscribe
Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_subscribe: \[subscriptionType, options]. The second parameter is required only for "logs".
Positional parameters for eth\_subscribe:
params\[0]: Subscription type. Must be either "newHeads" or "logs".
params\[1]: Filter options for "logs" subscription, or empty object for "newHeads".
### Returns
Assigned subscription ID Example: "0xb53c4832f1dca4a5".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_subscribe",
"params": [
"logs",
{
"fromBlock": "latest",
"toBlock": "latest"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb53c4832f1dca4a5"
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# txpool_inspect
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/txpool-inspect
Returns a human-readable summary of all pending and queued transactions in the txpool. Supported only on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept parameters.
### Returns
Textual summaries of pending and queued transactions indexed by sender and nonce.
Pending transactions indexed by sender address and nonce.
Queued transactions indexed by sender address and nonce.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_inspect",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# txpool_status
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/txpool-status
Returns the number of transactions in the pending and queued state in the txpool. Supported only on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept parameters.
### Returns
Summary of transaction counts in the txpool.
Total number of pending transactions in hex format.
Total number of queued transactions in hex format.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_status",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/100/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# Gnosis (XDAI) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/100/gnosis-overview
Gnosis is an EVM-compatible mainnet. Its ticker symbol is `XDAI`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Gnosis
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=100`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=100' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| -------------- | ------ | ------- | -------- |
| Gnosis | `XDAI` | Mainnet | `100` |
| Gnosis Testnet | `GNO` | Testnet | `10200` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/100/debug/debug-account-range)
* [Erigon](/reference/jsonrpc/100/erigon/erigon-block-number)
* [EVM](/reference/jsonrpc/100/evm/eth-accounts)
* [Parity](/reference/jsonrpc/100/parity/parity-clear-engine-signer)
* [Trace](/reference/jsonrpc/100/trace/trace-block)
# parity_clearEngineSigner
Source: https://docs.uniblock.dev/reference/jsonrpc/100/parity/parity-clear-engine-signer
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_clearEngineSigner",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# parity_enode
Source: https://docs.uniblock.dev/reference/jsonrpc/100/parity/parity-enode
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_enode",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# parity_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/100/parity/parity-get-block-receipts
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_getBlockReceipts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# parity_netPeers
Source: https://docs.uniblock.dev/reference/jsonrpc/100/parity/parity-net-peers
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_netPeers",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# parity_pendingTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/100/parity/parity-pending-transactions
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_pendingTransactions",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/100/trace/trace-block
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/100/trace/trace-call
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/100/trace/trace-call-many
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/100/trace/trace-filter
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/100/trace/trace-get
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/100/trace/trace-raw-transaction
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/100/trace/trace-replay-block-transactions
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/100/trace/trace-replay-transaction
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=100 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# debug_chaindbCompact
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-chaindb-compact
Triggers LevelDB compaction for the chain database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
True if compaction finished successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_chaindbCompact",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_chaindbProperty
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-chaindb-property
Returns diagnostic information about the chain database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[property].
Positional parameters for debug\_chaindbProperty:
params\[]: Name of the database property to query (e.g., "leveldb.stats").
### Returns
Property value returned by the key-value store.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_chaindbProperty",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_gcStats
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-gc-stats
Returns garbage collection statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Garbage collection stats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_gcStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-get-bad-blocks
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_getModifiedAccountsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-get-modified-accounts-by-hash
Returns the addresses of accounts modified by the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for debug\_getModifiedAccountsByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getModifiedAccountsByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-get-modified-accounts-by-number
Returns the addresses of accounts modified in the specified block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for debug\_getModifiedAccountsByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByNumber",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_goTrace
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-go-trace
Starts a Go execution trace and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_goTrace:
params\[0]: Destination file for the execution trace.
params\[1]: Duration to trace in seconds.
### Returns
True if tracing completed successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_goTrace",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_memStats
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-mem-stats
Returns current runtime memory statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Statistics mirroring Go runtime.MemStats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_memStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_mutexProfile
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-mutex-profile
Captures mutex contention profile information and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_mutexProfile:
params\[0]: Destination file for the mutex profile.
params\[1]: Duration to capture in seconds.
### Returns
True if the mutex profile was written successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_mutexProfile",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_printBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-print-block
Pretty-prints the specified block for human inspection.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier].
Positional parameters for debug\_printBlock:
params\[]: Block number or hash.
### Returns
True if the block information was written to the log output. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_printBlock",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_stacks
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-stacks
Collects and writes all goroutine stack traces to the given file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath].
Positional parameters for debug\_stacks:
params\[]: Destination file path.
### Returns
True if stack traces were written. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_stacks",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_storageRangeAt
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-storage-range-at
Returns the storage at the given block height and transaction index. The result can be paged by providing a maxResult to cap the number of storage slots returned as well as specifying the offset via keyStart (hash of storage key).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, txIdx, contractAddress, keyStart, maxResult]
Positional parameters for debug\_storageRangeAt:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Index of the transaction within the block.
params\[2]: 20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
params\[3]: Starting key (32-byte hex string) used for filtering storage or entries.
params\[4]: Maximum number of results to return.
### Returns
The array of storage items.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": [
"0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
0,
"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"0x0000000000000000000000000000000000000000000000000000000000000000",
1
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBadBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-trace-bad-block
Executes the transactions in a bad block and returns the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, options?].
Positional parameters for debug\_traceBadBlock:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBadBlock",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-trace-block
The traceBlock method will return a full stack trace of all invoked opcodes of all transaction that were included in this block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_traceBlock: \[blockRlp, traceConfig].
Positional parameters for debug\_traceBlock:
params\[0]: The RLP encoded block.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlock",
"params": [
"RLP_ENCODED_BLOCK",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockFromFile
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-trace-block-from-file
Traces all transactions contained within an RLP-encoded block file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, options?].
Positional parameters for debug\_traceBlockFromFile:
params\[0]: Path to the block file.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockFromFile",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getRawTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-raw-transaction-by-block-hash-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockHashAndIndex:
params\[0]: The hash of the block containing the transaction.
params\[1]: The index position of the transaction in the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the signature. Example: "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockHashAndIndex",
"params": [
"0x7e4aea365093a183b0df5f003f26144ef04ec8a6e7f4910356590c5fc7b1671f",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b..."
}
```
# eth_getRawTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-raw-transaction-by-block-number-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockNumberAndIndex:
params\[0]: The block number (hex string or tag like "latest", "finalized", "safe").
params\[1]: The index of the transaction within the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the full signed transaction. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockNumberAndIndex",
"params": [
"0x10fb78",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getRawTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-raw-transaction-by-hash
Retrieves the raw transaction data as a hexadecimal string for the given transaction hash, including all signature components.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionHash]
Positional parameters for eth\_getRawTransactionByHash:
params\[]: The hash of the transaction (32-byte hex string).
### Returns
Raw transaction data in hexadecimal format, including sender, recipient, gas, data, and signature. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getWork
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-get-work
Returns the hash of the current block, the seedHash, and the boundary condition to be met (“target”).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array returned by eth\_getWork. Contains \[powHash, seedHash, boundary, blockNumber].
32-byte current block header pow-hash.
32-byte current block header pow-hash.
32-byte seed hash used for the DAG.
32-byte boundary condition (target = 2^256 / difficulty).
Quantity - current block number (hex string).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getWork",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"0x5EED00000000000000000000000000005EED0000000000000000000000000000",
"0xd1ff1c01710000000000000000000000d1ff1c01710000000000000000000000",
"0x1"
]
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-hashrate
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-mining
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sendTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-send-transaction
Creates new message call transaction or a contract creation, if the data field contains code.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendTransaction: \[transactionObject]
Positional parameters for eth\_sendTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sign
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-sign
The sign method calculates an Ethereum specific signature with: sign(keccak256("Ethereum Signed Message: " + len(message) + message))).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sign: \[address, data].
Positional parameters for eth\_sign:
params\[0]: The address.
params\[1]: Data which hash to sign.
### Returns
Data - Signed data. Example: "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a539310c6ecd1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sign",
"params": [
"0xcd2a3d9f938e13cd947ec05abc7fe734df8dd826",
"0x5363686f6f6c627573"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a5..."
}
```
# eth_signTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-sign-transaction
Signs transactions without dispatching it to the network. It can be later submitted using eth_sendRawTransaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_signTransaction: \[transactionObject]
Positional parameters for eth\_signTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
Signed transaction and its details.
Data - The signed, RLP encoded transaction.
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_signTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"raw": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
"tx": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
}
```
# eth_submitHashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-submit-hashrate
Used for submitting mining hashrate.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_submitHashrate: \[hashrate, id].
Positional parameters for eth\_submitHashrate:
params\[0]: Data - a hexadecimal string representation (32 bytes) of the hash rate.
params\[1]: Data - A random hexadecimal(32 bytes) ID identifying the client.
### Returns
Boolean - Returns true if submitting hash rate was successful. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_submitHashrate",
"params": [
"0x0000000000000000000000000000000000000000000000000000000000500000",
"0x59daa26581d0acd1fce254fb7e85952f4c09d0915afd33d3886cd914bc7d283c"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_submitWork
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-submit-work
Used for submitting a proof-of-work solution.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_submitWork: \[nonce, powHash, mixHash].
Positional parameters for eth\_submitWork:
params\[0]: 8 Bytes - The nonce found (64 bits).
params\[1]: 32 Bytes - The header’s pow-hash (256 bits)
params\[2]: Data - 32 Bytes - The mix digest (256 bits).
### Returns
Boolean - returns true if the provided solution is valid, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_submitWork",
"params": [
"0x0000000000000001",
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"0xD1FE5700000000000000000000000000D1FE5700000000000000000000000000"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_subscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-subscribe
Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_subscribe: \[subscriptionType, options]. The second parameter is required only for "logs".
Positional parameters for eth\_subscribe:
params\[0]: Subscription type. Must be either "newHeads" or "logs".
params\[1]: Filter options for "logs" subscription, or empty object for "newHeads".
### Returns
Assigned subscription ID Example: "0xb53c4832f1dca4a5".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_subscribe",
"params": [
"logs",
{
"fromBlock": "latest",
"toBlock": "latest"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb53c4832f1dca4a5"
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# kaia_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/kaia-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for kaia\_getLogs: \[filterObject].
Positional parameters for kaia\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# klay_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/klay-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for klay\_getLogs: \[filterObject].
Positional parameters for klay\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# txpool_inspect
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/txpool-inspect
Returns a human-readable summary of all pending and queued transactions in the txpool. Supported only on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept parameters.
### Returns
Textual summaries of pending and queued transactions indexed by sender and nonce.
Pending transactions indexed by sender address and nonce.
Queued transactions indexed by sender address and nonce.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_inspect",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# txpool_status
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/txpool-status
Returns the number of transactions in the pending and queued state in the txpool. Supported only on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept parameters.
### Returns
Summary of transaction counts in the txpool.
Total number of pending transactions in hex format.
Total number of queued transactions in hex format.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_status",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# Kaia Testnet (KAIA) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia-testnet-overview
Kaia Testnet is an EVM-compatible testnet. It is a testnet for Kaia. Its ticker symbol is `KAIA`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Kaia Testnet
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ------------ | ------ | ------- | -------- |
| Kaia | `KAIA` | Mainnet | `8217` |
| Kaia Testnet | `KAIA` | Testnet | `1001` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/1001/debug/debug-chaindb-compact)
* [EVM](/reference/jsonrpc/1001/evm/eth-accounts)
* [Kaia](/reference/jsonrpc/1001/kaia/kaia-account-created)
* [Klay](/reference/jsonrpc/1001/klay/kaia-get-block-receipts)
* [Trace](/reference/jsonrpc/1001/trace/trace-block)
# kaia_accountCreated
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-account-created
Returns true if the given account exists at the specified block height.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter]. Block parameter defaults to "latest" when omitted.
Positional parameters for kaia\_accountCreated:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
True if the account has been created, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_accountCreated",
"params": [
"0x8d97689c9818892b700e27f316cc3e41e17fbeb9",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# kaia_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-accounts
Returns a list of available Kaia accounts controlled by the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array of account addresses managed by the node.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# kaia_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-block-number
Returns the number of the most recent block on the Kaia chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Hexadecimal block number string of the latest block. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# kaia_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-call
Executes a new message call immediately without creating a transaction on the Kaia blockchain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[call object, block parameter]. Call object follows Kaia transaction fields with nonce omitted.
Positional parameters for kaia\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return data from executing the call, encoded as a hex string. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_call",
"params": [
{
"from": "0x8d97689c9818892b700e27f316cc3e41e17fbeb9",
"to": "0xf20d962a6c8f70c731bd838a3a388d7d48fa6e15",
"data": "0x"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# kaia_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-chain-id
Returns the EIP-155 chain ID used for signing transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The Kaia chain ID as a hex string. Example: "0x2019".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2019"
}
```
# kaia_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-client-version
Returns the current client version string.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Client name and version. Example: "kaia/v1.10.3/linux-amd64/go1.21.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "kaia/v1.10.3/linux-amd64/go1.21.1"
}
```
# kaia_decodeAccountKey
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-decode-account-key
Decodes an RLP-encoded Kaia account key.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[encodedAccountKey].
Positional parameters for kaia\_decodeAccountKey:
params\[]: RLP-encoded account key string.
### Returns
Decoded account key information.
Account key type identifier.
Key payload and associated metadata.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_decodeAccountKey",
"params": [
"0x02f8..."
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_encodeAccountKey
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-encode-account-key
Encodes a structured Kaia account key into its RLP form.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[accountKeyObject].
Positional parameters for kaia\_encodeAccountKey:
params\[]: Structured account key definition to encode.
### Returns
RLP-encoded account key. Example: "0x02f8...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_encodeAccountKey",
"params": [
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x02f8..."
}
```
# kaia_estimateComputationCost
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-estimate-computation-cost
Estimates gas, fee ratio, and other costs required to execute a transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction object, block parameter].
Positional parameters for kaia\_estimateComputationCost:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Estimated computation cost metrics.
Estimated gas limit in hex.
Suggested gas price in peb, hex encoded.
Optional fee ratio applied to the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_estimateComputationCost",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-estimate-gas
Estimates the gas necessary to execute a transaction without submitting it.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction object, block parameter].
Positional parameters for kaia\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Estimated gas amount in hex. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_estimateGas",
"params": [
{
"from": "0x8d97689c9818892b700e27f316cc3e41e17fbeb9",
"to": "0xf20d962a6c8f70c731bd838a3a388d7d48fa6e15",
"value": "0xde0b6b3a7640000"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# kaia_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-fee-history
Returns historical base fee and priority fee percentile data for recent blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles].
Positional parameters for kaia\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max 1024).
params\[1]: Block number where this transaction was included. Null when pending.
params\[2]: Percentiles of priority fees to include in the response (0-100).
### Returns
Base fee history for the requested block range.
Hex block number of the first block in the range.
Base fee per gas for each block in the range.
Gas used ratio for each returned block.
Priority fee rewards per percentile requested (omitted if no percentages were supplied).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_feeHistory",
"params": [
"0x5",
0,
[
10,
50,
90
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-gas-price
Returns the current price per gas in peb as seen by the node.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Current gas price in peb, hex encoded. Example: "0x5d21dba00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5d21dba00"
}
```
# kaia_getAccount
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-account
Returns account data including balance, nonce, and storage root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter].
Positional parameters for kaia\_getAccount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Account metadata at the specified block.
Account balance in peb.
Transaction count for the account.
Storage trie root hash.
Hash of the account code.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getAccount",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_getAccountKey
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-account-key
Returns the account key structure for a given account.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter].
Positional parameters for kaia\_getAccountKey:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Account key definition for the specified account.
Type of the account key.
Account key payload and parameters.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getAccountKey",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter].
Positional parameters for kaia\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Hex string of the account balance in peb. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getBalance",
"params": [
"0x8d97689c9818892b700e27f316cc3e41e17fbeb9",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# kaia_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-block-by-hash
Returns detailed information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, fullTransactions].
Positional parameters for kaia\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, includes full transaction objects; otherwise only hashes.
### Returns
A Kaia block object. Null if the block cannot be found.
Block number in hex. Null when the block is pending.
Hash of the block. Null when the block is pending.
Hash of the parent block.
Bloom filter for logs associated with this block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Author (beneficiary) address of the block.
Difficulty for this block.
Total chain difficulty up to this block.
Extra data field of the block.
Size of the block in bytes (hex).
Maximum gas limit for this block.
Total gas used by transactions in this block.
Unix timestamp of when the block was sealed.
Array containing transaction hashes or full transaction objects.
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
32-byte transaction hash.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getBlockByHash",
"params": [
"0x9a4e12c1b8ef6f2f726755efaf3f0b0f3788c2d9d11b9bd65d9f8c17e7a019d2",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber, fullTransactions].
Positional parameters for kaia\_getBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: If true, returns full transaction objects instead of hashes.
### Returns
A Kaia block object. Null if the block cannot be found.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getBlockByNumber",
"params": [
"0x1b4",
false
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-block-transaction-count-by-hash
Returns the number of transactions in a block matching the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for kaia\_getBlockTransactionCountByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Hexadecimal quantity representing the number of transactions in the block. Example: "0x10".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getBlockTransactionCountByHash",
"params": [
"0x9a4e12c1b8ef6f2f726755efaf3f0b0f3788c2d9d11b9bd65d9f8c17e7a019d2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x10"
}
```
# kaia_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-block-transaction-count-by-number
Returns the number of transactions in a block identified by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for kaia\_getBlockTransactionCountByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Hexadecimal quantity representing the number of transactions in the block. Example: "0x10".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x10"
}
```
# kaia_getBlockWithConsensusInfoByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-block-with-consensus-info-by-hash
Returns block information along with the consensus committee metadata for the specified block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for kaia\_getBlockWithConsensusInfoByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Block data combined with consensus information.
Block information similar to kaia\_getBlockByHash.
Addresses of committee members.
The address.
Address of the committee member who proposed the block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getBlockWithConsensusInfoByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_getBlockWithConsensusInfoByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-block-with-consensus-info-by-number
Returns block information and consensus metadata for the specified block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for kaia\_getBlockWithConsensusInfoByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Block data with consensus information.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getBlockWithConsensusInfoByNumber",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_getBlockWithConsensusInfoByNumberRange
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-block-with-consensus-info-by-number-range
Returns block and consensus information for blocks within the provided inclusive range.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[startBlockNumber, endBlockNumber].
Positional parameters for kaia\_getBlockWithConsensusInfoByNumberRange:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Array of block objects enriched with consensus metadata.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getBlockWithConsensusInfoByNumberRange",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# kaia_getChainConfig
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-chain-config
Returns the chain configuration the node is using.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Configuration data (hard fork schedule, governance parameters, etc.).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getChainConfig",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-code
Returns the contract code stored at a given address for the specified block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter].
Positional parameters for kaia\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Hex-encoded contract code. Returns 0x if no code is present. Example: "0x6080604052...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getCode",
"params": [
"0xf20d962a6c8f70c731bd838a3a388d7d48fa6e15",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x6080604052..."
}
```
# kaia_getCommittee
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-committee
Returns the addresses of the current committee members.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Committee member addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getCommittee",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# kaia_getCommitteeSize
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-committee-size
Returns the size of the current committee.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Committee size as a hex quantity. Example: "0x0f".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getCommitteeSize",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0f"
}
```
# kaia_getCouncil
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-council
Returns the addresses of council members.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Council member addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getCouncil",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# kaia_getCouncilSize
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-council-size
Returns the number of council members.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Council size as a hex quantity. Example: "0x19".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getCouncilSize",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x19"
}
```
# kaia_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-filter-changes
Polls the specified filter for new log entries since the last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filterId].
Positional parameters for kaia\_getFilterChanges:
params\[]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getFilterChanges",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# kaia_getHeaderByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-header-by-hash
Returns the block header identified by block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for kaia\_getHeaderByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Block header information.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getHeaderByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_getHeaderByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-header-by-number
Returns the block header for the specified block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for kaia\_getHeaderByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Block header information.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getHeaderByNumber",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-proof
Returns Merkle proofs for the specified account and storage keys.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, block parameter].
Positional parameters for kaia\_getProof:
params\[0]: The address.
params\[1]: Hex-encoded storage slot keys to prove.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
A trace call consisting of a transaction object and an array of trace types.
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of trace types.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getProof",
"params": [
"",
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# kaia_getRewards
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-rewards
Returns accumulated reward information for the node.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Reward-related metrics reported by the node.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getRewards",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_getStakingInfo
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-staking-info
Returns staking information such as bonded amount and validator details.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Staking information for the node/account.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getStakingInfo",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-storage-at
Returns the value from a storage position at an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, position, block parameter].
Positional parameters for kaia\_getStorageAt:
params\[0]: The address.
params\[1]: Hex-encoded storage slot index.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Hex-encoded storage value. Example: "0x0000000000000000000000000000000000000000000000000000000000000000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getStorageAt",
"params": [
"0x8d97689c9818892b700e27f316cc3e41e17fbeb9",
"0x0",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0000000000000000000000000000000000000000000000000000000000000000"
}
```
# kaia_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-transaction-by-block-hash-and-index
Returns information about a transaction within a block, identified by hash and index.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, transactionIndex].
Positional parameters for kaia\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: The transaction's index position in the block. Null when pending.
### Returns
The transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getTransactionByBlockHashAndIndex",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# kaia_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-transaction-by-block-number-and-index
Returns information about a transaction within a block, identified by block number and index.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber, transactionIndex].
Positional parameters for kaia\_getTransactionByBlockNumberAndIndex:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: The transaction's index position in the block. Null when pending.
### Returns
The transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getTransactionByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# kaia_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-transaction-by-hash
Returns the transaction information for a given transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionHash].
Positional parameters for kaia\_getTransactionByHash:
params\[]: 32 Bytes - hash of the transaction.
### Returns
The transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getTransactionByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# kaia_getTransactionBySenderTxHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-transaction-by-sender-tx-hash
Returns the transaction information for a given sender transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[senderTransactionHash].
Positional parameters for kaia\_getTransactionBySenderTxHash:
params\[]: 32 Bytes - hash of the transaction.
### Returns
The transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getTransactionBySenderTxHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# kaia_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-transaction-count
Returns the number of transactions sent from an address at the specified block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter].
Positional parameters for kaia\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Hexadecimal transaction count. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getTransactionCount",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# kaia_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-transaction-receipt
Returns the transaction receipt for a given transaction hash, including execution status.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionHash].
Positional parameters for kaia\_getTransactionReceipt:
params\[]: 32 Bytes - hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getTransactionReceipt",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_getTransactionReceiptBySenderTxHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-get-transaction-receipt-by-sender-tx-hash
Returns the transaction receipt identified by sender transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[senderTransactionHash].
Positional parameters for kaia\_getTransactionReceiptBySenderTxHash:
params\[]: 32 Bytes - hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getTransactionReceiptBySenderTxHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_isContractAccount
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-is-contract-account
Returns true if the account stores smart contract code.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter].
Positional parameters for kaia\_isContractAccount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
True if contract code exists at the address. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_isContractAccount",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# kaia_isSenderTxHashIndexingEnabled
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-is-sender-tx-hash-indexing-enabled
Indicates whether the node indexes sender transaction hashes.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
True if sender transaction hash indexing is enabled. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_isSenderTxHashIndexingEnabled",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# kaia_lowerBoundGasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-lower-bound-gas-price
Returns the minimum suggested gas price in peb.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Minimum gas price as hex. Example: "0x3b9aca00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_lowerBoundGasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x3b9aca00"
}
```
# kaia_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-max-priority-fee-per-gas
Returns a node-recommended max priority fee per gas for EIP-1559 transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Max priority fee per gas in peb (hex). Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_maxPriorityFeePerGas",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# kaia_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-new-block-filter
Creates a filter to notify when a new block is appended to the chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The filter ID as a hex quantity (e.g., "0x16" for 22).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# kaia_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-new-filter
Creates a log filter based on the provided options.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filterOptions].
Positional parameters for kaia\_newFilter:
params\[]: Filter options used to create a new log filter.
### Returns
The filter ID as a hex quantity (e.g., "0x16" for 22).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_newFilter",
"params": [
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# kaia_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-new-pending-transaction-filter
Creates a filter to receive notifications for pending transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The filter ID as a hex quantity (e.g., "0x16" for 22).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# kaia_nodeAddress
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-node-address
Returns the node address derived from the node key.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20-byte node address in hex format. Example: "0x9d8a62f656a8d1615c1294fd71e9cfb3e4855a4f".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_nodeAddress",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x9d8a62f656a8d1615c1294fd71e9cfb3e4855a4f"
}
```
# kaia_pendingTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-pending-transactions
Returns all pending transactions currently tracked by the node.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Pending transaction objects.
The transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_pendingTransactions",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# kaia_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-protocol-version
Returns the current Kaia protocol version supported by the node.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Protocol version as hex string. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# kaia_recoverFromMessage
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-recover-from-message
Returns the address that signed a given message with the provided signature.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[message, signature].
Positional parameters for kaia\_recoverFromMessage:
params\[]: Type: string.
### Returns
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_recoverFromMessage",
"params": [
"0x48656c6c6f20576f726c64",
"0xf8549a3b..."
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# kaia_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-send-raw-transaction
Submits a signed raw transaction to the Kaia network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[rawTransactionData].
Positional parameters for kaia\_sendRawTransaction:
params\[]: Data - Raw transaction data.
### Returns
32 Bytes - Hash of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_sendRawTransaction",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# kaia_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-sha3
Returns the Keccak-256 hash of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[data].
Positional parameters for kaia\_sha3:
params\[]: Data - (optional) 4 byte hash of the method signature followed by encoded parameters.
### Returns
Keccak-256 hash of the input data. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# kaia_signTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-sign-transaction
Signs a transaction with a node-managed account and returns the raw payload.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionObject].
Positional parameters for kaia\_signTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
Signed transaction information.
Raw signed transaction data.
The transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_signTransaction",
"params": [
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-syncing
Returns false when the node is fully synced, otherwise returns an object detailing synchronization progress.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Snapshot of rollup driver sync status.
L1BlockRef object with hash, number, parentHash, and timestamp.
Hash of the block (32 Bytes).
Block number (QUANTITY, 64 Bits).
Parent block hash (32 Bytes).
Block timestamp (QUANTITY, 64 Bits).
L1BlockRef object with hash, number, parentHash, and timestamp.
L1BlockRef object with hash, number, parentHash, and timestamp.
L1BlockRef object with hash, number, parentHash, and timestamp.
L1BlockRef object with hash, number, parentHash, and timestamp.
L2BlockRef object with hash, number, parentHash, timestamp, l1origin, and sequenceNumber.
Hash of the block (32 Bytes).
Block number (QUANTITY, 64 Bits).
Parent block hash (32 Bytes).
Block timestamp (QUANTITY, 64 Bits).
BlockID object containing hash and number.
Block hash (32 Bytes, DATA).
Block number (QUANTITY, 64 Bits).
Distance to first block of epoch (QUANTITY, 64 Bits).
L2BlockRef object with hash, number, parentHash, timestamp, l1origin, and sequenceNumber.
L2BlockRef object with hash, number, parentHash, timestamp, l1origin, and sequenceNumber.
L2BlockRef object with hash, number, parentHash, timestamp, l1origin, and sequenceNumber.
L2BlockRef object with hash, number, parentHash, timestamp, l1origin, and sequenceNumber.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# kaia_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-uninstall-filter
Uninstalls a filter with the given identifier.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filterId].
Positional parameters for kaia\_uninstallFilter:
params\[]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
True if the filter was successfully removed. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_uninstallFilter",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# kaia_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-unsubscribe
Cancels a websocket subscription previously created with kaia_subscribe.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[subscriptionId].
Positional parameters for kaia\_unsubscribe:
params\[]: Subscription identifier.
### Returns
True if the subscription was successfully cancelled. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_unsubscribe",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# kaia_upperBoundGasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/kaia/kaia-upper-bound-gas-price
Returns the maximum suggested gas price in peb.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Upper bound gas price as hex. Example: "0x77359400".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_upperBoundGasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x77359400"
}
```
# kaia_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/kaia-get-block-receipts
Returns all transaction receipts included in the specified block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHashOrNumber].
Positional parameters for kaia\_getBlockReceipts:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Block number where this transaction was included. Null when pending.
### Returns
Array of transaction receipts for the block.
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "kaia_getBlockReceipts",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# klay_accountCreated
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-account-created
Returns true if the specified account exists at the provided block parameter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter].
Positional parameters for klay\_accountCreated:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
True if the account has been created. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_accountCreated",
"params": [
"0x1b3c8c1cdb4e6b6b8819345bf3c6d9c926f55f90",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# klay_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-accounts
Returns a list of Klaytn accounts owned by the node.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Account addresses managed by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x1b3c8c1cdb4e6b6b8819345bf3c6d9c926f55f90"
]
}
```
# klay_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-block-number
Returns the number of the most recent Klaytn block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Latest block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# klay_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-call
Executes a new message call immediately without creating a transaction on the Klaytn blockchain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[call object, block parameter]. The transaction object omits "nonce" and may omit "from".
Positional parameters for klay\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Return data from the executed call as a hex string. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_call",
"params": [
{
"from": "0x1b3c8c1cdb4e6b6b8819345bf3c6d9c926f55f90",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"data": "0x"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# klay_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-chain-id
Returns the EIP-155 chain ID for the Klaytn network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Chain ID encoded as hex. Example: "0x2019".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2019"
}
```
# klay_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-client-version
Returns the current Klaytn client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Client name and version string. Example: "klaytn/v1.11.0/linux-amd64/go1.21.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "klaytn/v1.11.0/linux-amd64/go1.21.1"
}
```
# klay_decodeAccountKey
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-decode-account-key
Decodes an RLP-encoded Klaytn account key.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[encodedAccountKey].
Positional parameters for klay\_decodeAccountKey:
params\[]: RLP-encoded account key string.
### Returns
Decoded account key structure.
Account key type.
Account key payload.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_decodeAccountKey",
"params": [
"0x02f8..."
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_encodeAccountKey
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-encode-account-key
Encodes a structured account key into the RLP representation.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[accountKeyObject].
Positional parameters for klay\_encodeAccountKey:
params\[]: Structured account key definition.
### Returns
RLP-encoded account key. Example: "0x02f8...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_encodeAccountKey",
"params": [
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x02f8..."
}
```
# klay_estimateComputationCost
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-estimate-computation-cost
Estimates the gas limit and fee options required to execute a transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction object, block parameter].
Positional parameters for klay\_estimateComputationCost:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Estimated computation cost details.
Estimated gas limit (hex).
Suggested gas price (hex).
Optional fee ratio applied to the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_estimateComputationCost",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-estimate-gas
Estimates the gas necessary to execute a transaction without broadcasting it.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction object, block parameter].
Positional parameters for klay\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Estimated gas amount in hex. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_estimateGas",
"params": [
{
"from": "0x1b3c8c1cdb4e6b6b8819345bf3c6d9c926f55f90",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0xde0b6b3a7640000"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# klay_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-fee-history
Returns historical base fee and priority fee percentile data for recent Klaytn blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles].
Positional parameters for klay\_feeHistory:
params\[0]: Hex-encoded number of blocks in the request range (max 1024).
params\[1]: Block number where this transaction was included. Null when pending.
params\[2]: Priority fee percentiles to return (0-100).
### Returns
Fee history for the requested range.
Block number of the first block in the range.
Array of base fees per gas for each block.
Gas used ratios for each block.
Priority fee rewards per percentile.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_feeHistory",
"params": [
"0x5",
0,
[
10,
50,
90
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-gas-price
Returns the current gas price in peb as seen by this node.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Current gas price in peb (hex). Example: "0x5d21dba00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5d21dba00"
}
```
# klay_getAccount
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-account
Returns account information such as balance, nonce, and storage root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter].
Positional parameters for klay\_getAccount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Account metadata at the specified block.
Account balance in peb.
Transaction count for the account.
Storage trie root hash.
Hash of the account code.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getAccount",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_getAccountKey
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-account-key
Returns the account key structure associated with an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter].
Positional parameters for klay\_getAccountKey:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Account key definition for the specified account.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getAccountKey",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-balance
Returns the account balance of the given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter].
Positional parameters for klay\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Balance at the specified block in peb (hex). Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getBalance",
"params": [
"0x1b3c8c1cdb4e6b6b8819345bf3c6d9c926f55f90",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# klay_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-block-by-hash
Returns detailed information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, fullTransactions].
Positional parameters for klay\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, includes full transaction objects instead of hashes.
### Returns
A Klaytn block object. Null if the block cannot be found.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getBlockByHash",
"params": [
"",
false
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber, fullTransactions].
Positional parameters for klay\_getBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: If true, returns full transaction objects instead of hashes.
### Returns
A Klaytn block object. Null if the block cannot be found.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getBlockByNumber",
"params": [
"0x1b4",
false
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-block-receipts
Returns all transaction receipts included in the specified block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHashOrNumber].
Positional parameters for klay\_getBlockReceipts:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Block number where this transaction was included. Null when pending.
### Returns
Array of transaction receipts for the block.
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getBlockReceipts",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# klay_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-block-transaction-count-by-hash
Returns the number of transactions in a block identified by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for klay\_getBlockTransactionCountByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Transaction count represented as a hex quantity. Example: "0x10".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getBlockTransactionCountByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x10"
}
```
# klay_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-block-transaction-count-by-number
Returns the number of transactions in a block identified by number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for klay\_getBlockTransactionCountByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Transaction count represented as a hex quantity. Example: "0x10".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getBlockTransactionCountByNumber",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x10"
}
```
# klay_getBlockWithConsensusInfoByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-block-with-consensus-info-by-hash
Returns block information along with consensus metadata for the specified block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for klay\_getBlockWithConsensusInfoByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Block data enriched with consensus committee information.
Addresses of committee members.
The address.
Address of the block proposer.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getBlockWithConsensusInfoByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_getBlockWithConsensusInfoByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-block-with-consensus-info-by-number
Returns block and consensus information for the specified block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for klay\_getBlockWithConsensusInfoByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Block data with consensus metadata.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getBlockWithConsensusInfoByNumber",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_getBlockWithConsensusInfoByNumberRange
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-block-with-consensus-info-by-number-range
Returns block and consensus information for an inclusive range of block numbers.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[startBlockNumber, endBlockNumber].
Positional parameters for klay\_getBlockWithConsensusInfoByNumberRange:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Array of block objects with consensus metadata.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getBlockWithConsensusInfoByNumberRange",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# klay_getChainConfig
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-chain-config
Returns the chain configuration used by the node.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Klaytn chain configuration (hard forks, governance parameters, etc.).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getChainConfig",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-code
Returns code stored at a given address at the specified block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter].
Positional parameters for klay\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Hex-encoded contract code (0x if no code). Example: "0x6080604052...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getCode",
"params": [
"0xf482f03d3cf03f568c2f3d2b2043614d8d24aa79",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x6080604052..."
}
```
# klay_getCommittee
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-committee
Returns the addresses of committee members responsible for block sealing.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Committee member addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getCommittee",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# klay_getCommitteeSize
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-committee-size
Returns the number of committee members.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Committee size as a hex quantity. Example: "0x0f".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getCommitteeSize",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0f"
}
```
# klay_getCouncil
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-council
Returns the addresses of council members.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Council member addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getCouncil",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# klay_getCouncilSize
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-council-size
Returns the number of council members.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Council size as a hex quantity. Example: "0x19".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getCouncilSize",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x19"
}
```
# klay_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-filter-changes
Polls the specified filter for changes since the last poll and returns new log entries.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filterId].
Positional parameters for klay\_getFilterChanges:
params\[]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getFilterChanges",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# klay_getHeaderByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-header-by-hash
Returns the block header identified by the provided hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for klay\_getHeaderByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Block header information.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getHeaderByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_getHeaderByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-header-by-number
Returns the block header for the specified block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for klay\_getHeaderByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Block header information.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getHeaderByNumber",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-proof
Returns Merkle proofs for account and storage slots at a specified block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, block parameter].
Positional parameters for klay\_getProof:
params\[0]: The address.
params\[1]: Storage slot keys to prove.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
A trace call consisting of a transaction object and an array of trace types.
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of trace types.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getProof",
"params": [
"",
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# klay_getRewards
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-rewards
Returns accumulated reward information for the node.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Reward-related metrics reported by the node.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getRewards",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_getStakingInfo
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-staking-info
Returns staking information such as bonded amount and validator status.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Staking information for the node/account.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getStakingInfo",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-storage-at
Returns the value from a storage slot at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, position, block parameter].
Positional parameters for klay\_getStorageAt:
params\[0]: The address.
params\[1]: Hex-encoded storage slot index.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Hex-encoded storage value. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getStorageAt",
"params": [
"",
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# klay_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-transaction-by-block-hash-and-index
Returns information about a transaction at the given block hash and index.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, transactionIndex].
Positional parameters for klay\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: The transaction's index position in the block. Null when pending.
### Returns
The transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getTransactionByBlockHashAndIndex",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# klay_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-transaction-by-block-number-and-index
Returns information about a transaction at the given block number and index.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber, transactionIndex].
Positional parameters for klay\_getTransactionByBlockNumberAndIndex:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: The transaction's index position in the block. Null when pending.
### Returns
The transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getTransactionByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# klay_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-transaction-by-hash
Returns the information about a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionHash].
Positional parameters for klay\_getTransactionByHash:
params\[]: 32 Bytes - hash of the transaction.
### Returns
The transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getTransactionByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# klay_getTransactionBySenderTxHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-transaction-by-sender-tx-hash
Returns the information about a transaction by the sender transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[senderTransactionHash].
Positional parameters for klay\_getTransactionBySenderTxHash:
params\[]: 32 Bytes - hash of the transaction.
### Returns
The transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getTransactionBySenderTxHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# klay_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-transaction-count
Returns the number of transactions sent from an address at the specified block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter].
Positional parameters for klay\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Hexadecimal transaction count for the address. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getTransactionCount",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# klay_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionHash].
Positional parameters for klay\_getTransactionReceipt:
params\[]: 32 Bytes - hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getTransactionReceipt",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_getTransactionReceiptBySenderTxHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-get-transaction-receipt-by-sender-tx-hash
Returns the transaction receipt using the sender transaction hash identifier.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[senderTransactionHash].
Positional parameters for klay\_getTransactionReceiptBySenderTxHash:
params\[]: 32 Bytes - hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_getTransactionReceiptBySenderTxHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_isContractAccount
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-is-contract-account
Returns true if the account stores contract code.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, block parameter].
Positional parameters for klay\_isContractAccount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
True if contract code exists at the address. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_isContractAccount",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# klay_isSenderTxHashIndexingEnabled
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-is-sender-tx-hash-indexing-enabled
Indicates whether sender transaction hash indexing is enabled.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
True if sender transaction hash indexing is enabled. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_isSenderTxHashIndexingEnabled",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# klay_lowerBoundGasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-lower-bound-gas-price
Returns the minimum suggested gas price in peb.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Minimum gas price as hex. Example: "0x3b9aca00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_lowerBoundGasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x3b9aca00"
}
```
# klay_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-max-priority-fee-per-gas
Returns a suggested max priority fee per gas value.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Max priority fee per gas in peb (hex). Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_maxPriorityFeePerGas",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# klay_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-new-block-filter
Creates a filter to receive notifications for new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The filter ID as a hex quantity (e.g., "0x16" for 22).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# klay_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-new-filter
Creates a log filter using the provided options.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filterOptions].
Positional parameters for klay\_newFilter:
params\[]: Filter options used to create a new log filter.
### Returns
The filter ID as a hex quantity (e.g., "0x16" for 22).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_newFilter",
"params": [
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# klay_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-new-pending-transaction-filter
Creates a filter to receive pending transaction notifications.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The filter ID as a hex quantity (e.g., "0x16" for 22).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# klay_nodeAddress
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-node-address
Returns the node address derived from the node key.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20-byte node address as a hex string. Example: "0x9d8a62f656a8d1615c1294fd71e9cfb3e4855a4f".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_nodeAddress",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x9d8a62f656a8d1615c1294fd71e9cfb3e4855a4f"
}
```
# klay_pendingTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-pending-transactions
Returns pending transactions currently in the node’s transaction pool.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Pending transaction objects.
The transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_pendingTransactions",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# klay_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-protocol-version
Returns the current Klaytn protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Protocol version as hex string. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# klay_recoverFromMessage
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-recover-from-message
Recovers the address that signed a given message.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[message, signature].
Positional parameters for klay\_recoverFromMessage:
params\[]: Type: string.
### Returns
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_recoverFromMessage",
"params": [
"0x48656c6c6f20576f726c64",
"0xf8549a3b..."
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# klay_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-send-raw-transaction
Submits a raw signed transaction to the Klaytn network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[rawTransactionData].
Positional parameters for klay\_sendRawTransaction:
params\[]: Data - Raw transaction data.
### Returns
32 Bytes - Hash of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_sendRawTransaction",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# klay_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-sha3
Returns the Keccak-256 hash of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[data].
Positional parameters for klay\_sha3:
params\[]: Data - (optional) 4 byte hash of the method signature followed by encoded parameters.
### Returns
Keccak-256 hash of the input data. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# klay_signTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-sign-transaction
Signs a transaction with a node-managed account and returns the signed payload.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionObject].
Positional parameters for klay\_signTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
Signed transaction payload and decoded transaction.
Raw signed transaction.
The transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_signTransaction",
"params": [
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-syncing
Returns false when the node is fully synced, otherwise returns an object describing sync progress.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Snapshot of rollup driver sync status.
L1BlockRef object with hash, number, parentHash, and timestamp.
Hash of the block (32 Bytes).
Block number (QUANTITY, 64 Bits).
Parent block hash (32 Bytes).
Block timestamp (QUANTITY, 64 Bits).
L1BlockRef object with hash, number, parentHash, and timestamp.
L1BlockRef object with hash, number, parentHash, and timestamp.
L1BlockRef object with hash, number, parentHash, and timestamp.
L1BlockRef object with hash, number, parentHash, and timestamp.
L2BlockRef object with hash, number, parentHash, timestamp, l1origin, and sequenceNumber.
Hash of the block (32 Bytes).
Block number (QUANTITY, 64 Bits).
Parent block hash (32 Bytes).
Block timestamp (QUANTITY, 64 Bits).
BlockID object containing hash and number.
Block hash (32 Bytes, DATA).
Block number (QUANTITY, 64 Bits).
Distance to first block of epoch (QUANTITY, 64 Bits).
L2BlockRef object with hash, number, parentHash, timestamp, l1origin, and sequenceNumber.
L2BlockRef object with hash, number, parentHash, timestamp, l1origin, and sequenceNumber.
L2BlockRef object with hash, number, parentHash, timestamp, l1origin, and sequenceNumber.
L2BlockRef object with hash, number, parentHash, timestamp, l1origin, and sequenceNumber.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# klay_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-uninstall-filter
Uninstalls the filter identified by the supplied ID.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filterId].
Positional parameters for klay\_uninstallFilter:
params\[]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
True if the filter was successfully removed. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_uninstallFilter",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# klay_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-unsubscribe
Cancels a websocket subscription created with klay_subscribe.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[subscriptionId].
Positional parameters for klay\_unsubscribe:
params\[]: Subscription identifier.
### Returns
True if the subscription was successfully cancelled. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_unsubscribe",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# klay_upperBoundGasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/klay/klay-upper-bound-gas-price
Returns the maximum suggested gas price in peb.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Maximum gas price as hex. Example: "0x77359400".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "klay_upperBoundGasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x77359400"
}
```
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/trace/trace-block
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/trace/trace-call
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/trace/trace-call-many
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/trace/trace-filter
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/trace/trace-get
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/trace/trace-raw-transaction
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/trace/trace-replay-block-transactions
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1001/trace/trace-replay-transaction
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# debug_getRawBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/debug/debug-get-raw-block
Retrieves and returns the RLP encoded block by number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawBlock: \[blockNrOrHash].
Positional parameters for debug\_getRawBlock:
params\[]: The block number or hash.
### Returns
The RLP encoded data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawBlock",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawHeader
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/debug/debug-get-raw-header
Returns an RLP-encoded header.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[blockNrOrHash].
Positional parameters for debug\_getRawHeader:
params\[]: The block number or hash.
### Returns
The RLP encoded header data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawHeader",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/debug/debug-get-raw-receipts
Returns the consensus-encoding of all receipts in a single block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawReceipts: \[blockNrOrHash].
Positional parameters for debug\_getRawReceipts:
params\[]: The block number or hash.
### Returns
The consensus-encoding of all receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawReceipts",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/debug/debug-get-raw-transaction
Returns the bytes of the transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[transactionHash].
Positional parameters for debug\_getRawTransaction:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
The bytes of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-hashrate
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-mining
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_subscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-subscribe
Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_subscribe: \[subscriptionType, options]. The second parameter is required only for "logs".
Positional parameters for eth\_subscribe:
params\[0]: Subscription type. Must be either "newHeads" or "logs".
params\[1]: Filter options for "logs" subscription, or empty object for "newHeads".
### Returns
Assigned subscription ID Example: "0xb53c4832f1dca4a5".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_subscribe",
"params": [
"logs",
{
"fromBlock": "latest",
"toBlock": "latest"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb53c4832f1dca4a5"
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# Monad Testnet (MON) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/monad-testnet-overview
Monad Testnet is an EVM-compatible testnet. It is a testnet for Monad. Its ticker symbol is `MON`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Monad Testnet
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ------------- | ------ | ------- | -------- |
| Monad | `MON` | Mainnet | `143` |
| Monad Testnet | `MON` | Testnet | `10143` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/10143/debug/debug-get-raw-block)
* [EVM](/reference/jsonrpc/10143/evm/eth-accounts)
* [Trace](/reference/jsonrpc/10143/trace/trace-block)
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/trace/trace-block
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/trace/trace-call
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/trace/trace-call-many
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/trace/trace-filter
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/trace/trace-get
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/trace/trace-raw-transaction
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/trace/trace-replay-block-transactions
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10143/trace/trace-replay-transaction
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10143 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# debug_accountRange
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-account-range
Returns the accounts within a specific key range for the given block state.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier, startKey, maxResults, context?].
Positional parameters for debug\_accountRange:
params\[0]: Block number or hash at which to inspect state (hex quantity or 32-byte hash).
params\[3]: Optional context returned from a previous call to continue iteration.
### Returns
Account range response including account details and continuation token.
Next account key to resume iteration, or null if complete.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_accountRange",
"params": [
"",
"",
0,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_gcStats
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-gc-stats
Returns garbage collection statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Garbage collection stats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_gcStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-get-bad-blocks
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_getModifiedAccountsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-get-modified-accounts-by-hash
Returns the addresses of accounts modified by the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for debug\_getModifiedAccountsByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getModifiedAccountsByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-get-modified-accounts-by-number
Returns the addresses of accounts modified in the specified block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for debug\_getModifiedAccountsByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByNumber",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getRawBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-get-raw-block
Retrieves and returns the RLP encoded block by number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawBlock: \[blockNrOrHash].
Positional parameters for debug\_getRawBlock:
params\[]: The block number or hash.
### Returns
The RLP encoded data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawBlock",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawHeader
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-get-raw-header
Returns an RLP-encoded header.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[blockNrOrHash].
Positional parameters for debug\_getRawHeader:
params\[]: The block number or hash.
### Returns
The RLP encoded header data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawHeader",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-get-raw-receipts
Returns the consensus-encoding of all receipts in a single block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawReceipts: \[blockNrOrHash].
Positional parameters for debug\_getRawReceipts:
params\[]: The block number or hash.
### Returns
The consensus-encoding of all receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawReceipts",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-get-raw-transaction
Returns the bytes of the transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[transactionHash].
Positional parameters for debug\_getRawTransaction:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
The bytes of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_memStats
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-mem-stats
Returns current runtime memory statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Statistics mirroring Go runtime.MemStats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_memStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_storageRangeAt
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-storage-range-at
Returns the storage at the given block height and transaction index. The result can be paged by providing a maxResult to cap the number of storage slots returned as well as specifying the offset via keyStart (hash of storage key).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, txIdx, contractAddress, keyStart, maxResult]
Positional parameters for debug\_storageRangeAt:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Index of the transaction within the block.
params\[2]: 20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
params\[3]: Starting key (32-byte hex string) used for filtering storage or entries.
params\[4]: Maximum number of results to return.
### Returns
The array of storage items.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": [
"0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
0,
"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"0x0000000000000000000000000000000000000000000000000000000000000000",
1
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-trace-block
The traceBlock method will return a full stack trace of all invoked opcodes of all transaction that were included in this block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_traceBlock: \[blockRlp, traceConfig].
Positional parameters for debug\_traceBlock:
params\[0]: The RLP encoded block.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlock",
"params": [
"RLP_ENCODED_BLOCK",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockFromFile
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-trace-block-from-file
Traces all transactions contained within an RLP-encoded block file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, options?].
Positional parameters for debug\_traceBlockFromFile:
params\[0]: Path to the block file.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockFromFile",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceCallMany
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-trace-call-many
Executes a list of bundles (a bundle is a collection of transactions), without creating transactions on the blockchain. Returns their traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for debug\_traceCallMany. 1. Bundles (required): an array of bundles. Each bundle is an object with: - transactions: an array of transaction objects (each with fields such as from, to, value, data), - blockOverride (optional): an object with overrides (blockNumber, blockHash mapping, coinbase, timestamp, difficulty, gasLimit, baseFee). 2. Simulation context (required): an object with blockIdentifier (a hex block number or one of "latest", "earliest", "pending", "safe", "finalized") and transactionIndex (integer, default -1). 3. State overrides (optional): an object mapping addresses to state override objects (here, at least a balance override as a hex string). 4. Timeout (optional): integer timeout in milliseconds (default 5000). 5. Trace type (optional): an object with tracer (string, enum: callTracer, prestateTracer), tracerConfig (object), and onlyTopCall (boolean).
Positional parameters for debug\_traceCallMany:
params\[0]: List of bundles. Each bundle is an object with transactions and an optional blockOverride.
params\[1]: Simulation context. Contains blockIdentifier (a hex block number or tag) and transactionIndex (default -1).
params\[2]: Optional state overrides: a mapping from address to an override object (e.g. balance).
### Returns
Array of trace responses corresponding to each simulated bundle. Each trace response is one of: callTracer response, prestateTracer response, or opcode (struct) response.
CallTracer response.
CallTracer response.
Type of the call.
Sender address.
Recipient address.
Gas provided by the sender.
Actual value deducted from the sender (per gas).
Total gas used by the call.
Input data (4-byte method selector).
Return value (hex).
Error message if execution failed.
List of sub-calls (nested call frames).
A nested call frame with additional details.
Revert reason, if available.
PrestateTracer response.
Smart contract address associated with the result.
Balance of the contract in wei (hex).
Bytecode of the contract (hex).
Nonce of the contract account.
Mapping of storage slots (hex keys and values).
Opcode (struct) trace response.
Indicates whether the execution failed.
Total consumed gas (hex).
Return value of the executed call (hex).
Array of execution step logs.
Program counter.
Operation name.
Available gas at this step.
Gas cost of the operation.
Call depth.
Stack values at this step.
Storage state at this step.
Refund amount (hex).
Error message, if any.
Memory snapshot at this step (array of hex strings).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCallMany",
"params": [
[],
{},
{},
5000,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# erigon_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/erigon/erigon-block-number
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_forks
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/erigon/erigon-forks
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_forks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getBlockByTimestamp
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/erigon/erigon-get-block-by-timestamp
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getBlockByTimestamp",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getBlockReceiptsByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/erigon/erigon-get-block-receipts-by-block-hash
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getBlockReceiptsByBlockHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getHeaderByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/erigon/erigon-get-header-by-hash
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getHeaderByHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getHeaderByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/erigon/erigon-get-header-by-number
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getHeaderByNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getLatestLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/erigon/erigon-get-latest-logs
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getLatestLogs",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getLogsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/erigon/erigon-get-logs-by-hash
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getLogsByHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_baseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-base-fee
Returns the base fee for the next block, in hexadecimal format representing wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
Hex-encoded base fee for the next block (in wei). Example: "0x2e90edd000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_baseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2e90edd000"
}
```
# eth_blobBaseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-blob-base-fee
Returns the expected base fee for blobs in the next block, in wei (hexadecimal format).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The expected blob base fee for the next block (QUANTITY in wei, 64 bits). Example: "0x174876e800".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blobBaseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x174876e800"
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-call-many
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_callMany",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getAccount
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-account
Retrieves detailed account information for a given address at a specific block number or tag.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, blockReference]
Positional parameters for eth\_getAccount:
params\[0]: The address of the account (20-byte hex string).
params\[1]: Block reference: block number in hex, integer, or tag ("latest", "pending", "safe", "finalized").
### Returns
Account information at the specified block.
32-byte hash of the account’s code.
Hash of the account’s storage trie.
Account balance in wei (hexadecimal).
Number of transactions sent from the account.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getAccount",
"params": [
"0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"codeHash": "0x3f30cbb24e7a53efc981dcf566da48e6e9b5418d26c4763fdb4e83e7bcd0c9c5",
"storageRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"balance": "0x38d7ea4c68000",
"nonce": "0x10"
}
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getNFTBalances
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-nft-balances
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getNFTBalances",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_getNFTCollections
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-nft-collections
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getNFTCollections",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getRawTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-raw-transaction-by-block-hash-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockHashAndIndex:
params\[0]: The hash of the block containing the transaction.
params\[1]: The index position of the transaction in the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the signature. Example: "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockHashAndIndex",
"params": [
"0x7e4aea365093a183b0df5f003f26144ef04ec8a6e7f4910356590c5fc7b1671f",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b..."
}
```
# eth_getRawTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-raw-transaction-by-block-number-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockNumberAndIndex:
params\[0]: The block number (hex string or tag like "latest", "finalized", "safe").
params\[1]: The index of the transaction within the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the full signed transaction. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockNumberAndIndex",
"params": [
"0x10fb78",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getRawTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-raw-transaction-by-hash
Retrieves the raw transaction data as a hexadecimal string for the given transaction hash, including all signature components.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionHash]
Positional parameters for eth\_getRawTransactionByHash:
params\[]: The hash of the transaction (32-byte hex string).
### Returns
Raw transaction data in hexadecimal format, including sender, recipient, gas, data, and signature. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-hashrate
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-mining
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sendTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-send-transaction
Creates new message call transaction or a contract creation, if the data field contains code.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendTransaction: \[transactionObject]
Positional parameters for eth\_sendTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sign
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-sign
The sign method calculates an Ethereum specific signature with: sign(keccak256("Ethereum Signed Message: " + len(message) + message))).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sign: \[address, data].
Positional parameters for eth\_sign:
params\[0]: The address.
params\[1]: Data which hash to sign.
### Returns
Data - Signed data. Example: "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a539310c6ecd1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sign",
"params": [
"0xcd2a3d9f938e13cd947ec05abc7fe734df8dd826",
"0x5363686f6f6c627573"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a5..."
}
```
# eth_signTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-sign-transaction
Signs transactions without dispatching it to the network. It can be later submitted using eth_sendRawTransaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_signTransaction: \[transactionObject]
Positional parameters for eth\_signTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
Signed transaction and its details.
Data - The signed, RLP encoded transaction.
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_signTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"raw": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
"tx": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
}
```
# eth_simulateV1
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-simulate-v1
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_simulateV1",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_submitWork
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-submit-work
Used for submitting a proof-of-work solution.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_submitWork: \[nonce, powHash, mixHash].
Positional parameters for eth\_submitWork:
params\[0]: 8 Bytes - The nonce found (64 bits).
params\[1]: 32 Bytes - The header’s pow-hash (256 bits)
params\[2]: Data - 32 Bytes - The mix digest (256 bits).
### Returns
Boolean - returns true if the provided solution is valid, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_submitWork",
"params": [
"0x0000000000000001",
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"0xD1FE5700000000000000000000000000D1FE5700000000000000000000000000"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_subscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-subscribe
Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_subscribe: \[subscriptionType, options]. The second parameter is required only for "logs".
Positional parameters for eth\_subscribe:
params\[0]: Subscription type. Must be either "newHeads" or "logs".
params\[1]: Filter options for "logs" subscription, or empty object for "newHeads".
### Returns
Assigned subscription ID Example: "0xb53c4832f1dca4a5".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_subscribe",
"params": [
"logs",
{
"fromBlock": "latest",
"toBlock": "latest"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb53c4832f1dca4a5"
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# txpool_inspect
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/txpool-inspect
Returns a human-readable summary of all pending and queued transactions in the txpool. Supported only on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept parameters.
### Returns
Textual summaries of pending and queued transactions indexed by sender and nonce.
Pending transactions indexed by sender address and nonce.
Queued transactions indexed by sender address and nonce.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_inspect",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# txpool_status
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/txpool-status
Returns the number of transactions in the pending and queued state in the txpool. Supported only on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept parameters.
### Returns
Summary of transaction counts in the txpool.
Total number of pending transactions in hex format.
Total number of queued transactions in hex format.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_status",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# Gnosis Testnet (GNO) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/gnosis-testnet-overview
Gnosis Testnet is an EVM-compatible testnet. It is a testnet for Gnosis. Its ticker symbol is `GNO`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Gnosis Testnet
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| -------------- | ------ | ------- | -------- |
| Gnosis | `XDAI` | Mainnet | `100` |
| Gnosis Testnet | `GNO` | Testnet | `10200` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/10200/debug/debug-account-range)
* [Erigon](/reference/jsonrpc/10200/erigon/erigon-block-number)
* [EVM](/reference/jsonrpc/10200/evm/eth-accounts)
* [Parity](/reference/jsonrpc/10200/parity/parity-clear-engine-signer)
* [Trace](/reference/jsonrpc/10200/trace/trace-block)
# parity_clearEngineSigner
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/parity/parity-clear-engine-signer
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_clearEngineSigner",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# parity_enode
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/parity/parity-enode
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_enode",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# parity_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/parity/parity-get-block-receipts
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_getBlockReceipts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# parity_netPeers
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/parity/parity-net-peers
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_netPeers",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# parity_pendingTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/parity/parity-pending-transactions
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "parity_pendingTransactions",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/trace/trace-block
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/trace/trace-call
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/trace/trace-call-many
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/trace/trace-filter
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/trace/trace-get
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/trace/trace-raw-transaction
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/trace/trace-replay-block-transactions
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10200/trace/trace-replay-transaction
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# debug_dbAncient
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/debug/debug-db-ancient
Returns the ancient (freezer) data item at the given index for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table, index].
Positional parameters for debug\_dbAncient:
params\[0]: Ancient table name (e.g., "headers", "bodies").
params\[1]: Zero-based index within the ancient table.
### Returns
Hex-encoded RLP payload stored at the requested slot.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncient",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncients
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/debug/debug-db-ancients
Returns the number of ancient entries stored for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table].
Positional parameters for debug\_dbAncients:
params\[]: Ancient table name.
### Returns
Count of stored ancient items. Example: 1024.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncients",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": 1024
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/debug/debug-get-bad-blocks
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_getRawBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/debug/debug-get-raw-block
Retrieves and returns the RLP encoded block by number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawBlock: \[blockNrOrHash].
Positional parameters for debug\_getRawBlock:
params\[]: The block number or hash.
### Returns
The RLP encoded data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawBlock",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawHeader
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/debug/debug-get-raw-header
Returns an RLP-encoded header.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[blockNrOrHash].
Positional parameters for debug\_getRawHeader:
params\[]: The block number or hash.
### Returns
The RLP encoded header data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawHeader",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/debug/debug-get-raw-receipts
Returns the consensus-encoding of all receipts in a single block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawReceipts: \[blockNrOrHash].
Positional parameters for debug\_getRawReceipts:
params\[]: The block number or hash.
### Returns
The consensus-encoding of all receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawReceipts",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getTrieFlushInterval
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/debug/debug-get-trie-flush-interval
Retrieves the current value of in-memory trie flush interval.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current value of in-memory trie flush interval.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getTrieFlushInterval",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_storageRangeAt
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/debug/debug-storage-range-at
Returns the storage at the given block height and transaction index. The result can be paged by providing a maxResult to cap the number of storage slots returned as well as specifying the offset via keyStart (hash of storage key).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, txIdx, contractAddress, keyStart, maxResult]
Positional parameters for debug\_storageRangeAt:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Index of the transaction within the block.
params\[2]: 20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
params\[3]: Starting key (32-byte hex string) used for filtering storage or entries.
params\[4]: Maximum number of results to return.
### Returns
The array of storage items.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": [
"0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
0,
"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"0x0000000000000000000000000000000000000000000000000000000000000000",
1
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_blobBaseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-blob-base-fee
Returns the expected base fee for blobs in the next block, in wei (hexadecimal format).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The expected blob base fee for the next block (QUANTITY in wei, 64 bits). Example: "0x174876e800".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blobBaseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x174876e800"
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_simulateV1
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-simulate-v1
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_simulateV1",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# Tea Sepolia (TEA) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/10218/tea-sepolia-overview
Tea Sepolia is an EVM-compatible testnet. It is a testnet for Tea. Its ticker symbol is `TEA`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Tea Sepolia
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=10218' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ----------- | ------ | ------- | -------- |
| Tea Sepolia | `TEA` | Testnet | `10218` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/10218/debug/debug-db-ancient)
* [EVM](/reference/jsonrpc/10218/evm/eth-accounts)
# debug_accountRange
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-account-range
Returns the accounts within a specific key range for the given block state.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier, startKey, maxResults, context?].
Positional parameters for debug\_accountRange:
params\[0]: Block number or hash at which to inspect state (hex quantity or 32-byte hash).
params\[3]: Optional context returned from a previous call to continue iteration.
### Returns
Account range response including account details and continuation token.
Next account key to resume iteration, or null if complete.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_accountRange",
"params": [
"",
"",
0,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_chaindbCompact
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-chaindb-compact
Triggers LevelDB compaction for the chain database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
True if compaction finished successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_chaindbCompact",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_chaindbProperty
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-chaindb-property
Returns diagnostic information about the chain database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[property].
Positional parameters for debug\_chaindbProperty:
params\[]: Name of the database property to query (e.g., "leveldb.stats").
### Returns
Property value returned by the key-value store.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_chaindbProperty",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncient
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-db-ancient
Returns the ancient (freezer) data item at the given index for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table, index].
Positional parameters for debug\_dbAncient:
params\[0]: Ancient table name (e.g., "headers", "bodies").
params\[1]: Zero-based index within the ancient table.
### Returns
Hex-encoded RLP payload stored at the requested slot.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncient",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncients
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-db-ancients
Returns the number of ancient entries stored for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table].
Positional parameters for debug\_dbAncients:
params\[]: Ancient table name.
### Returns
Count of stored ancient items. Example: 1024.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncients",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": 1024
}
```
# debug_gcStats
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-gc-stats
Returns garbage collection statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Garbage collection stats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_gcStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-get-bad-blocks
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_getModifiedAccountsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-get-modified-accounts-by-hash
Returns the addresses of accounts modified by the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for debug\_getModifiedAccountsByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getModifiedAccountsByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-get-modified-accounts-by-number
Returns the addresses of accounts modified in the specified block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for debug\_getModifiedAccountsByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByNumber",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_goTrace
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-go-trace
Starts a Go execution trace and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_goTrace:
params\[0]: Destination file for the execution trace.
params\[1]: Duration to trace in seconds.
### Returns
True if tracing completed successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_goTrace",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_memStats
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-mem-stats
Returns current runtime memory statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Statistics mirroring Go runtime.MemStats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_memStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_mutexProfile
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-mutex-profile
Captures mutex contention profile information and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_mutexProfile:
params\[0]: Destination file for the mutex profile.
params\[1]: Duration to capture in seconds.
### Returns
True if the mutex profile was written successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_mutexProfile",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_printBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-print-block
Pretty-prints the specified block for human inspection.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier].
Positional parameters for debug\_printBlock:
params\[]: Block number or hash.
### Returns
True if the block information was written to the log output. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_printBlock",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_stacks
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-stacks
Collects and writes all goroutine stack traces to the given file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath].
Positional parameters for debug\_stacks:
params\[]: Destination file path.
### Returns
True if stack traces were written. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_stacks",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_storageRangeAt
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-storage-range-at
Returns the storage at the given block height and transaction index. The result can be paged by providing a maxResult to cap the number of storage slots returned as well as specifying the offset via keyStart (hash of storage key).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, txIdx, contractAddress, keyStart, maxResult]
Positional parameters for debug\_storageRangeAt:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Index of the transaction within the block.
params\[2]: 20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
params\[3]: Starting key (32-byte hex string) used for filtering storage or entries.
params\[4]: Maximum number of results to return.
### Returns
The array of storage items.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": [
"0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
0,
"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"0x0000000000000000000000000000000000000000000000000000000000000000",
1
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBadBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-trace-bad-block
Executes the transactions in a bad block and returns the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, options?].
Positional parameters for debug\_traceBadBlock:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBadBlock",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-trace-block
The traceBlock method will return a full stack trace of all invoked opcodes of all transaction that were included in this block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_traceBlock: \[blockRlp, traceConfig].
Positional parameters for debug\_traceBlock:
params\[0]: The RLP encoded block.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlock",
"params": [
"RLP_ENCODED_BLOCK",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockFromFile
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-trace-block-from-file
Traces all transactions contained within an RLP-encoded block file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, options?].
Positional parameters for debug\_traceBlockFromFile:
params\[0]: Path to the block file.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockFromFile",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockRange
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-block-range
Returns the block information for blocks within a specified range.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockRange: \[startBlockTag, endBlockTag, fullTxObjects]
Positional parameters for eth\_getBlockRange:
params\[0]: Start block number (hex) or tag (latest, earliest, pending, safe, finalized).
params\[1]: End block number (hex) or tag (latest, earliest, pending, safe, finalized).
params\[2]: Set to true to return full transaction objects, false for only transaction hashes.
### Returns
List of block objects in the specified range.
Block object structure.
Block difficulty (hex).
Extra data field (hex).
Maximum gas allowed (hex).
Total gas used (hex).
Block hash (32 bytes hex).
Bloom filter (256 bytes hex).
Miner address (20 bytes hex).
Block nonce (8 bytes hex).
Block number (hex).
Parent block hash (hex).
Receipts trie root (hex).
SHA3 of uncles (hex).
Block size in bytes (hex).
State trie root (hex).
Unix timestamp (hex).
Total difficulty up to this block (hex).
Array of transaction objects or transaction hashes.
Transaction hash (32 bytes hex) or transaction object.
Transaction trie root (hex).
Array of uncle hashes.
Uncle hash (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockRange",
"params": [
"0x1",
"0x2",
false
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"difficulty": "0x2",
"extraData": "0xd9773508...",
"gasLimit": "0xe4e1c0",
"gasUsed": "0x3183d",
"hash": "0xbee7192e...",
"logsBloom": "0x00000000...",
"miner": "0x0000000000000000000000000000000000000000",
"nonce": "0x0000000000000000",
"__truncated": true
}
]
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getRawTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-raw-transaction-by-block-hash-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockHashAndIndex:
params\[0]: The hash of the block containing the transaction.
params\[1]: The index position of the transaction in the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the signature. Example: "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockHashAndIndex",
"params": [
"0x7e4aea365093a183b0df5f003f26144ef04ec8a6e7f4910356590c5fc7b1671f",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b..."
}
```
# eth_getRawTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-raw-transaction-by-block-number-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockNumberAndIndex:
params\[0]: The block number (hex string or tag like "latest", "finalized", "safe").
params\[1]: The index of the transaction within the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the full signed transaction. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockNumberAndIndex",
"params": [
"0x10fb78",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getRawTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-raw-transaction-by-hash
Retrieves the raw transaction data as a hexadecimal string for the given transaction hash, including all signature components.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionHash]
Positional parameters for eth\_getRawTransactionByHash:
params\[]: The hash of the transaction (32-byte hex string).
### Returns
Raw transaction data in hexadecimal format, including sender, recipient, gas, data, and signature. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getTransactionReceiptsByBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-transaction-receipts-by-block
Returns all transaction receipts for the specified block using a block number, block hash, or tag. Not available for pending blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockReference]
Positional parameters for eth\_getTransactionReceiptsByBlock:
params\[]: The block number in hex, block hash, or a tag such as "latest", "earliest", or "finalized".
### Returns
An array of transaction receipt objects or null if no receipts were found.
The hash of the block containing this transaction.
The block number in hex.
Contract address created, or null if not a contract creation.
Total gas used when this transaction was executed.
The sender address.
Gas used by this transaction alone.
Array of log objects generated by this transaction.
The address that generated the log.
Array of indexed log arguments (topics).
Non-indexed data portion of the log.
Logs bloom filter.
Execution status: "0x1" (success) or "0x0" (failure).
Recipient address, or null if contract creation.
Transaction hash.
Index position of the transaction within the block.
Type of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceiptsByBlock",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-hashrate
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-mining
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sendTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-send-transaction
Creates new message call transaction or a contract creation, if the data field contains code.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendTransaction: \[transactionObject]
Positional parameters for eth\_sendTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sign
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-sign
The sign method calculates an Ethereum specific signature with: sign(keccak256("Ethereum Signed Message: " + len(message) + message))).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sign: \[address, data].
Positional parameters for eth\_sign:
params\[0]: The address.
params\[1]: Data which hash to sign.
### Returns
Data - Signed data. Example: "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a539310c6ecd1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sign",
"params": [
"0xcd2a3d9f938e13cd947ec05abc7fe734df8dd826",
"0x5363686f6f6c627573"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a5..."
}
```
# eth_signTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-sign-transaction
Signs transactions without dispatching it to the network. It can be later submitted using eth_sendRawTransaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_signTransaction: \[transactionObject]
Positional parameters for eth\_signTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
Signed transaction and its details.
Data - The signed, RLP encoded transaction.
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_signTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"raw": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
"tx": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
}
```
# eth_subscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-subscribe
Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_subscribe: \[subscriptionType, options]. The second parameter is required only for "logs".
Positional parameters for eth\_subscribe:
params\[0]: Subscription type. Must be either "newHeads" or "logs".
params\[1]: Filter options for "logs" subscription, or empty object for "newHeads".
### Returns
Assigned subscription ID Example: "0xb53c4832f1dca4a5".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_subscribe",
"params": [
"logs",
{
"fromBlock": "latest",
"toBlock": "latest"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb53c4832f1dca4a5"
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# Metis (METIS) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/metis-overview
Metis is an EVM-compatible mainnet. Its ticker symbol is `METIS`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Metis
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ------- | ------- | ------- | -------- |
| Metis | `METIS` | Mainnet | `1088` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/1088/debug/debug-account-range)
* [EVM](/reference/jsonrpc/1088/evm/eth-accounts)
* [Trace](/reference/jsonrpc/1088/trace/trace-block)
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/trace/trace-block
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/trace/trace-call
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/trace/trace-call-many
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/trace/trace-filter
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/trace/trace-get
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/trace/trace-raw-transaction
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/trace/trace-replay-block-transactions
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1088/trace/trace-replay-transaction
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1088 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/debug/debug-get-bad-blocks
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_getRawBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/debug/debug-get-raw-block
Retrieves and returns the RLP encoded block by number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawBlock: \[blockNrOrHash].
Positional parameters for debug\_getRawBlock:
params\[]: The block number or hash.
### Returns
The RLP encoded data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawBlock",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawHeader
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/debug/debug-get-raw-header
Returns an RLP-encoded header.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[blockNrOrHash].
Positional parameters for debug\_getRawHeader:
params\[]: The block number or hash.
### Returns
The RLP encoded header data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawHeader",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/debug/debug-get-raw-receipts
Returns the consensus-encoding of all receipts in a single block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawReceipts: \[blockNrOrHash].
Positional parameters for debug\_getRawReceipts:
params\[]: The block number or hash.
### Returns
The consensus-encoding of all receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawReceipts",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getTrieFlushInterval
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/debug/debug-get-trie-flush-interval
Retrieves the current value of in-memory trie flush interval.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current value of in-memory trie flush interval.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getTrieFlushInterval",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_storageRangeAt
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/debug/debug-storage-range-at
Returns the storage at the given block height and transaction index. The result can be paged by providing a maxResult to cap the number of storage slots returned as well as specifying the offset via keyStart (hash of storage key).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, txIdx, contractAddress, keyStart, maxResult]
Positional parameters for debug\_storageRangeAt:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Index of the transaction within the block.
params\[2]: 20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
params\[3]: Starting key (32-byte hex string) used for filtering storage or entries.
params\[4]: Maximum number of results to return.
### Returns
The array of storage items.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": [
"0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
0,
"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"0x0000000000000000000000000000000000000000000000000000000000000000",
1
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_blobBaseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-blob-base-fee
Returns the expected base fee for blobs in the next block, in wei (hexadecimal format).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The expected blob base fee for the next block (QUANTITY in wei, 64 bits). Example: "0x174876e800".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blobBaseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x174876e800"
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_simulateV1
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-simulate-v1
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_simulateV1",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# Shape Sepolia (FOX) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/11011/shape-sepolia-overview
Shape Sepolia is an EVM-compatible testnet. It is a testnet for Shape. Its ticker symbol is `FOX`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Shape Sepolia
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ------------- | ------ | ------- | -------- |
| Shape | `ETH` | Mainnet | `360` |
| Shape Sepolia | `FOX` | Testnet | `11011` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/11011/debug/debug-get-bad-blocks)
* [EVM](/reference/jsonrpc/11011/evm/eth-accounts)
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-hashrate
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-mining
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_subscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-subscribe
Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_subscribe: \[subscriptionType, options]. The second parameter is required only for "logs".
Positional parameters for eth\_subscribe:
params\[0]: Subscription type. Must be either "newHeads" or "logs".
params\[1]: Filter options for "logs" subscription, or empty object for "newHeads".
### Returns
Assigned subscription ID Example: "0xb53c4832f1dca4a5".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_subscribe",
"params": [
"logs",
{
"fromBlock": "latest",
"toBlock": "latest"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb53c4832f1dca4a5"
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/trace/trace-block
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/trace/trace-call
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/trace/trace-call-many
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/trace/trace-filter
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/trace/trace-get
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/trace/trace-raw-transaction
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/trace/trace-replay-block-transactions
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/trace/trace-replay-transaction
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# WEMIX3.0 Mainnet (WEMIX) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/1111/wemix3-0-mainnet-overview
WEMIX3.0 Mainnet is an EVM-compatible mainnet. Its ticker symbol is `WEMIX`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to WEMIX3.0 Mainnet
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=1111' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ---------------- | -------- | ------- | -------- |
| WEMIX3.0 Mainnet | `WEMIX` | Mainnet | `1111` |
| Wemix Testnet | `tWEMIX` | Testnet | `1112` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/1111/debug/debug-trace-block-by-hash)
* [EVM](/reference/jsonrpc/1111/evm/eth-accounts)
* [Trace](/reference/jsonrpc/1111/trace/trace-block)
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-hashrate
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-mining
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_subscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-subscribe
Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_subscribe: \[subscriptionType, options]. The second parameter is required only for "logs".
Positional parameters for eth\_subscribe:
params\[0]: Subscription type. Must be either "newHeads" or "logs".
params\[1]: Filter options for "logs" subscription, or empty object for "newHeads".
### Returns
Assigned subscription ID Example: "0xb53c4832f1dca4a5".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_subscribe",
"params": [
"logs",
{
"fromBlock": "latest",
"toBlock": "latest"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb53c4832f1dca4a5"
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/trace/trace-block
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/trace/trace-call
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/trace/trace-call-many
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/trace/trace-filter
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/trace/trace-get
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/trace/trace-raw-transaction
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/trace/trace-replay-block-transactions
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/trace/trace-replay-transaction
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# Wemix Testnet (tWEMIX) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/1112/wemix-testnet-overview
Wemix Testnet is an EVM-compatible testnet. It is a testnet for WEMIX3.0 Mainnet. Its ticker symbol is `tWEMIX`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Wemix Testnet
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=1112' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ---------------- | -------- | ------- | -------- |
| WEMIX3.0 Mainnet | `WEMIX` | Mainnet | `1111` |
| Wemix Testnet | `tWEMIX` | Testnet | `1112` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/1112/debug/debug-trace-block-by-hash)
* [EVM](/reference/jsonrpc/1112/evm/eth-accounts)
* [Trace](/reference/jsonrpc/1112/trace/trace-block)
# Abstract Testnet (ABS) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/abstract-testnet-overview
Abstract Testnet is an EVM-compatible testnet. It is a testnet for Abstract. Its ticker symbol is `ABS`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Abstract Testnet
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ---------------- | ------ | ------- | -------- |
| Abstract | `ABS` | Mainnet | `2741` |
| Abstract Testnet | `ABS` | Testnet | `11124` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/11124/debug/debug-get-raw-transaction)
* [EVM](/reference/jsonrpc/11124/evm/eth-accounts)
* [Trace](/reference/jsonrpc/11124/trace/trace-block)
* [ZKS](/reference/jsonrpc/11124/zks/zks-estimate-fee)
# debug_getRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/debug/debug-get-raw-transaction
Returns the bytes of the transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[transactionHash].
Positional parameters for debug\_getRawTransaction:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
The bytes of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getCompilers
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-compilers
Returns a list of supported Solidity compilers available in the client. Note: This method is deprecated and usually returns an empty array.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
Array of available compiler names (typically empty in most modern clients).
Compiler name (e.g., "solidity", "lllc").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCompilers",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-hashrate
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-mining
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_subscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-subscribe
Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_subscribe: \[subscriptionType, options]. The second parameter is required only for "logs".
Positional parameters for eth\_subscribe:
params\[0]: Subscription type. Must be either "newHeads" or "logs".
params\[1]: Filter options for "logs" subscription, or empty object for "newHeads".
### Returns
Assigned subscription ID Example: "0xb53c4832f1dca4a5".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_subscribe",
"params": [
"logs",
{
"fromBlock": "latest",
"toBlock": "latest"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb53c4832f1dca4a5"
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/trace/trace-block
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/trace/trace-call
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/trace/trace-call-many
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/trace/trace-filter
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/trace/trace-get
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/trace/trace-raw-transaction
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/trace/trace-replay-block-transactions
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/trace/trace-replay-transaction
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# zks_estimateFee
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-estimate-fee
Returns the fee for the transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Positional parameters for zks\_estimateFee:
params\[]: Type: object.
### Returns
The JSON-RPC result.
Maximum amount of gas the transaction is allowed to use (hex).
Amount of gas consumed per public data byte (hex).
Maximum fee in wei that can be paid per gas unit (hex).
Maximum priority fee in wei that can be paid per gas unit (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_estimateFee",
"params": [
{
"from": "0x1111111111111111111111111111111111111111",
"to": "0x2222222222222222222222222222222222222222",
"data": "0xffffffff"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"gas_limit": "0x156c00",
"gas_per_pubdata_limit": "0x143b",
"max_fee_per_gas": "0xee6b280",
"max_priority_fee_per_gas": "0x0"
}
}
```
# zks_estimateGasL1ToL2
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-estimate-gas-l1-to-l2
Returns an estimate of the gas required for a layer 1 (L1) to layer 2 (L2) transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Positional parameters for zks\_estimateGasL1ToL2:
params\[0]: Type: object.
### Returns
The estimated gas required for a L1 to L2 transaction, in hexadecimal format. Example: "0x25f64db".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_estimateGasL1ToL2",
"params": [
{
"from": "0x1111111111111111111111111111111111111111",
"to": "0x2222222222222222222222222222222222222222",
"data": "0xffffffff"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x25f64db"
}
```
# zks_getAllAccountBalances
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-get-all-account-balances
Returns all balances for confirmed tokens given by an account address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Positional parameters for zks\_getAllAccountBalances:
params\[]: The account address to retrieve confirmed token balances for.
### Returns
Key-value pairs of token addresses and their corresponding balances (in hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_getAllAccountBalances",
"params": [
"0x98E9D288743839e96A8005a6B51C770Bbf7788C0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"0x0000000000000000000000000000000000000000": "0x2fbd72a1121b3100"
}
}
```
# zks_getBlockDetails
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-get-block-details
Returns additional ZKsync-specific information about the L2 block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Positional parameters for zks\_getBlockDetails:
params\[]: The number of the L2 block to fetch details for.
### Returns
Detailed information about a ZKsync L2 block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_getBlockDetails",
"params": [
140599
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# zks_getBridgeContracts
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-get-bridge-contracts
Returns the L1 and L2 address of the default bridges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Default L1 and L2 bridge contract addresses for ERC-20 tokens.
Address of the default bridge contract on Layer 1.
Address of the default bridge contract on Layer 2.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_getBridgeContracts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# zks_getBytecodeByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-get-bytecode-by-hash
Returns the bytecode of a transaction for the provided hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Positional parameters for zks\_getBytecodeByHash:
params\[]: The hash of the bytecode to retrieve.
### Returns
The bytecode array representing the transaction's bytecode.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_getBytecodeByHash",
"params": [
"0x0100067d861e2f5717a12c3e869cfb657793b86bbb0caa05cc1421f16c5217bc"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
0,
4,
0,
0,
"..."
]
}
```
# zks_getL1BatchBlockRange
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-get-l1-batch-block-range
Returns the range of blocks contained within a given batch.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Returns the L2 block range included in the given L1 batch.
Positional parameters for zks\_getL1BatchBlockRange:
params\[]: The L1 batch number.
### Returns
Hexadecimal range of block numbers included in the batch.
A hexadecimal-encoded block number.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_getL1BatchBlockRange",
"params": [
12345
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x116fec",
"0x117015"
]
}
```
# zks_getL1BatchDetails
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-get-l1-batch-details
Returns data pertaining to a given L1 batch.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Positional parameters for zks\_getL1BatchDetails:
params\[]: The layer 1 batch number to query details for.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_getL1BatchDetails",
"params": [
12345
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"baseSystemContractsHashes": {
"bootloader": "0x010007793a328ef16cc7086708f7f3292ff9b5eed9e7e539c184228f461bf4ef",
"default_aa": "0x0100067d861e2f5717a12c3e869cfb657793b86bbb0caa05cc1421f16c5217bc"
},
"commitTxHash": "0xd045e3698f018cb233c3817eb53a41a4c5b28784ffe659da246aa33bda34350c",
"committedAt": "2023-03-26T07:21:21.046817Z",
"executeTxHash": "0xbb66aa75f437bb4255cf751badfc6b142e8d4d3a4e531c7b2e737a22870ff19e",
"executedAt": "2023-03-27T07:44:52.187764Z",
"l1BatchNumber": 12345,
"l1GasPrice": 20690385511,
"l1TxCount": 0,
"__truncated": true
}
}
```
# zks_getL2ToL1LogProof
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-get-l2-to-l1-log-proof
Returns the proof for the corresponding L2 to L1 log, given a transaction hash and the index of the L2 to L1 log produced within the transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Positional parameters for zks\_getL2ToL1LogProof:
params\[0]: The hash of the L2 transaction.
params\[1]: The index of the L2 to L1 log in the transaction.
### Returns
The JSON-RPC result.
The position of the leaf in the Merkle tree of L2->L1 messages for the block.
The Merkle proof for the message.
Hex-encoded proof element.
The root hash representing the Merkle tree root at the time the L2 to L1 log was generated.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_getL2ToL1LogProof",
"params": [
"0x2a1c6c74b184965c0cb015aae9ea134fd96215d2e4f4979cfec12563295f610e",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"id": 42,
"proof": [
"0xabc123abc123abc123abc123abc123abc123abc123abc123abc123abc123abc1",
"0xdef456def456def456def456def456def456def456def456def456def456def4"
],
"root": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890"
}
}
```
# zks_getL2ToL1MsgProof
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-get-l2-to-l1-msg-proof
Returns the proof for a message sent through the L1Messenger system contract, given a block, sender, message, and an optional message log index containing the L1 to L2 message.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Positional parameters for zks\_getL2ToL1MsgProof:
params\[0]: The block number in which the message was emitted.
params\[1]: The address that sent the message.
params\[2]: The keccak256 hash of the message being proved.
params\[3]: Optional index in the block of the L1Messenger event log. Defaults to the first message if omitted.
### Returns
The JSON-RPC result.
The position of the message in the Merkle tree.
The Merkle proof array for the message.
The Merkle root at the time the message was logged.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_getL2ToL1MsgProof",
"params": [
5187,
"0x87869cb87c4Fa78ca278dF358E890FF73B42a39E",
"0x22de7debaa98758afdaee89f447ff43bab5da3de6acca7528b281cc2f1be2ee9"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"id": 0,
"proof": [
"0xabc123...",
"0xdef456..."
],
"root": "0xf1adac176fc939313eea4b72055db0622a10bbd9b7a83097286e84e471d2e7df"
}
}
```
# zks_getMainContract
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-get-main-contract
Returns the address of the ZKsync Era contract.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The address of the ZKsync Era main contract. Example: "0x32400084c286cf3e17e7b677ea9583e60a000324".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_getMainContract",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x32400084c286cf3e17e7b677ea9583e60a000324"
}
```
# zks_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-get-proof
Returns Merkle proofs for one or more storage values for the specified account along with a Merkle proof of their authenticity. This allows you to verify that the values have not been tampered with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Positional parameters for zks\_getProof:
params\[0]: The account address to fetch storage proofs for.
params\[1]: Vector of storage keys in the account.
params\[2]: The L1 batch number specifying the point in time for the storage proof.
### Returns
The JSON-RPC result.
The account address for which the proof was fetched.
An array of proofs for each requested key.
The requested storage key.
The value stored at the key.
The index of the entry in the Merkle tree.
Merkle proof path from root to the leaf (excluding root).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_getProof",
"params": [
"0x0000000000000000000000000000000000008003",
[
"0x8b65c0cf1012ea9f393197eb24619fd814379b298b238285649e14f936a5eb12"
],
354895
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x0000000000000000000000000000000000008003",
"storageProof": [
{
"key": "0x8b65c0cf1012ea9f393197eb24619fd814379b298b238285649e14f936a5eb12",
"value": "0x0000000000000000000000000000000000000000000000000000000000000060",
"index": 27900957,
"proof": [
"..."
]
}
]
}
}
```
# zks_getRawBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-get-raw-block-transactions
Returns data about the transactions in the specified block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Block number to get raw transaction data from.
Positional parameters for zks\_getRawBlockTransactions:
params\[]: The L2 block number.
### Returns
List of executed transactions in the given block.
The timestamp in milliseconds the transaction was received.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_getRawBlockTransactions",
"params": [
5817
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# zks_getTestnetPaymaster
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-get-testnet-paymaster
Returns the address of the testnet paymaster available on testnets and enables paying fees in ERC-20 compatible tokens.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The address of the testnet paymaster. Example: "0x8f0ea1312da29f17eabeb2f484fd3c112cccdd63".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_getTestnetPaymaster",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x8f0ea1312da29f17eabeb2f484fd3c112cccdd63"
}
```
# zks_getTransactionDetails
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-get-transaction-details
Returns data about a transaction given by the transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The transaction hash in hexadecimal format.
Positional parameters for zks\_getTransactionDetails:
params\[]: Type: string.
### Returns
Object containing transaction metadata and status details.
Transaction hash of the commit transaction.
Transaction hash of the execution transaction.
Ethereum transaction hash of the proof transaction.
The fee for the transaction.
Gas per public data unit.
The address of the transaction initiator.
True if the transaction originated from L1.
Timestamp when the transaction was received.
The current status of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_getTransactionDetails",
"params": [
"0x22de7debaa98758afdaee89f447ff43bab5da3de6acca7528b281cc2f1be2ee9"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"ethCommitTxHash": "0x3da5b6eda357189c9243c41c5a33b1b2ed0169be172705d74681a25217702772",
"ethExecuteTxHash": "0xdaff5fd7ff91333b161de54534b4bb6a78e5325329959a0863bf0aae2b0fdcc6",
"ethProveTxHash": "0x2f482d3ea163f5be0c2aca7819d0beb80415be1a310e845a2d726fbc4ac54c80",
"fee": "0x0",
"gasPerPubdata": "0x320",
"initiatorAddress": "0x87869cb87c4fa78ca278df358e890ff73b42a39e",
"isL1Originated": true,
"receivedAt": "2023-03-03T23:52:24.169Z",
"__truncated": true
}
}
```
# zks_L1BatchNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-l1-batch-number
Returns the latest L1 batch number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The latest L1 batch number in hexadecimal format. Example: "0x544c".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_L1BatchNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x544c"
}
```
# zks_L1ChainId
Source: https://docs.uniblock.dev/reference/jsonrpc/11124/zks/zks-l1-chain-id
Returns the chain ID of the underlying L1.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The chain ID of the underlying L1 network, in hexadecimal format. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11124 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "zks_L1ChainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# Celo Sepolia (CELO) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/celo-sepolia-overview
Celo Sepolia is an EVM-compatible testnet. It is a testnet for Celo. Its ticker symbol is `CELO`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Celo Sepolia
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| -------------- | ------ | ------- | ---------- |
| Celo | `CELO` | Mainnet | `42220` |
| Celo Alfajores | `CELO` | Testnet | `44787` |
| Celo Sepolia | `CELO` | Testnet | `11142220` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/11142220/debug/debug-account-range)
* [EVM](/reference/jsonrpc/11142220/evm/eth-accounts)
# debug_accountRange
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-account-range
Returns the accounts within a specific key range for the given block state.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier, startKey, maxResults, context?].
Positional parameters for debug\_accountRange:
params\[0]: Block number or hash at which to inspect state (hex quantity or 32-byte hash).
params\[3]: Optional context returned from a previous call to continue iteration.
### Returns
Account range response including account details and continuation token.
Next account key to resume iteration, or null if complete.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_accountRange",
"params": [
"",
"",
0,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_chaindbCompact
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-chaindb-compact
Triggers LevelDB compaction for the chain database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
True if compaction finished successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_chaindbCompact",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_chaindbProperty
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-chaindb-property
Returns diagnostic information about the chain database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[property].
Positional parameters for debug\_chaindbProperty:
params\[]: Name of the database property to query (e.g., "leveldb.stats").
### Returns
Property value returned by the key-value store.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_chaindbProperty",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncient
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-db-ancient
Returns the ancient (freezer) data item at the given index for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table, index].
Positional parameters for debug\_dbAncient:
params\[0]: Ancient table name (e.g., "headers", "bodies").
params\[1]: Zero-based index within the ancient table.
### Returns
Hex-encoded RLP payload stored at the requested slot.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncient",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncients
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-db-ancients
Returns the number of ancient entries stored for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table].
Positional parameters for debug\_dbAncients:
params\[]: Ancient table name.
### Returns
Count of stored ancient items. Example: 1024.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncients",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": 1024
}
```
# debug_gcStats
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-gc-stats
Returns garbage collection statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Garbage collection stats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_gcStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getAccessibleState
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-get-accessible-state
Returns the oldest block whose state is still retained locally.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Hex block number representing the earliest accessible state. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getAccessibleState",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-get-bad-blocks
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_getModifiedAccountsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-get-modified-accounts-by-hash
Returns the addresses of accounts modified by the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for debug\_getModifiedAccountsByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getModifiedAccountsByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-get-modified-accounts-by-number
Returns the addresses of accounts modified in the specified block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for debug\_getModifiedAccountsByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByNumber",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getRawBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-get-raw-block
Retrieves and returns the RLP encoded block by number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawBlock: \[blockNrOrHash].
Positional parameters for debug\_getRawBlock:
params\[]: The block number or hash.
### Returns
The RLP encoded data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawBlock",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawHeader
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-get-raw-header
Returns an RLP-encoded header.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[blockNrOrHash].
Positional parameters for debug\_getRawHeader:
params\[]: The block number or hash.
### Returns
The RLP encoded header data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawHeader",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-get-raw-receipts
Returns the consensus-encoding of all receipts in a single block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawReceipts: \[blockNrOrHash].
Positional parameters for debug\_getRawReceipts:
params\[]: The block number or hash.
### Returns
The consensus-encoding of all receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawReceipts",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-get-raw-transaction
Returns the bytes of the transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[transactionHash].
Positional parameters for debug\_getRawTransaction:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
The bytes of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getTrieFlushInterval
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-get-trie-flush-interval
Retrieves the current value of in-memory trie flush interval.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current value of in-memory trie flush interval.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getTrieFlushInterval",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_goTrace
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-go-trace
Starts a Go execution trace and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_goTrace:
params\[0]: Destination file for the execution trace.
params\[1]: Duration to trace in seconds.
### Returns
True if tracing completed successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_goTrace",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_intermediateRoots
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-intermediate-roots
Returns the intermediate state trie roots for each transaction in the given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier].
Positional parameters for debug\_intermediateRoots:
params\[]: Block number or hash in hex.
### Returns
State root hashes after each transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_intermediateRoots",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_memStats
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-mem-stats
Returns current runtime memory statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Statistics mirroring Go runtime.MemStats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_memStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_mutexProfile
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-mutex-profile
Captures mutex contention profile information and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_mutexProfile:
params\[0]: Destination file for the mutex profile.
params\[1]: Duration to capture in seconds.
### Returns
True if the mutex profile was written successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_mutexProfile",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_printBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-print-block
Pretty-prints the specified block for human inspection.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier].
Positional parameters for debug\_printBlock:
params\[]: Block number or hash.
### Returns
True if the block information was written to the log output. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_printBlock",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_stacks
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-stacks
Collects and writes all goroutine stack traces to the given file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath].
Positional parameters for debug\_stacks:
params\[]: Destination file path.
### Returns
True if stack traces were written. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_stacks",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_storageRangeAt
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-storage-range-at
Returns the storage at the given block height and transaction index. The result can be paged by providing a maxResult to cap the number of storage slots returned as well as specifying the offset via keyStart (hash of storage key).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, txIdx, contractAddress, keyStart, maxResult]
Positional parameters for debug\_storageRangeAt:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Index of the transaction within the block.
params\[2]: 20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
params\[3]: Starting key (32-byte hex string) used for filtering storage or entries.
params\[4]: Maximum number of results to return.
### Returns
The array of storage items.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": [
"0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
0,
"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"0x0000000000000000000000000000000000000000000000000000000000000000",
1
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBadBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-trace-bad-block
Executes the transactions in a bad block and returns the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, options?].
Positional parameters for debug\_traceBadBlock:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBadBlock",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-trace-block
The traceBlock method will return a full stack trace of all invoked opcodes of all transaction that were included in this block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_traceBlock: \[blockRlp, traceConfig].
Positional parameters for debug\_traceBlock:
params\[0]: The RLP encoded block.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlock",
"params": [
"RLP_ENCODED_BLOCK",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockFromFile
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-trace-block-from-file
Traces all transactions contained within an RLP-encoded block file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, options?].
Positional parameters for debug\_traceBlockFromFile:
params\[0]: Path to the block file.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockFromFile",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_blobBaseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-blob-base-fee
Returns the expected base fee for blobs in the next block, in wei (hexadecimal format).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The expected blob base fee for the next block (QUANTITY in wei, 64 bits). Example: "0x174876e800".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blobBaseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x174876e800"
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getRawTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-raw-transaction-by-block-hash-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockHashAndIndex:
params\[0]: The hash of the block containing the transaction.
params\[1]: The index position of the transaction in the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the signature. Example: "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockHashAndIndex",
"params": [
"0x7e4aea365093a183b0df5f003f26144ef04ec8a6e7f4910356590c5fc7b1671f",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b..."
}
```
# eth_getRawTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-raw-transaction-by-block-number-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockNumberAndIndex:
params\[0]: The block number (hex string or tag like "latest", "finalized", "safe").
params\[1]: The index of the transaction within the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the full signed transaction. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockNumberAndIndex",
"params": [
"0x10fb78",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getRawTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-raw-transaction-by-hash
Retrieves the raw transaction data as a hexadecimal string for the given transaction hash, including all signature components.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionHash]
Positional parameters for eth\_getRawTransactionByHash:
params\[]: The hash of the transaction (32-byte hex string).
### Returns
Raw transaction data in hexadecimal format, including sender, recipient, gas, data, and signature. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-hashrate
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-mining
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sendTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-send-transaction
Creates new message call transaction or a contract creation, if the data field contains code.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendTransaction: \[transactionObject]
Positional parameters for eth\_sendTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sign
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-sign
The sign method calculates an Ethereum specific signature with: sign(keccak256("Ethereum Signed Message: " + len(message) + message))).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sign: \[address, data].
Positional parameters for eth\_sign:
params\[0]: The address.
params\[1]: Data which hash to sign.
### Returns
Data - Signed data. Example: "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a539310c6ecd1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sign",
"params": [
"0xcd2a3d9f938e13cd947ec05abc7fe734df8dd826",
"0x5363686f6f6c627573"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a5..."
}
```
# eth_signTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-sign-transaction
Signs transactions without dispatching it to the network. It can be later submitted using eth_sendRawTransaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_signTransaction: \[transactionObject]
Positional parameters for eth\_signTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
Signed transaction and its details.
Data - The signed, RLP encoded transaction.
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_signTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"raw": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
"tx": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
}
```
# eth_simulateV1
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-simulate-v1
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_simulateV1",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/11142220/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11142220 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# debug_accountRange
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-account-range
Returns the accounts within a specific key range for the given block state.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier, startKey, maxResults, context?].
Positional parameters for debug\_accountRange:
params\[0]: Block number or hash at which to inspect state (hex quantity or 32-byte hash).
params\[3]: Optional context returned from a previous call to continue iteration.
### Returns
Account range response including account details and continuation token.
Next account key to resume iteration, or null if complete.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_accountRange",
"params": [
"",
"",
0,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_chaindbCompact
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-chaindb-compact
Triggers LevelDB compaction for the chain database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
True if compaction finished successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_chaindbCompact",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_chaindbProperty
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-chaindb-property
Returns diagnostic information about the chain database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[property].
Positional parameters for debug\_chaindbProperty:
params\[]: Name of the database property to query (e.g., "leveldb.stats").
### Returns
Property value returned by the key-value store.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_chaindbProperty",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncient
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-db-ancient
Returns the ancient (freezer) data item at the given index for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table, index].
Positional parameters for debug\_dbAncient:
params\[0]: Ancient table name (e.g., "headers", "bodies").
params\[1]: Zero-based index within the ancient table.
### Returns
Hex-encoded RLP payload stored at the requested slot.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncient",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncients
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-db-ancients
Returns the number of ancient entries stored for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table].
Positional parameters for debug\_dbAncients:
params\[]: Ancient table name.
### Returns
Count of stored ancient items. Example: 1024.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncients",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": 1024
}
```
# debug_gcStats
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-gc-stats
Returns garbage collection statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Garbage collection stats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_gcStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getAccessibleState
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-get-accessible-state
Returns the oldest block whose state is still retained locally.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Hex block number representing the earliest accessible state. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getAccessibleState",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-get-bad-blocks
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_getModifiedAccountsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-get-modified-accounts-by-hash
Returns the addresses of accounts modified by the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for debug\_getModifiedAccountsByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getModifiedAccountsByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-get-modified-accounts-by-number
Returns the addresses of accounts modified in the specified block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber].
Positional parameters for debug\_getModifiedAccountsByNumber:
params\[0]: Type: number.
params\[1]: Type: string.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByNumber",
"params": [
0,
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getRawBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-get-raw-block
Retrieves and returns the RLP encoded block by number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawBlock: \[blockNrOrHash].
Positional parameters for debug\_getRawBlock:
params\[]: The block number or hash.
### Returns
The RLP encoded data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawBlock",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawHeader
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-get-raw-header
Returns an RLP-encoded header.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[blockNrOrHash].
Positional parameters for debug\_getRawHeader:
params\[]: The block number or hash.
### Returns
The RLP encoded header data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawHeader",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-get-raw-receipts
Returns the consensus-encoding of all receipts in a single block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawReceipts: \[blockNrOrHash].
Positional parameters for debug\_getRawReceipts:
params\[]: The block number or hash.
### Returns
The consensus-encoding of all receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawReceipts",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-get-raw-transaction
Returns the bytes of the transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[transactionHash].
Positional parameters for debug\_getRawTransaction:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
The bytes of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getTrieFlushInterval
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-get-trie-flush-interval
Retrieves the current value of in-memory trie flush interval.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current value of in-memory trie flush interval.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getTrieFlushInterval",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_goTrace
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-go-trace
Starts a Go execution trace and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_goTrace:
params\[0]: Destination file for the execution trace.
params\[1]: Duration to trace in seconds.
### Returns
True if tracing completed successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_goTrace",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_intermediateRoots
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-intermediate-roots
Returns the intermediate state trie roots for each transaction in the given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier].
Positional parameters for debug\_intermediateRoots:
params\[]: Block number or hash in hex.
### Returns
State root hashes after each transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_intermediateRoots",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_memStats
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-mem-stats
Returns current runtime memory statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Statistics mirroring Go runtime.MemStats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_memStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_mutexProfile
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-mutex-profile
Captures mutex contention profile information and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_mutexProfile:
params\[0]: Destination file for the mutex profile.
params\[1]: Duration to capture in seconds.
### Returns
True if the mutex profile was written successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_mutexProfile",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_printBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-print-block
Pretty-prints the specified block for human inspection.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier].
Positional parameters for debug\_printBlock:
params\[]: Block number or hash.
### Returns
True if the block information was written to the log output. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_printBlock",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_stacks
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-stacks
Collects and writes all goroutine stack traces to the given file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath].
Positional parameters for debug\_stacks:
params\[]: Destination file path.
### Returns
True if stack traces were written. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_stacks",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_storageRangeAt
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-storage-range-at
Returns the storage at the given block height and transaction index. The result can be paged by providing a maxResult to cap the number of storage slots returned as well as specifying the offset via keyStart (hash of storage key).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, txIdx, contractAddress, keyStart, maxResult]
Positional parameters for debug\_storageRangeAt:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Index of the transaction within the block.
params\[2]: 20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
params\[3]: Starting key (32-byte hex string) used for filtering storage or entries.
params\[4]: Maximum number of results to return.
### Returns
The array of storage items.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": [
"0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
0,
"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"0x0000000000000000000000000000000000000000000000000000000000000000",
1
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBadBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-trace-bad-block
Executes the transactions in a bad block and returns the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, options?].
Positional parameters for debug\_traceBadBlock:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBadBlock",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-trace-block
The traceBlock method will return a full stack trace of all invoked opcodes of all transaction that were included in this block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_traceBlock: \[blockRlp, traceConfig].
Positional parameters for debug\_traceBlock:
params\[0]: The RLP encoded block.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlock",
"params": [
"RLP_ENCODED_BLOCK",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockFromFile
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-trace-block-from-file
Traces all transactions contained within an RLP-encoded block file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, options?].
Positional parameters for debug\_traceBlockFromFile:
params\[0]: Path to the block file.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockFromFile",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceCallMany
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-trace-call-many
Executes a list of bundles (a bundle is a collection of transactions), without creating transactions on the blockchain. Returns their traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for debug\_traceCallMany. 1. Bundles (required): an array of bundles. Each bundle is an object with: - transactions: an array of transaction objects (each with fields such as from, to, value, data), - blockOverride (optional): an object with overrides (blockNumber, blockHash mapping, coinbase, timestamp, difficulty, gasLimit, baseFee). 2. Simulation context (required): an object with blockIdentifier (a hex block number or one of "latest", "earliest", "pending", "safe", "finalized") and transactionIndex (integer, default -1). 3. State overrides (optional): an object mapping addresses to state override objects (here, at least a balance override as a hex string). 4. Timeout (optional): integer timeout in milliseconds (default 5000). 5. Trace type (optional): an object with tracer (string, enum: callTracer, prestateTracer), tracerConfig (object), and onlyTopCall (boolean).
Positional parameters for debug\_traceCallMany:
params\[0]: List of bundles. Each bundle is an object with transactions and an optional blockOverride.
params\[1]: Simulation context. Contains blockIdentifier (a hex block number or tag) and transactionIndex (default -1).
params\[2]: Optional state overrides: a mapping from address to an override object (e.g. balance).
### Returns
Array of trace responses corresponding to each simulated bundle. Each trace response is one of: callTracer response, prestateTracer response, or opcode (struct) response.
CallTracer response.
CallTracer response.
Type of the call.
Sender address.
Recipient address.
Gas provided by the sender.
Actual value deducted from the sender (per gas).
Total gas used by the call.
Input data (4-byte method selector).
Return value (hex).
Error message if execution failed.
List of sub-calls (nested call frames).
A nested call frame with additional details.
Revert reason, if available.
PrestateTracer response.
Smart contract address associated with the result.
Balance of the contract in wei (hex).
Bytecode of the contract (hex).
Nonce of the contract account.
Mapping of storage slots (hex keys and values).
Opcode (struct) trace response.
Indicates whether the execution failed.
Total consumed gas (hex).
Return value of the executed call (hex).
Array of execution step logs.
Program counter.
Operation name.
Available gas at this step.
Gas cost of the operation.
Call depth.
Stack values at this step.
Storage state at this step.
Refund amount (hex).
Error message, if any.
Memory snapshot at this step (array of hex strings).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCallMany",
"params": [
[],
{},
{},
5000,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# erigon_getHeaderByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/erigon/erigon-get-header-by-number
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getHeaderByNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# Ethereum Sepolia (ETH) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/ethereum-sepolia-overview
Ethereum Sepolia is an EVM-compatible testnet. It is a testnet for Ethereum. Its ticker symbol is `ETH`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Ethereum Sepolia
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ---------------- | ------ | ------- | ---------- |
| Ethereum | `ETH` | Mainnet | `1` |
| Ethereum Holesky | `ETH` | Testnet | `17000` |
| Ethereum Hoodi | `ETH` | Testnet | `560048` |
| Ethereum Sepolia | `ETH` | Testnet | `11155111` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/11155111/debug/debug-account-range)
* [Erigon](/reference/jsonrpc/11155111/erigon/erigon-get-header-by-number)
* [EVM](/reference/jsonrpc/11155111/evm/eth-accounts)
* [Otterscan](/reference/jsonrpc/11155111/otterscan/ots-get-api-level)
* [Trace](/reference/jsonrpc/11155111/trace/trace-block)
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_blobBaseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-blob-base-fee
Returns the expected base fee for blobs in the next block, in wei (hexadecimal format).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The expected blob base fee for the next block (QUANTITY in wei, 64 bits). Example: "0x174876e800".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blobBaseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x174876e800"
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-call-many
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_callMany",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getAccount
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-account
Retrieves detailed account information for a given address at a specific block number or tag.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, blockReference]
Positional parameters for eth\_getAccount:
params\[0]: The address of the account (20-byte hex string).
params\[1]: Block reference: block number in hex, integer, or tag ("latest", "pending", "safe", "finalized").
### Returns
Account information at the specified block.
32-byte hash of the account’s code.
Hash of the account’s storage trie.
Account balance in wei (hexadecimal).
Number of transactions sent from the account.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getAccount",
"params": [
"0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"codeHash": "0x3f30cbb24e7a53efc981dcf566da48e6e9b5418d26c4763fdb4e83e7bcd0c9c5",
"storageRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"balance": "0x38d7ea4c68000",
"nonce": "0x10"
}
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getRawTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-raw-transaction-by-block-hash-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockHashAndIndex:
params\[0]: The hash of the block containing the transaction.
params\[1]: The index position of the transaction in the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the signature. Example: "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockHashAndIndex",
"params": [
"0x7e4aea365093a183b0df5f003f26144ef04ec8a6e7f4910356590c5fc7b1671f",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b..."
}
```
# eth_getRawTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-raw-transaction-by-block-number-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockNumberAndIndex:
params\[0]: The block number (hex string or tag like "latest", "finalized", "safe").
params\[1]: The index of the transaction within the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the full signed transaction. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockNumberAndIndex",
"params": [
"0x10fb78",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getRawTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-raw-transaction-by-hash
Retrieves the raw transaction data as a hexadecimal string for the given transaction hash, including all signature components.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionHash]
Positional parameters for eth\_getRawTransactionByHash:
params\[]: The hash of the transaction (32-byte hex string).
### Returns
Raw transaction data in hexadecimal format, including sender, recipient, gas, data, and signature. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-hashrate
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-mining
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendPrivateTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-send-private-transaction
Sends a signed transaction to a private relay (like Flashbots Protect) for inclusion in a block without exposure to the public mempool. Provides frontrunning and revert protection.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionPayload]
Positional parameters for eth\_sendPrivateTransaction:
params\[]: Payload object containing raw transaction and optional execution constraints.
### Returns
Returns true if the transaction was successfully accepted, false otherwise. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendPrivateTransaction",
"params": [
{
"tx": "0xf86c808504a817c80082520894a0df350d2637096571f7a701cb5b1660d90cecb380b844a9059cbb000000000000000000000000b60e8dd61c5d32be8058bb8eb970870f07233155",
"maxBlockNumber": "0x10fb80",
"preferences": {
"fast": true
}
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sendTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-send-transaction
Creates new message call transaction or a contract creation, if the data field contains code.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendTransaction: \[transactionObject]
Positional parameters for eth\_sendTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sign
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-sign
The sign method calculates an Ethereum specific signature with: sign(keccak256("Ethereum Signed Message: " + len(message) + message))).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sign: \[address, data].
Positional parameters for eth\_sign:
params\[0]: The address.
params\[1]: Data which hash to sign.
### Returns
Data - Signed data. Example: "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a539310c6ecd1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sign",
"params": [
"0xcd2a3d9f938e13cd947ec05abc7fe734df8dd826",
"0x5363686f6f6c627573"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a5..."
}
```
# eth_signTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-sign-transaction
Signs transactions without dispatching it to the network. It can be later submitted using eth_sendRawTransaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_signTransaction: \[transactionObject]
Positional parameters for eth\_signTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
Signed transaction and its details.
Data - The signed, RLP encoded transaction.
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_signTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"raw": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
"tx": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
}
```
# eth_simulateV1
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-simulate-v1
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_simulateV1",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_submitWork
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-submit-work
Used for submitting a proof-of-work solution.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_submitWork: \[nonce, powHash, mixHash].
Positional parameters for eth\_submitWork:
params\[0]: 8 Bytes - The nonce found (64 bits).
params\[1]: 32 Bytes - The header’s pow-hash (256 bits)
params\[2]: Data - 32 Bytes - The mix digest (256 bits).
### Returns
Boolean - returns true if the provided solution is valid, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_submitWork",
"params": [
"0x0000000000000001",
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"0xD1FE5700000000000000000000000000D1FE5700000000000000000000000000"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_subscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-subscribe
Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_subscribe: \[subscriptionType, options]. The second parameter is required only for "logs".
Positional parameters for eth\_subscribe:
params\[0]: Subscription type. Must be either "newHeads" or "logs".
params\[1]: Filter options for "logs" subscription, or empty object for "newHeads".
### Returns
Assigned subscription ID Example: "0xb53c4832f1dca4a5".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_subscribe",
"params": [
"logs",
{
"fromBlock": "latest",
"toBlock": "latest"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb53c4832f1dca4a5"
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# ots_getApiLevel
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/otterscan/ots-get-api-level
Very simple API versioning scheme. Every time we add a new capability, the number is incremented. This allows for Otterscan to check if the Erigon node contains all API it needs.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Number - containing the API version.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "ots_getApiLevel",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": 0
}
```
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/trace/trace-block
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/trace/trace-call
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/trace/trace-call-many
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/trace/trace-filter
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/trace/trace-get
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/trace/trace-raw-transaction
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/trace/trace-replay-block-transactions
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155111/trace/trace-replay-transaction
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155111 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# debug_dbAncient
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-db-ancient
Returns the ancient (freezer) data item at the given index for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table, index].
Positional parameters for debug\_dbAncient:
params\[0]: Ancient table name (e.g., "headers", "bodies").
params\[1]: Zero-based index within the ancient table.
### Returns
Hex-encoded RLP payload stored at the requested slot.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncient",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncients
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-db-ancients
Returns the number of ancient entries stored for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table].
Positional parameters for debug\_dbAncients:
params\[]: Ancient table name.
### Returns
Count of stored ancient items. Example: 1024.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncients",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": 1024
}
```
# debug_gcStats
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-gc-stats
Returns garbage collection statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Garbage collection stats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_gcStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-get-bad-blocks
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_getRawBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-get-raw-block
Retrieves and returns the RLP encoded block by number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawBlock: \[blockNrOrHash].
Positional parameters for debug\_getRawBlock:
params\[]: The block number or hash.
### Returns
The RLP encoded data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawBlock",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawHeader
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-get-raw-header
Returns an RLP-encoded header.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[blockNrOrHash].
Positional parameters for debug\_getRawHeader:
params\[]: The block number or hash.
### Returns
The RLP encoded header data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawHeader",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-get-raw-receipts
Returns the consensus-encoding of all receipts in a single block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawReceipts: \[blockNrOrHash].
Positional parameters for debug\_getRawReceipts:
params\[]: The block number or hash.
### Returns
The consensus-encoding of all receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawReceipts",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-get-raw-transaction
Returns the bytes of the transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[transactionHash].
Positional parameters for debug\_getRawTransaction:
params\[]: 32 Bytes - Hash of the transaction.
### Returns
The bytes of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getTrieFlushInterval
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-get-trie-flush-interval
Retrieves the current value of in-memory trie flush interval.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current value of in-memory trie flush interval.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getTrieFlushInterval",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_storageRangeAt
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-storage-range-at
Returns the storage at the given block height and transaction index. The result can be paged by providing a maxResult to cap the number of storage slots returned as well as specifying the offset via keyStart (hash of storage key).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, txIdx, contractAddress, keyStart, maxResult]
Positional parameters for debug\_storageRangeAt:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Index of the transaction within the block.
params\[2]: 20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
params\[3]: Starting key (32-byte hex string) used for filtering storage or entries.
params\[4]: Maximum number of results to return.
### Returns
The array of storage items.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": [
"0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
0,
"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"0x0000000000000000000000000000000000000000000000000000000000000000",
1
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-trace-block
The traceBlock method will return a full stack trace of all invoked opcodes of all transaction that were included in this block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_traceBlock: \[blockRlp, traceConfig].
Positional parameters for debug\_traceBlock:
params\[0]: The RLP encoded block.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlock",
"params": [
"RLP_ENCODED_BLOCK",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceCallMany
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-trace-call-many
Executes a list of bundles (a bundle is a collection of transactions), without creating transactions on the blockchain. Returns their traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for debug\_traceCallMany. 1. Bundles (required): an array of bundles. Each bundle is an object with: - transactions: an array of transaction objects (each with fields such as from, to, value, data), - blockOverride (optional): an object with overrides (blockNumber, blockHash mapping, coinbase, timestamp, difficulty, gasLimit, baseFee). 2. Simulation context (required): an object with blockIdentifier (a hex block number or one of "latest", "earliest", "pending", "safe", "finalized") and transactionIndex (integer, default -1). 3. State overrides (optional): an object mapping addresses to state override objects (here, at least a balance override as a hex string). 4. Timeout (optional): integer timeout in milliseconds (default 5000). 5. Trace type (optional): an object with tracer (string, enum: callTracer, prestateTracer), tracerConfig (object), and onlyTopCall (boolean).
Positional parameters for debug\_traceCallMany:
params\[0]: List of bundles. Each bundle is an object with transactions and an optional blockOverride.
params\[1]: Simulation context. Contains blockIdentifier (a hex block number or tag) and transactionIndex (default -1).
params\[2]: Optional state overrides: a mapping from address to an override object (e.g. balance).
### Returns
Array of trace responses corresponding to each simulated bundle. Each trace response is one of: callTracer response, prestateTracer response, or opcode (struct) response.
CallTracer response.
CallTracer response.
Type of the call.
Sender address.
Recipient address.
Gas provided by the sender.
Actual value deducted from the sender (per gas).
Total gas used by the call.
Input data (4-byte method selector).
Return value (hex).
Error message if execution failed.
List of sub-calls (nested call frames).
A nested call frame with additional details.
Revert reason, if available.
PrestateTracer response.
Smart contract address associated with the result.
Balance of the contract in wei (hex).
Bytecode of the contract (hex).
Nonce of the contract account.
Mapping of storage slots (hex keys and values).
Opcode (struct) trace response.
Indicates whether the execution failed.
Total consumed gas (hex).
Return value of the executed call (hex).
Array of execution step logs.
Program counter.
Operation name.
Available gas at this step.
Gas cost of the operation.
Call depth.
Stack values at this step.
Storage state at this step.
Refund amount (hex).
Error message, if any.
Memory snapshot at this step (array of hex strings).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCallMany",
"params": [
[],
{},
{},
5000,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# erigon_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/erigon/erigon-block-number
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_forks
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/erigon/erigon-forks
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_forks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getBlockByTimestamp
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/erigon/erigon-get-block-by-timestamp
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getBlockByTimestamp",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getBlockReceiptsByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/erigon/erigon-get-block-receipts-by-block-hash
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getBlockReceiptsByBlockHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getHeaderByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/erigon/erigon-get-header-by-hash
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getHeaderByHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getHeaderByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/erigon/erigon-get-header-by-number
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getHeaderByNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getLatestLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/erigon/erigon-get-latest-logs
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getLatestLogs",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# erigon_getLogsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/erigon/erigon-get-logs-by-hash
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getLogsByHash",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_baseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-base-fee
Returns the base fee for the next block, in hexadecimal format representing wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
Hex-encoded base fee for the next block (in wei). Example: "0x2e90edd000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_baseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2e90edd000"
}
```
# eth_blobBaseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-blob-base-fee
Returns the expected base fee for blobs in the next block, in wei (hexadecimal format).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The expected blob base fee for the next block (QUANTITY in wei, 64 bits). Example: "0x174876e800".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blobBaseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x174876e800"
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-call-many
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_callMany",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getRawTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-raw-transaction-by-block-hash-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockHashAndIndex:
params\[0]: The hash of the block containing the transaction.
params\[1]: The index position of the transaction in the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the signature. Example: "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockHashAndIndex",
"params": [
"0x7e4aea365093a183b0df5f003f26144ef04ec8a6e7f4910356590c5fc7b1671f",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86b018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008026a0ba4681b..."
}
```
# eth_getRawTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-raw-transaction-by-block-number-and-index
Retrieves the raw transaction data as a hexadecimal string for a transaction at a given index in a block, identified by its block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber, transactionIndex]
Positional parameters for eth\_getRawTransactionByBlockNumberAndIndex:
params\[0]: The block number (hex string or tag like "latest", "finalized", "safe").
params\[1]: The index of the transaction within the block (hexadecimal).
### Returns
Raw transaction data as a hexadecimal string, including the full signed transaction. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByBlockNumberAndIndex",
"params": [
"0x10fb78",
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getRawTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-raw-transaction-by-hash
Retrieves the raw transaction data as a hexadecimal string for the given transaction hash, including all signature components.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionHash]
Positional parameters for eth\_getRawTransactionByHash:
params\[]: The hash of the transaction (32-byte hex string).
### Returns
Raw transaction data in hexadecimal format, including sender, recipient, gas, data, and signature. Example: "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b...".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getRawTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xf86c018504a817c8008252089471c7656ed63d30e271b7db6f5cb94d10d5c2b7b3880de0b6b3a76400008025a0ba4681b..."
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getWork
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-get-work
Returns the hash of the current block, the seedHash, and the boundary condition to be met (“target”).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array returned by eth\_getWork. Contains \[powHash, seedHash, boundary, blockNumber].
32-byte current block header pow-hash.
32-byte current block header pow-hash.
32-byte seed hash used for the DAG.
32-byte boundary condition (target = 2^256 / difficulty).
Quantity - current block number (hex string).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getWork",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"0x5EED00000000000000000000000000005EED0000000000000000000000000000",
"0xd1ff1c01710000000000000000000000d1ff1c01710000000000000000000000",
"0x1"
]
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-hashrate
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-mining
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sendTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-send-transaction
Creates new message call transaction or a contract creation, if the data field contains code.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendTransaction: \[transactionObject]
Positional parameters for eth\_sendTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_sign
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-sign
The sign method calculates an Ethereum specific signature with: sign(keccak256("Ethereum Signed Message: " + len(message) + message))).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sign: \[address, data].
Positional parameters for eth\_sign:
params\[0]: The address.
params\[1]: Data which hash to sign.
### Returns
Data - Signed data. Example: "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a539310c6ecd1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sign",
"params": [
"0xcd2a3d9f938e13cd947ec05abc7fe734df8dd826",
"0x5363686f6f6c627573"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb1092cb5b23c2aa55e5b5787729c6be812509376de99a52bea2b41e5a5f8601c5641e74d01e4493c17bf1ef8b179c49362b2c721222128d58422a5..."
}
```
# eth_signTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-sign-transaction
Signs transactions without dispatching it to the network. It can be later submitted using eth_sendRawTransaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_signTransaction: \[transactionObject]
Positional parameters for eth\_signTransaction:
params\[]: Legacy transaction (pre-EIP-2718).
### Returns
Signed transaction and its details.
Data - The signed, RLP encoded transaction.
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_signTransaction",
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"raw": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
"tx": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
}
```
# eth_simulateV1
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-simulate-v1
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_simulateV1",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_submitHashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-submit-hashrate
Used for submitting mining hashrate.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_submitHashrate: \[hashrate, id].
Positional parameters for eth\_submitHashrate:
params\[0]: Data - a hexadecimal string representation (32 bytes) of the hash rate.
params\[1]: Data - A random hexadecimal(32 bytes) ID identifying the client.
### Returns
Boolean - Returns true if submitting hash rate was successful. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_submitHashrate",
"params": [
"0x0000000000000000000000000000000000000000000000000000000000500000",
"0x59daa26581d0acd1fce254fb7e85952f4c09d0915afd33d3886cd914bc7d283c"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_submitWork
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-submit-work
Used for submitting a proof-of-work solution.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_submitWork: \[nonce, powHash, mixHash].
Positional parameters for eth\_submitWork:
params\[0]: 8 Bytes - The nonce found (64 bits).
params\[1]: 32 Bytes - The header’s pow-hash (256 bits)
params\[2]: Data - 32 Bytes - The mix digest (256 bits).
### Returns
Boolean - returns true if the provided solution is valid, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_submitWork",
"params": [
"0x0000000000000001",
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"0xD1FE5700000000000000000000000000D1FE5700000000000000000000000000"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# Optimism Sepolia (ETH) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/optimism-sepolia-overview
Optimism Sepolia is an EVM-compatible testnet. It is a testnet for Optimism. Its ticker symbol is `ETH`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Optimism Sepolia
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ---------------- | ------ | ------- | ---------- |
| Optimism | `ETH` | Mainnet | `10` |
| Optimism Sepolia | `ETH` | Testnet | `11155420` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/11155420/debug/debug-db-ancient)
* [Erigon](/reference/jsonrpc/11155420/erigon/erigon-block-number)
* [EVM](/reference/jsonrpc/11155420/evm/eth-accounts)
* [Trace](/reference/jsonrpc/11155420/trace/trace-block)
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/trace/trace-block
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/trace/trace-call
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/trace/trace-call-many
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/trace/trace-filter
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/trace/trace-get
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/trace/trace-raw-transaction
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/trace/trace-replay-block-transactions
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155420/trace/trace-replay-transaction
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155420 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# debug_dbAncient
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/debug/debug-db-ancient
Returns the ancient (freezer) data item at the given index for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table, index].
Positional parameters for debug\_dbAncient:
params\[0]: Ancient table name (e.g., "headers", "bodies").
params\[1]: Zero-based index within the ancient table.
### Returns
Hex-encoded RLP payload stored at the requested slot.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncient",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/debug/debug-get-bad-blocks
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_getRawBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/debug/debug-get-raw-block
Retrieves and returns the RLP encoded block by number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawBlock: \[blockNrOrHash].
Positional parameters for debug\_getRawBlock:
params\[]: The block number or hash.
### Returns
The RLP encoded data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawBlock",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawHeader
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/debug/debug-get-raw-header
Returns an RLP-encoded header.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[blockNrOrHash].
Positional parameters for debug\_getRawHeader:
params\[]: The block number or hash.
### Returns
The RLP encoded header data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawHeader",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/debug/debug-get-raw-receipts
Returns the consensus-encoding of all receipts in a single block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawReceipts: \[blockNrOrHash].
Positional parameters for debug\_getRawReceipts:
params\[]: The block number or hash.
### Returns
The consensus-encoding of all receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawReceipts",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_storageRangeAt
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/debug/debug-storage-range-at
Returns the storage at the given block height and transaction index. The result can be paged by providing a maxResult to cap the number of storage slots returned as well as specifying the offset via keyStart (hash of storage key).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, txIdx, contractAddress, keyStart, maxResult]
Positional parameters for debug\_storageRangeAt:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Index of the transaction within the block.
params\[2]: 20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
params\[3]: Starting key (32-byte hex string) used for filtering storage or entries.
params\[4]: Maximum number of results to return.
### Returns
The array of storage items.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": [
"0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
0,
"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"0x0000000000000000000000000000000000000000000000000000000000000000",
1
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceCallMany
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/debug/debug-trace-call-many
Executes a list of bundles (a bundle is a collection of transactions), without creating transactions on the blockchain. Returns their traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for debug\_traceCallMany. 1. Bundles (required): an array of bundles. Each bundle is an object with: - transactions: an array of transaction objects (each with fields such as from, to, value, data), - blockOverride (optional): an object with overrides (blockNumber, blockHash mapping, coinbase, timestamp, difficulty, gasLimit, baseFee). 2. Simulation context (required): an object with blockIdentifier (a hex block number or one of "latest", "earliest", "pending", "safe", "finalized") and transactionIndex (integer, default -1). 3. State overrides (optional): an object mapping addresses to state override objects (here, at least a balance override as a hex string). 4. Timeout (optional): integer timeout in milliseconds (default 5000). 5. Trace type (optional): an object with tracer (string, enum: callTracer, prestateTracer), tracerConfig (object), and onlyTopCall (boolean).
Positional parameters for debug\_traceCallMany:
params\[0]: List of bundles. Each bundle is an object with transactions and an optional blockOverride.
params\[1]: Simulation context. Contains blockIdentifier (a hex block number or tag) and transactionIndex (default -1).
params\[2]: Optional state overrides: a mapping from address to an override object (e.g. balance).
### Returns
Array of trace responses corresponding to each simulated bundle. Each trace response is one of: callTracer response, prestateTracer response, or opcode (struct) response.
CallTracer response.
CallTracer response.
Type of the call.
Sender address.
Recipient address.
Gas provided by the sender.
Actual value deducted from the sender (per gas).
Total gas used by the call.
Input data (4-byte method selector).
Return value (hex).
Error message if execution failed.
List of sub-calls (nested call frames).
A nested call frame with additional details.
Revert reason, if available.
PrestateTracer response.
Smart contract address associated with the result.
Balance of the contract in wei (hex).
Bytecode of the contract (hex).
Nonce of the contract account.
Mapping of storage slots (hex keys and values).
Opcode (struct) trace response.
Indicates whether the execution failed.
Total consumed gas (hex).
Return value of the executed call (hex).
Array of execution step logs.
Program counter.
Operation name.
Available gas at this step.
Gas cost of the operation.
Call depth.
Stack values at this step.
Storage state at this step.
Refund amount (hex).
Error message, if any.
Memory snapshot at this step (array of hex strings).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCallMany",
"params": [
[],
{},
{},
5000,
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# erigon_getHeaderByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/erigon/erigon-get-header-by-number
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "erigon_getHeaderByNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_blobBaseFee
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-blob-base-fee
Returns the expected base fee for blobs in the next block, in wei (hexadecimal format).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The expected blob base fee for the next block (QUANTITY in wei, 64 bits). Example: "0x174876e800".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blobBaseFee",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x174876e800"
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getAccount
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-account
Retrieves detailed account information for a given address at a specific block number or tag.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, blockReference]
Positional parameters for eth\_getAccount:
params\[0]: The address of the account (20-byte hex string).
params\[1]: Block reference: block number in hex, integer, or tag ("latest", "pending", "safe", "finalized").
### Returns
Account information at the specified block.
32-byte hash of the account’s code.
Hash of the account’s storage trie.
Account balance in wei (hexadecimal).
Number of transactions sent from the account.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getAccount",
"params": [
"0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"codeHash": "0x3f30cbb24e7a53efc981dcf566da48e6e9b5418d26c4763fdb4e83e7bcd0c9c5",
"storageRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"balance": "0x38d7ea4c68000",
"nonce": "0x10"
}
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendPrivateTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-send-private-transaction
Sends a signed transaction to a private relay (like Flashbots Protect) for inclusion in a block without exposure to the public mempool. Provides frontrunning and revert protection.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transactionPayload]
Positional parameters for eth\_sendPrivateTransaction:
params\[]: Payload object containing raw transaction and optional execution constraints.
### Returns
Returns true if the transaction was successfully accepted, false otherwise. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendPrivateTransaction",
"params": [
{
"tx": "0xf86c808504a817c80082520894a0df350d2637096571f7a701cb5b1660d90cecb380b844a9059cbb000000000000000000000000b60e8dd61c5d32be8058bb8eb970870f07233155",
"maxBlockNumber": "0x10fb80",
"preferences": {
"fast": true
}
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_simulateV1
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-simulate-v1
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The JSON-RPC result.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_simulateV1",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
# eth_submitWork
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-submit-work
Used for submitting a proof-of-work solution.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_submitWork: \[nonce, powHash, mixHash].
Positional parameters for eth\_submitWork:
params\[0]: 8 Bytes - The nonce found (64 bits).
params\[1]: 32 Bytes - The header’s pow-hash (256 bits)
params\[2]: Data - 32 Bytes - The mix digest (256 bits).
### Returns
Boolean - returns true if the provided solution is valid, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_submitWork",
"params": [
"0x0000000000000001",
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"0xD1FE5700000000000000000000000000D1FE5700000000000000000000000000"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# Rise Testnet (RISE) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/rise-testnet-overview
Rise Testnet is an EVM-compatible testnet. It is a testnet for Rise. Its ticker symbol is `RISE`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Rise Testnet
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ------------ | ------ | ------- | ---------- |
| Rise | `RISE` | Mainnet | `4153` |
| Rise Testnet | `RISE` | Testnet | `11155931` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/11155931/debug/debug-db-ancient)
* [Erigon](/reference/jsonrpc/11155931/erigon/erigon-get-header-by-number)
* [EVM](/reference/jsonrpc/11155931/evm/eth-accounts)
* [Trace](/reference/jsonrpc/11155931/trace/trace-block)
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/trace/trace-block
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/trace/trace-call
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/trace/trace-call-many
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/trace/trace-filter
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/trace/trace-get
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/trace/trace-raw-transaction
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/trace/trace-replay-block-transactions
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11155931/trace/trace-replay-transaction
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11155931 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# Core (CORE) Overview
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/core-overview
Core is an EVM-compatible mainnet. Its ticker symbol is `CORE`. Use Uniblock's JSON-RPC endpoint to read chain state, send transactions, and interact with smart contracts through a single API surface across providers.
## Connect to Core
Send JSON-RPC requests with `POST` to:
`https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116`
Include the JSON-RPC method and parameters in the request body.
### Example request
Make a simple `eth_blockNumber` request with cURL:
```bash theme={null}
curl --request POST 'https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
| Network | Symbol | Type | Chain ID |
| ------------ | -------- | ------- | -------- |
| Core | `CORE` | Mainnet | `1116` |
| Core Testnet | `tCORE2` | Testnet | `1114` |
## API reference
Browse the available method groups for this chain:
* [Debug](/reference/jsonrpc/1116/debug/debug-chaindb-property)
* [EVM](/reference/jsonrpc/1116/evm/eth-accounts)
* [Trace](/reference/jsonrpc/1116/trace/trace-block)
# debug_chaindbProperty
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-chaindb-property
Returns diagnostic information about the chain database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[property].
Positional parameters for debug\_chaindbProperty:
params\[]: Name of the database property to query (e.g., "leveldb.stats").
### Returns
Property value returned by the key-value store.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_chaindbProperty",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncient
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-db-ancient
Returns the ancient (freezer) data item at the given index for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table, index].
Positional parameters for debug\_dbAncient:
params\[0]: Ancient table name (e.g., "headers", "bodies").
params\[1]: Zero-based index within the ancient table.
### Returns
Hex-encoded RLP payload stored at the requested slot.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncient",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_dbAncients
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-db-ancients
Returns the number of ancient entries stored for the specified table.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[table].
Positional parameters for debug\_dbAncients:
params\[]: Ancient table name.
### Returns
Count of stored ancient items. Example: 1024.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_dbAncients",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": 1024
}
```
# debug_gcStats
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-gc-stats
Returns garbage collection statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Garbage collection stats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_gcStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getAccessibleState
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-get-accessible-state
Returns the oldest block whose state is still retained locally.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Hex block number representing the earliest accessible state. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getAccessibleState",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-get-bad-blocks
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_getModifiedAccountsByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-get-modified-accounts-by-hash
Returns the addresses of accounts modified by the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash].
Positional parameters for debug\_getModifiedAccountsByHash:
params\[]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Modified account addresses.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getModifiedAccountsByHash",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_getRawBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-get-raw-block
Retrieves and returns the RLP encoded block by number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawBlock: \[blockNrOrHash].
Positional parameters for debug\_getRawBlock:
params\[]: The block number or hash.
### Returns
The RLP encoded data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawBlock",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawHeader
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-get-raw-header
Returns an RLP-encoded header.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawHeader: \[blockNrOrHash].
Positional parameters for debug\_getRawHeader:
params\[]: The block number or hash.
### Returns
The RLP encoded header data.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawHeader",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_getRawReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-get-raw-receipts
Returns the consensus-encoding of all receipts in a single block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_getRawReceipts: \[blockNrOrHash].
Positional parameters for debug\_getRawReceipts:
params\[]: The block number or hash.
### Returns
The consensus-encoding of all receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getRawReceipts",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_getTrieFlushInterval
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-get-trie-flush-interval
Retrieves the current value of in-memory trie flush interval.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current value of in-memory trie flush interval.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getTrieFlushInterval",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": ""
}
```
# debug_goTrace
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-go-trace
Starts a Go execution trace and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_goTrace:
params\[0]: Destination file for the execution trace.
params\[1]: Duration to trace in seconds.
### Returns
True if tracing completed successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_goTrace",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_intermediateRoots
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-intermediate-roots
Returns the intermediate state trie roots for each transaction in the given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier].
Positional parameters for debug\_intermediateRoots:
params\[]: Block number or hash in hex.
### Returns
State root hashes after each transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_intermediateRoots",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_memStats
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-mem-stats
Returns current runtime memory statistics.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Statistics mirroring Go runtime.MemStats.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_memStats",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_mutexProfile
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-mutex-profile
Captures mutex contention profile information and writes it to the specified file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, seconds].
Positional parameters for debug\_mutexProfile:
params\[0]: Destination file for the mutex profile.
params\[1]: Duration to capture in seconds.
### Returns
True if the mutex profile was written successfully. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_mutexProfile",
"params": [
"",
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_printBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-print-block
Pretty-prints the specified block for human inspection.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockIdentifier].
Positional parameters for debug\_printBlock:
params\[]: Block number or hash.
### Returns
True if the block information was written to the log output. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_printBlock",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_stacks
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-stacks
Collects and writes all goroutine stack traces to the given file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath].
Positional parameters for debug\_stacks:
params\[]: Destination file path.
### Returns
True if stack traces were written. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_stacks",
"params": [
""
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# debug_traceBadBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-trace-bad-block
Executes the transactions in a bad block and returns the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, options?].
Positional parameters for debug\_traceBadBlock:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBadBlock",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockFromFile
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-trace-block-from-file
Traces all transactions contained within an RLP-encoded block file.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[filePath, options?].
Positional parameters for debug\_traceBlockFromFile:
params\[0]: Path to the block file.
params\[1]: Optional tracer configuration.
### Returns
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockFromFile",
"params": [
"",
{}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{
"key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"value": "0x0",
"proof": [
"..."
]
}
]
}
}
```
# eth_getStorageAt
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-storage-at
Returns the value from a storage position at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getStorageAt: \[address, position, defaultBlock].
Positional parameters for eth\_getStorageAt:
params\[0]: The address.
params\[1]: Integer of the position in the storage.
params\[2]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The value at this storage position. Example: "0x0".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"0x0",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
```
# eth_getTransactionByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-transaction-by-block-hash-and-index
Returns information about a transaction by block hash and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getTransactionByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the transaction index position.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-transaction-by-block-number-and-index
Returns information about a transaction by block number and transaction index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByBlockNumberAndIndex: \[blockNumber, index].
Positional parameters for eth\_getTransactionByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the transaction index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"0x29c",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getTransactionByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-transaction-by-hash
Returns the information about a transaction requested by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionByHash:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Transaction response object. Can be a legacy transaction (pre-EIP-2718) or an AccessList transaction (EIP-2930).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
AccessList transaction (EIP-2930). Extends LegacyTransaction but omits standardV.
Transaction type (EIP-2930). Fixed value "0x1" for accessList transactions.
List of objects specifying the address (20 Bytes) and storageKeys (32 Byte items) that will be accessed.
20 Bytes address
List of storage keys, each 32 Bytes in length.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"nonce": "0x0",
"blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
"blockNumber": "0x15df",
"transactionIndex": "0x1",
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
"value": "0x7f110",
"__truncated": true
}
}
```
# eth_getTransactionCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-transaction-count
Returns the number of transactions sent from an address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionCount: \[address, defaultBlock].
Positional parameters for eth\_getTransactionCount:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of transactions sent from this address. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getTransactionReceipt
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-transaction-receipt
Returns the receipt of a transaction by transaction hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getTransactionByHash: \[transactionHash].
Positional parameters for eth\_getTransactionReceipt:
params\[0]: 32 Bytes - Hash of the transaction.
### Returns
Receipt object returned after transaction execution. Can be a legacy receipt (pre-EIP-2718) or AccessList receipt (EIP-2930).
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
The total amount of gas used when this transaction was executed in the block.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
The amount of gas used by this specific transaction alone.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
256 Bytes - Bloom filter for logs/events generated during transaction execution.
32 Bytes - Merkle root of the state trie after the transaction (optional after Byzantium).
0x0 indicates failure, 0x1 indicates success. Set for blocks after Byzantium, null before.
32 Bytes - Hash of the transaction.
The transaction's index position in the block. Null when pending.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
Legacy transaction receipt (pre-EIP-2718). Includes basic execution result and log data.
AccessList receipt (EIP-2930). Extends legacy receipt and adds `type: 0x1`.
Receipt type. Fixed to "0x1" for EIP-2930 access list receipts.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
"blockNumber": "0x6914b0",
"contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf",
"from": "0xc931d93e97ab07fe42d923478ba2465f2",
"to": null,
"cumulativeGasUsed": "0x158e33",
"gasUsed": "0xba2e6",
"logs": [],
"__truncated": true
}
}
```
# eth_getUncleByBlockHashAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-uncle-by-block-hash-and-index
Returns information about a uncle of a block by hash and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockHashAndIndex: \[blockHash, index].
Positional parameters for eth\_getUncleByBlockHashAndIndex:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
"0x0"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleByBlockNumberAndIndex
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-uncle-by-block-number-and-index
Returns information about a uncle of a block by number and uncle index position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleByBlockNumberAndIndex: \[defaultBlock, index].
Positional parameters for eth\_getUncleByBlockNumberAndIndex:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Integer of the uncle’s index position.
### Returns
Ethereum block object. Null when no block was found.
Ethereum block object. Null when no block was found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8-byte proof-of-work nonce. Null when pending or in PoA networks.
SHA3 of the uncles data.
Bloom filter for logs in the block. Null when pending.
Root of the transaction trie.
Root of the final state trie.
Root of the receipts trie.
Address of the block author (beneficiary).
Alias of `author`. Address of the miner.
Block difficulty.
Total difficulty of the chain up to this block.
Extra data field of the block.
Size of the block in bytes.
Maximum gas allowed in the block.
Total gas used by all transactions.
Unix timestamp for when the block was collated.
Array of either 32-byte transaction hashes or full transaction objects, depending on the request.
Transaction hash.
Transaction hash.
Full transaction object.
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
0,
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sealFields": [
"0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
"0x0000000000000042"
],
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"__truncated": true
}
}
```
# eth_getUncleCountByBlockHash
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-uncle-count-by-block-hash
Returns the number of uncles in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockHash: \[blockHash].
Positional parameters for eth\_getUncleCountByBlockHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getUncleCountByBlockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-get-uncle-count-by-block-number
Returns the number of uncles in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getUncleCountByBlockNumber: \[defaultBlock].
Positional parameters for eth\_getUncleCountByBlockNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The number of uncles in the block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_hashrate
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-hashrate
Returns the number of hashes per second that the node is mining with.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity- The number of hashes per second. Example: "0x38a".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_hashrate",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x38a"
}
```
# eth_maxPriorityFeePerGas
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-max-priority-fee-per-gas
Returns the current recommended maximum priority fee per gas (tip), in hexadecimal wei. Useful for EIP-1559 transaction fee estimations.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not accept any parameters.
### Returns
The current priority fee (tip) in wei, represented as a hexadecimal string. Example: "0x59682f00".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": [
null
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x59682f00"
}
```
# eth_mining
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-mining
Returns true if client is actively mining new blocks.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True if the client is mining, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_mining",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_newBlockFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-new-block-filter
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newBlockFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-new-filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.
Positional parameters for eth\_newFilter:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0x1",
"toBlock": "0x2",
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
]
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_newPendingTransactionFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-new-pending-transaction-filter
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - The filter ID. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_newPendingTransactionFilter",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_protocolVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-protocol-version
Returns the current ethereum protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The current ethereum protocol version. Example: "0x40".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x40"
}
```
# eth_sendRawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-send-raw-transaction
Creates new message call transaction or a contract creation for signed transactions. Note: eth_submitTransaction is an alias of this method.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_sendRawTransaction: \[signedTransactionData].
Positional parameters for eth\_sendRawTransaction:
params\[0]: The signed transaction data.
### Returns
32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Example: "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
}
```
# eth_subscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-subscribe
Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_subscribe: \[subscriptionType, options]. The second parameter is required only for "logs".
Positional parameters for eth\_subscribe:
params\[0]: Subscription type. Must be either "newHeads" or "logs".
params\[1]: Filter options for "logs" subscription, or empty object for "newHeads".
### Returns
Assigned subscription ID Example: "0xb53c4832f1dca4a5".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_subscribe",
"params": [
"logs",
{
"fromBlock": "latest",
"toBlock": "latest"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xb53c4832f1dca4a5"
}
```
# eth_syncing
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-syncing
Returns an object with data about the sync status or false.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Returns syncing status. Either a sync status object if syncing, or `false` if not syncing.
Sync status object returned while node is syncing.
The block number at which syncing started (hex string quantity).
The current block number (hex quantity).
Estimated highest known block (hex quantity).
Array representing missing block range: \[first, last).
Total number of snapshot chunks to be processed.
Total number of snapshot chunks already processed.
Returned when the node is not syncing.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
```
# eth_uninstallFilter
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-uninstall-filter
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_uninstallFilter: \[filterID].
Positional parameters for eth\_uninstallFilter:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Boolean - true if the filter was successfully uninstalled, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_uninstallFilter",
"params": [
"0x1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# eth_unsubscribe
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/eth-unsubscribe
Unsubscribes from a subscription.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_unsubscribe: \[subscriptionId].
Positional parameters for eth\_unsubscribe:
params\[0]: Subscription Id
### Returns
Whether the call was successful or not. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_unsubscribe",
"params": [
"0xb53c4832f1dca4a5"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_listening
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/net-listening
Returns true if client is actively listening for network connections.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Boolean - True when listening, otherwise false. Example: true.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_listening",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
# net_peerCount
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/net-peer-count
Returns number of peers currenly connected to the client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Quantity - Integer of the number of connected peers Example: "0x2".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_peerCount",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x2"
}
```
# net_version
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/net-version
Returns the current network protocol version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current network protocol version Example: "8995".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "net_version",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "8995"
}
```
# txpool_content
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/txpool-content
Returns detailed information about all pending and queued transactions currently in the transaction pool. Only supported on Geth clients.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Transaction pool content separated by pending and queued states.
Mapping of sender addresses to nonce-indexed pending transactions.
Mapping of sender addresses to nonce-indexed queued transactions.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "txpool_content",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# web3_clientVersion
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/web3-client-version
Returns the current client version.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
String - The current client version Example: "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86\_64-unknown-linux-gnu/rustc1.43.1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "OpenEthereum//v3.0.1-stable-8ca8089-20200601/x86_64-unknown-linux-gnu/rustc1.43.1"
}
```
# web3_sha3
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/evm/web3-sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method web3\_sha3: \[data].
Positional parameters for web3\_sha3:
params\[]: String - The data to convert into a SHA3 hash.
### Returns
Data - The Keccak-256 hash of the given string. Example: "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": [
"0x68656c6c6f20776f726c64"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
# trace_block
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/trace/trace-block
Returns traces created at given block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for trace\_block method: \[defaultBlock]
Positional parameters for trace\_block:
params\[0]: Integer block number.
params\[1]: Block tag: "earliest", "latest", or "pending".
### Returns
Array - Block traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_block",
"params": [
"0x2ed119"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951",
"gas": "0x0",
"input": "0x",
"to": "0xd40aba8166a212d6892125f079c33e6f5ca19814",
"value": "0x4768d7effc3fbe"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6",
"transactionPosition": 0,
"__truncated": true
}
]
}
```
# trace_call
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/trace/trace-call
Executes a new message call and returns a number of possible traces (Trace Mode required, and supported only on OpenEthereum & Erigon).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
### Returns
An array of block traces returned by the trace method.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_call",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# trace_callMany
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/trace/trace-call-many
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first. Allows to trace dependent transactions.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace call method: \[traceCalls, block identifier]. The first element is an array of trace calls; the second is an optional block identifier.
Positional parameters for trace\_callMany:
params\[0]: List of trace calls. Each trace call is an array of two items: a transaction object and an array of trace types.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Array - Array of the given transactions’ traces
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_callMany",
"params": [
[],
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
},
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"vmTrace": null
}
]
}
```
# trace_filter
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/trace/trace-filter
Returns traces matching given filter.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_filter: \[filterObject]
Positional parameters for trace\_filter:
params\[]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array - Traces matching given filter
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_filter",
"params": [
{
"fromBlock": "0x2ed0c4",
"toBlock": "0x2ed128",
"toAddress": [
"0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
],
"after": 1000,
"count": 100
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
"gas": "0x4c40d",
"input": "0x",
"to": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
"value": "0x3f0650ec47fd240000"
},
"blockHash": "0x86df301bcdd8248d982dbf039f09faf792684e1aeee99d5b58b77d620008b80f",
"blockNumber": 3068183,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [],
"transactionHash": "0x3321a7708b1083130bd78da0d62ead9f6683033231617c9d268e2c7e3fa6c104",
"transactionPosition": 3,
"__truncated": true
}
]
}
```
# trace_get
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/trace/trace-get
Returns trace at given position.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_get: \[transactionHash, index].
Positional parameters for trace\_get:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Array - Index positions of the traces.
### Returns
Object - Trace object
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_get",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
[
"0x0"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
}
```
# trace_rawTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/trace/trace-raw-transaction
Traces a call to eth_sendRawTransaction without making the call, returning the traces
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_rawTransaction method: \[transactionData, traceType].
Positional parameters for trace\_rawTransaction:
params\[0]: Data - Raw transaction data.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Object - Block traces.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_rawTransaction",
"params": [
"",
[]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"output": "0x",
"stateDiff": null,
"trace": [
{
"action": {
"__truncated": true
},
"result": {
"__truncated": true
},
"subtraces": 0,
"traceAddress": [
"..."
],
"type": "call"
}
],
"vmTrace": null
}
}
```
# trace_replayBlockTransactions
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/trace/trace-replay-block-transactions
Replays all transactions in a block returning the requested traces for each transaction.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for the trace\_replayBlockTransactions method: \[defaultBlock, traceTypes].
Positional parameters for trace\_replayBlockTransactions:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Block transactions traces.
Single block-level trace result.
Details of the action performed (e.g., call, create, suicide).
Type of call (e.g., call, delegatecall, staticcall, etc.).
Address that initiated the action.
Recipient address (if applicable).
Input data sent along with the call.
Value transferred in Wei.
Contract creation code (only for create).
Contract address created or affected.
Balance involved in suicide actions.
Result of the action (if successful).
Gas used for this action.
Returned data (if any).
Deployed contract code (if applicable).
Address created (for contract creations).
Number of nested trace steps inside this one.
Path to this trace in nested trace structure.
Type of trace (e.g., call, create, suicide).
Error message if the trace step failed.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_replayBlockTransactions",
"params": [
"0x2ed119",
[
"trace"
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"output": "0x",
"stateDiff": null,
"trace": [
{
"__truncated": true
}
],
"transactionHash": "0x...",
"vmTrace": null
}
]
}
```
# trace_replayTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/1116/trace/trace-replay-transaction
Replays a transaction, returning the traces.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method trace\_replayTransaction: \[hash, traceTypes].
Positional parameters for trace\_replayTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Types of traces to collect: "vmTrace", "trace", and/or "stateDiff".
### Returns
Array - Traces of given transaction
Traces matching given filter.
Details of the trace action.
Type of call (e.g., "call", "delegatecall", etc.).
Address that initiated the action.
Gas provided for the action (hex string).
Input data for the action (hex string).
Recipient address (if applicable).
Value transferred in Wei (hex string).
Hash of the block in which this trace occurred.
Block number in which this trace occurred.
Result of the trace action.
Gas used during this action (hex string).
Returned output data (hex string).
Number of nested trace steps inside this trace.
Path to this trace in the nested trace structure.
Hash of the transaction this trace belongs to.
Index position of the transaction within the block.
Type of trace (e.g., "call", "create", "suicide").
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1116 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "trace_transaction",
"params": [
"0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [
0
],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"__truncated": true
}
]
}
```
# debug_getBadBlocks
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/debug/debug-get-bad-blocks
Returns a list of the last “bad blocks” that the client has seen on the network.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Array - List of “bad blocks” seen on the network.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_getBadBlocks",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"author": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x0",
"gasUsed": "0x0",
"hash": "0x27bfb37e507ce90da141307204b1c6ba24194380613590ac50ca4b1d7198ff65",
"logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...",
"miner": "0x0000000000000000000000000000000000000000",
"__truncated": true
}
]
}
```
# debug_storageRangeAt
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/debug/debug-storage-range-at
Returns the storage at the given block height and transaction index. The result can be paged by providing a maxResult to cap the number of storage slots returned as well as specifying the offset via keyStart (hash of storage key).
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockHash, txIdx, contractAddress, keyStart, maxResult]
Positional parameters for debug\_storageRangeAt:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Index of the transaction within the block.
params\[2]: 20 Bytes - The contract address created, if the transaction was a contract creation. Null otherwise.
params\[3]: Starting key (32-byte hex string) used for filtering storage or entries.
params\[4]: Maximum number of results to return.
### Returns
The array of storage items.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": [
"0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
0,
"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"0x0000000000000000000000000000000000000000000000000000000000000000",
1
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# debug_traceBlock
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/debug/debug-trace-block
The traceBlock method will return a full stack trace of all invoked opcodes of all transaction that were included in this block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
The parameters for method debug\_traceBlock: \[blockRlp, traceConfig].
Positional parameters for debug\_traceBlock:
params\[0]: The RLP encoded block.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlock",
"params": [
"RLP_ENCODED_BLOCK",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/debug/debug-trace-block-by-hash
Similar to debug_traceBlock, traceBlockByHash accepts a block hash and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByHash: \[blockHash, traceConfig]
Positional parameters for debug\_traceBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/debug/debug-trace-block-by-number
Similar to debug_traceBlock, traceBlockByHashByNumber accepts a block number and will replay the block that is already present in the database.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceBlockByNumber: \[blockNumber, traceConfig]
Positional parameters for debug\_traceBlockByNumber:
params\[0]: Block number where this transaction was included. Null when pending.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
Full stack trace.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"0xccde12",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"txHash": "0xabba...",
"result": {
"gas": 85301,
"returnValue": "",
"structLogs": [
"..."
]
}
},
{
"txHash": "0xacca...",
"result": {}
}
]
}
```
# debug_traceCall
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/debug/debug-trace-call
The debug_traceCall method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The first argument (just as in eth_call) is a transaction object. The block can be specified either by hash or by number as the second argument.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceCall: \[transactionObject, blockNrOrHash, traceConfig].
Positional parameters for debug\_traceCall:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: The block number or hash.
params\[2]: Optional configuration object passed to tracing RPC methods.
### Returns
The tracer object.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
},
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# debug_traceTransaction
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/debug/debug-trace-transaction
The traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for method debug\_traceTransaction: \[txHash, traceConfig].
Positional parameters for debug\_traceTransaction:
params\[0]: 32 Bytes - Hash of the transaction.
params\[1]: Optional configuration object passed to tracing RPC methods.
### Returns
The ExecutionResult of the transaction.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
{
"tracer": "callTracer"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {}
}
```
# eth_accounts
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-accounts
Returns a list of addresses owned by client.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - addresses owned by the client.
The address.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
```
# eth_blockNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-block-number
Returns the number of most recent block.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The block number as a hex string. Example: "0x4b7".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b7"
}
```
# eth_call
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-call
Executes a new message call immediately without creating a transaction on the block chain.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_call:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The return value of the executed contract. Example: "0x".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"value": "0x186a0"
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
```
# eth_chainId
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-chain-id
Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
The EIP155 Chain ID, or null if not available. Example: "0x1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
```
# eth_coinbase
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-coinbase
Returns the client coinbase address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
20 Bytes - the current coinbase address. Example: "0x407d73d8a49eeb85d32cf465507dd71d507100c1".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_coinbase",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
# eth_createAccessList
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-create-access-list
Creates an EIP-2930 access list that specifies which addresses and storage keys a transaction will access, helping optimize gas usage and reduce out-of-gas errors.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[transaction call object, block identifier]
Positional parameters for eth\_createAccessList:
params\[0]: Transaction call object used to simulate the access list.
params\[1]: Block identifier: number, block hash, or tag ("latest", "earliest", "pending", "safe", or "finalized").
### Returns
Access list and estimated gas usage.
List of addresses and storage keys accessed.
Hex-encoded address accessed.
List of accessed storage keys.
Estimated gas usage with the generated access list (hex).
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_createAccessList",
"params": [
{
"from": "0xaeA8F8f781326bfE6A7683C2BD48Dd6AA4d3Ba63",
"to": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"data": "0x608060806080608155"
},
"pending"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"accessList": [
{
"address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
"storageKeys": [
"..."
]
}
],
"gasUsed": "0x125f8"
}
}
```
# eth_estimateGas
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-estimate-gas
Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Two-element array: \[modified transaction object, default block]. The transaction omits "nonce" and allows optional "from".
Positional parameters for eth\_estimateGas:
params\[0]: Legacy transaction (pre-EIP-2718).
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The amount of gas used. Example: "0x5208".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{},
0
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
```
# eth_feeHistory
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-fee-history
Returns historical gas fee data over a range of blocks, including base fees, blob gas metrics (EIP-4844), and priority fee percentiles.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockCount, newestBlock, rewardPercentiles]
Positional parameters for eth\_feeHistory:
params\[0]: Hex-encoded number of blocks in the requested range (max: 0x400 / 1024 blocks).
params\[1]: Newest block identifier: a hex block number or one of: "latest", "earliest", "pending".
params\[2]: Optional array of integers representing percentiles (ascending).
### Returns
Historical gas fee statistics over the requested range of blocks.
The lowest block number in the returned range (hex).
Base fee per gas for each block in the range, plus one for the next block.
Base fee per blob gas (EIP-4844). Zeroes for pre-4844 blocks.
Ratio of gas used to gas limit for each block.
Ratio of blob gas used to max blob gas per block (EIP-4844).
Effective priority fees per gas for specified percentiles across each block.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x5",
"latest",
[
20,
30
]
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"oldestBlock": "0x14535f8",
"baseFeePerGas": [
"0x279c70a9b",
"0x2a63ee068",
"0x2a01a5449",
"0x299fc09af",
"..."
],
"baseFeePerBlobGas": [
"0xe3f5193b",
"0xf6942037",
"0xdb2e5553",
"0xc2d3d9e8",
"..."
],
"gasUsedRatio": [
0.7806543666666667,
0.46377263333333335,
0.46358696666666666,
0.503863,
"..."
],
"blobGasUsedRatio": [
0.8333333333333334,
0,
0,
1,
"..."
],
"reward": [
[
"0x5f5e100",
"0x34142698"
],
[
"0x5f5e100",
"0x1f619e76"
],
[
"0x5f5e100",
"0x39d10680"
],
[
"0x6824280",
"0x214c9a15"
],
"..."
]
}
}
```
# eth_gasPrice
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-gas-price
Returns the current price per gas in wei.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
This method does not require any parameters.
### Returns
Integer of the current gas price in wei. Example: "0x09184e72a000".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x09184e72a000"
}
```
# eth_getBalance
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-get-balance
Returns the balance of the account of given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBalance: \[address, defaultBlock].
Positional parameters for eth\_getBalance:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The balance of the account at the given block. Example: "0x0234c8a3397aab58".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0234c8a3397aab58"
}
```
# eth_getBlockByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-get-block-by-hash
Returns information about a block by hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByHash: \[blockHash, fullTransactions].
Positional parameters for eth\_getBlockByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-get-block-by-number
Returns information about a block by block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockByNumber: \[blockNumber, fullTransactions].
Positional parameters for eth\_getBlockByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
params\[1]: If true, returns the full transaction objects. If false, returns only the transaction hashes.
### Returns
A block object returned by Ethereum RPC. Null if no block is found.
The block number. Null when pending.
Hash of the block. Null when pending.
Hash of the parent block.
8 Bytes - Proof-of-work nonce. Null when pending. Missing in Proof-of-Authority (PoA) networks.
SHA3 of the uncles data in the block.
The bloom filter for the logs of the block. Null when pending.
Root of the transaction trie of the block.
Root of the final state trie of the block.
Root of the receipts trie of the block.
Address of the author (beneficiary) of the block.
Alias of "author".
Difficulty for this block.
Total difficulty of the chain until this block.
Extra data field of this block.
Size of the block in bytes.
Maximum gas allowed in this block.
Total used gas by all transactions in this block.
Unix timestamp for when the block was collated.
Array of either full transaction objects or transaction hashes (32-byte strings).
Legacy transaction (pre-EIP-2718).
Legacy transaction (pre-EIP-2718).
32 Bytes - hash of the transaction.
Quantity - (optional) Integer of a nonce. This allows you to overwrite your own pending transactions that use the same nonce.
32 Bytes - hash of the block where this transaction was included. Null when pending.
Block number where this transaction was included. Null when pending.
The transaction's index position in the block. Null when pending.
20 Bytes - The address the transaction is sent from.
20 Bytes - The address the transaction is directed to. (Optional when creating new contract)
Quantity - (optional) Integer of the value sent with this transaction.
Quantity - (optional) Integer of the gas price used for each paid gas.
Quantity - (optional) Integer of the gas provided for the transaction execution. (eth\_call consumes zero gas)
The data sent along with the transaction.
The standardised V field of the signature.
The standardised V field of the signature (0 or 1). Only applicable to legacy transactions.
The R field of the signature.
Raw transaction data.
Public key of the signer.
The chain id of the transaction, if any.
Creates contract hash.
Conditional submission of the transaction. Can be an object with a block number (\{ block: 1 }), a UTC timestamp in seconds (\{ time: 1491290692 }), or null.
Block number condition
UTC timestamp condition in seconds
Array of uncle block hashes.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"0x1b4",
true
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"number": "0x1b4",
"hash": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom": "0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
"miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
"__truncated": true
}
}
```
# eth_getBlockReceipts
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-get-block-receipts
Returns all transaction receipts for a given block, including gas usage, status, and any event logs emitted by smart contracts.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[blockNumber]
Positional parameters for eth\_getBlockReceipts:
params\[]: Block identifier (hex block number or one of the tags: "latest", "earliest", "pending", "finalized", "safe").
### Returns
List of transaction receipt objects for the specified block.
Hash of the block.
Block number (hex).
Contract address created, if any.
Total gas used when this transaction was executed in the block.
Sender address.
Gas used by this specific transaction.
Effective gas price (wei).
Logs generated by this transaction.
Address that generated the log.
Indexed log arguments.
Non-indexed log data.
True if the log was removed due to chain reorg.
Bloom filter for logs.
Transaction execution status: 0x1 (success), 0x0 (failure).
Recipient address.
Hash of the transaction.
Index of the transaction in the block.
Transaction type.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": []
}
```
# eth_getBlockTransactionCountByHash
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-get-block-transaction-count-by-hash
Returns the number of transactions in a block from a block matching the given block hash.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByHash: \[blockHash].
Positional parameters for eth\_getBlockTransactionCountByHash:
params\[0]: 32 Bytes - hash of the block where this transaction was included. Null when pending.
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0xbfb3bb785c60ee4f93aa6e506f6f5d5fc5173301f537d856cac59d91e7a0ce09"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getBlockTransactionCountByNumber
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-get-block-transaction-count-by-number
Returns the number of transactions in a block from a block matching the given block number.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getBlockTransactionCountByNumber: \[blockNumber].
Positional parameters for eth\_getBlockTransactionCountByNumber:
params\[0]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
Integer of the number of transactions in this block. Example: "0x1b".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"0x1b4"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1b"
}
```
# eth_getCode
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-get-code
Returns code at a given address.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getCode: \[address, defaultBlock].
Positional parameters for eth\_getCode:
params\[0]: The address.
params\[1]: Block identifier. Can be an integer block number or a string tag: "latest", "earliest", or "pending".
### Returns
The code from the given address. Example: "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056".
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x2"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f35b600060078202905091905056"
}
```
# eth_getFilterChanges
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-get-filter-changes
Polling method for a filter, which returns an array of logs which occurred since last poll.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterChanges:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterChanges",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getFilterLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-get-filter-logs
Returns an array of all logs matching filter with given id.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getFilterChanges: \[filterId].
Positional parameters for eth\_getFilterLogs:
params\[0]: The filter ID as a hex quantity (e.g., "0x16" for 22).
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getFilterLogs",
"params": [
"0x16"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getLogs
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-get-logs
Returns an array of all logs matching a given filter object.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters for eth\_getLogs: \[filterObject].
Positional parameters for eth\_getLogs:
params\[0]: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.
### Returns
Array of log objects, or an empty array if nothing has changed since last poll.
Array of log objects generated by this transaction. Each log contains indexed topics and data.
Address from which this log originated.
Indexed log topics.
Data portion of the log.
Indicates whether this log was removed due to a chain reorg.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"topics": [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"
]
}
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"logIndex": "0x1",
"blockNumber": "0x1b4",
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0",
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": [
"0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
]
}
]
}
```
# eth_getProof
Source: https://docs.uniblock.dev/reference/jsonrpc/11235/evm/eth-get-proof
Returns the account and storage values for a given address along with the Merkle proof needed to verify the data against the state root.
### Parameters
Unique identifier for a blockchain network.
Request identifier used to match responses.
JSON-RPC version.
JSON-RPC method name.
Parameters: \[address, storageKeys, blockParameter]
Positional parameters for eth\_getProof:
params\[0]: The 20-byte address to check for balance, nonce, and storage.
params\[1]: Array of 32-byte storage keys (hex) to be included in the proof.
params\[2]: Block number or tag ("latest", "earliest", "pending", "safe", "finalized").
### Returns
Account details and Merkle proofs for storage verification.
The address of the account.
Hex-encoded balance of the account in wei.
Transaction count (nonce) of the account.
32-byte hash of the code of the account.
SHA3 hash of the storage root.
Array of RLP-encoded nodes forming the Merkle proof for the account.
Array of storage entries with their Merkle proofs.
Storage key queried.
Hex-encoded value stored at the key.
RLP-encoded Merkle proof nodes for this storage key.
```bash Curl theme={null}
curl --request POST \
--url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11235 \
--header 'content-type: application/json' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
[
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
],
"latest"
]
}'
```
```json Success theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
"balance": "0x0",
"nonce": "0x0",
"codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"accountProof": [
"0xf90211a0...",
"0xf90151a0..."
],
"storageProof": [
{