# Rarebl API Documentation > The Rarebl Open API (v1 and v2) gives blockchain data and tools for Bitcoin, Litecoin, Bitcoin Cash, Dash, Ethereum and TRON from Rarebl's own nodes: 42 HTTP endpoints at https://api.rarebl.com/open// (reads are GET, v2 writes are POST with a JSON body), a WebSocket stream, webhooks, market prices and signing SDKs. No API keys. ## Basics - **Base URL:** `https://api.rarebl.com/open` - **Chains (`chain` parameter):** btc, ltc, bch, dash, eth, tron - **Authentication:** none; `X-API-KEY` is reserved and ignored - **Rate limits (per IP, by class):** read 5/s burst 20; compute 2/s burst 10; write 6/min burst 3 and 300/day; watch 30/min; hooks 10/min; stream 3 connections; HTTP 429 with Retry-After - **Sending:** sign locally with an SDK (recommended), sign the digests yourself, or hosted signing (sends a key to Rarebl; needs the header X-Rarebl-Accept-Risk: hosted-signing) - **Envelope:** `{status, code, message, data, go, meta:{requestid, notices}}` (quote `meta.requestid`, or the `X-Request-Id` header, to support); codes API200, API400, API403, API404, API405, API409, API422, API429, API502, API500 - **Postman:** https://docs.rarebl.com/collections/rarebl-api.postman_collection.json ## Full context - [Full Rarebl API documentation](https://docs.rarebl.com/llms-full.txt) - [AI documentation index](https://docs.rarebl.com/ai/index.html) ## Guides - [Documentation](https://docs.rarebl.com/ai/guides/home.md): Start here: the Rarebl Open API for BTC, LTC, BCH, DASH, ETH and TRON: data, transactions, signing SDKs, webhooks, streams and market prices. - [Quickstart](https://docs.rarebl.com/ai/guides/quickstart.md): Make your first Rarebl Open API call with curl in a minute. - [Authentication](https://docs.rarebl.com/ai/guides/authentication.md): The API is keyless: no key, no account. X-API-KEY is reserved and ignored. - [Chains & units](https://docs.rarebl.com/ai/guides/chains-and-units.md): The six chains, decimals, address formats, CashAddr and base58 TRON addresses, and amount and time conventions. - [Responses & codes](https://docs.rarebl.com/ai/guides/responses-and-codes.md): The response envelope and the API200 to API500 code table, with the API409 reasons. - [Rate limits](https://docs.rarebl.com/ai/guides/rate-limits.md): 5 requests per second per IP with a burst of 20; X-RateLimit headers and Retry-After. - [Pagination](https://docs.rarebl.com/ai/guides/pagination.md): Cursor, before and page-number paging. - [Data freshness](https://docs.rarebl.com/ai/guides/data-freshness.md): Live heads every about 2 seconds, confirmations and the reorg depth per chain. - [Coverage and limits](https://docs.rarebl.com/ai/guides/limits-today.md): What is available on which chain, and why some calls answer API409: the history index, TRON history from 2026-09-08 and the syncing ETH node. - [Data types](https://docs.rarebl.com/ai/guides/data-types.md): The shared response shapes: ChainInfo, Live, BlockSummary, Block, TxSummary, Tx, Address, Token, Fees and DetailRow. - [Track a deposit until it confirms](https://docs.rarebl.com/ai/guides/track-a-deposit.md): Step by step: poll tx/status until a transaction reaches your confirmation threshold, then verify the amount with tx/get. - [Look up any address or hash](https://docs.rarebl.com/ai/guides/look-up-anything.md): Step by step: use search/query to find out what a pasted string is, then open the right endpoint. - [Watch addresses, get UTXOs and balances](https://docs.rarebl.com/ai/guides/watch-addresses.md): Step by step: watch deposit addresses, list UTXOs and balances, check spends and sweep with exact inputs. - [Webhooks](https://docs.rarebl.com/ai/guides/webhooks.md): Step by step: create a subscription, store the secrets, verify X-Rarebl-Signature, handle events, then test, pause, replay and delete. - [Live data over WebSocket](https://docs.rarebl.com/ai/guides/websocket.md): Step by step: connect to wss://api.rarebl.com/ws, subscribe, handle events and pings, reconnect and stay within the limits. - [Market data and fees](https://docs.rarebl.com/ai/guides/market-data.md): Step by step: reference prices, FX rates, candles and live network fees, and how to attribute them. - [Send a transaction](https://docs.rarebl.com/ai/guides/send-a-transaction.md): Step by step: build, verify, sign the digests locally, assemble and broadcast, with idempotency keys and fee caps. - [Sign locally with the SDKs](https://docs.rarebl.com/ai/guides/sign-locally.md): Send BTC, ETH and USDT on TRON with the JavaScript, Python, PHP or shell SDK in one transfer() call, keys never leaving your machine. - [Stuck transactions: RBF and CPFP](https://docs.rarebl.com/ai/guides/stuck-transactions.md): Step by step: find out why a payment is stuck, then replace it (RBF) or pull it through (CPFP). - [Hosted signing](https://docs.rarebl.com/ai/guides/hosted-signing.md): Sign with tx/sign, tx/send and address/new by sending a key: the encrypted envelope, the required header and the limits. - [Errors and rate limits](https://docs.rarebl.com/ai/guides/handle-errors.md): Step by step: read the error envelope, retry the right failures with back-off, make broadcasts idempotent and stay under the per-IP limits. - [Everything a platform needs](https://docs.rarebl.com/ai/guides/platform-coverage.md): The coverage table: what a platform needs from a chain API and which endpoint provides it. - [JavaScript SDK](https://docs.rarebl.com/ai/guides/sdk-js.md): Download the single-file JavaScript SDK (ESM, Node 18+ and browsers): local keys, signing, transfer(), webhook verification. - [Python SDK](https://docs.rarebl.com/ai/guides/sdk-python.md): Download the single-file Python SDK (stdlib only, Python 3.9+): local keys, signing, transfer(), webhook verification. - [PHP SDK](https://docs.rarebl.com/ai/guides/sdk-php.md): Download the single-file PHP SDK (PHP 8.1+, ext-gmp): local keys, signing, transfer(), webhook verification. - [Shell SDK](https://docs.rarebl.com/ai/guides/sdk-shell.md): Download the rarebl command line tool (bash, curl, jq): keys, transfers and webhook checks from the terminal. - [Rarebl Explorer](https://docs.rarebl.com/ai/guides/explorer.md): The Rarebl Explorer at explorer.rarebl.com shows the same data as the API in a website. - [Changelog](https://docs.rarebl.com/ai/changelog.md): What changed in the Rarebl Open API and these docs. - [FAQ](https://docs.rarebl.com/ai/faq.md): Which chains, keys, limits, freshness and support. ## API reference - [API reference](https://docs.rarebl.com/ai/api-reference.md): All 42 endpoints - [Chains (Stats)](https://docs.rarebl.com/ai/stats-chains.md): List the six supported chains with decimals, status, tip height and feature flags. - [Live stats (Stats)](https://docs.rarebl.com/ai/stats-live.md): Heads of all six chains in one call: tip, mempool and standard fee, refreshed about every 2 seconds. - [Latest blocks (Blocks)](https://docs.rarebl.com/ai/block-latest.md): List the newest blocks of a chain with a before-cursor for older blocks. - [Block (Blocks)](https://docs.rarebl.com/ai/block-get.md): Get a block by height or hash with its details and a paged list of its transactions. - [Transaction (Transactions)](https://docs.rarebl.com/ai/tx-get.md): Get the full detail of one transaction by hash, for any of the six chains. - [Transaction status (Transactions)](https://docs.rarebl.com/ai/tx-status.md): Check whether a transaction is pending, successful or failed, with its block and confirmations. - [Mempool (Transactions)](https://docs.rarebl.com/ai/tx-mempool.md): List unconfirmed transactions and mempool size for a chain. - [Address (Addresses)](https://docs.rarebl.com/ai/address-balance.md): Get the balance and summary of an address on any chain (BTC, LTC and BCH balances pending the history index). - [Address transactions (Addresses)](https://docs.rarebl.com/ai/address-transactions.md): List the transactions of an address, newest first, with a cursor. Available on DASH today. - [Address tokens (Addresses)](https://docs.rarebl.com/ai/address-tokens.md): List the known token balances (for example USDT, USDC) of an ETH or TRON address. - [Token (Stats)](https://docs.rarebl.com/ai/token-info.md): Get the metadata (standard, name, symbol, decimals, supply) of an ETH or TRON token contract. - [Recommended fees (Gas and miner fees)](https://docs.rarebl.com/ai/fees-recommended.md): Get recommended fees for a chain: fastest, medium and normal (fast, standard, slow) miner fees in sat/vB, ETH gas in Gwei or TRON energy price in sun. - [Search (Search)](https://docs.rarebl.com/ai/search-query.md): Search any block height, hash, address (BTC, LTC, BCH, DASH, ETH, TRON), token symbol or contract, or a link from another explorer, and get ranked matches with a type, chain, confidence and reason, plus suggestions on a miss. - [Build a transaction (Transactions)](https://docs.rarebl.com/ai/tx-build.md): Build an unsigned transaction (UTXO, ETH or TRON, including token transfers) and get the digests to sign. - [Assemble a signed transaction (Transactions)](https://docs.rarebl.com/ai/tx-assemble.md): Insert signatures into an unsigned transaction, verify them, and optionally broadcast. - [Broadcast a transaction (Transactions)](https://docs.rarebl.com/ai/tx-broadcast.md): Broadcast a signed transaction with pre-checks and optional idempotency (write class). - [Decode a transaction (Transactions)](https://docs.rarebl.com/ai/tx-decode.md): Decode a raw transaction into the Tx shape without broadcasting it. - [Estimate a transaction (Transactions)](https://docs.rarebl.com/ai/tx-estimate.md): Estimate the fee (and gas, energy, bandwidth) of a transaction using the tx/build body. - [Output spend status (Transactions)](https://docs.rarebl.com/ai/tx-outspends.md): Check which outputs of a UTXO transaction are spent, by which transaction, and whether in the mempool. - [Signer public key (Transactions)](https://docs.rarebl.com/ai/tx-signer-key.md): Get the signer X25519 public key used to encrypt private keys for hosted signing. - [Sign a transaction (hosted) (Hosted signing)](https://docs.rarebl.com/ai/tx-sign.md): Hosted signing: sign an unsigned transaction with private keys sent in the body. Never broadcasts. - [Build, sign and send (hosted) (Hosted signing)](https://docs.rarebl.com/ai/tx-send.md): Hosted signing: build, sign and broadcast in one call using private keys sent in the body. - [New address and key (hosted) (Hosted signing)](https://docs.rarebl.com/ai/address-new.md): Hosted key generation: returns a new address and private key once, never stored. - [Validate an address (Addresses)](https://docs.rarebl.com/ai/address-validate.md): Validate an address for a chain and get its type and normalized form. - [Watch addresses (Addresses)](https://docs.rarebl.com/ai/address-watch.md): Start watching BTC, LTC or BCH addresses so UTXOs, balances and webhooks are exact. - [Address UTXOs (Addresses)](https://docs.rarebl.com/ai/address-utxos.md): List the UTXOs and balance of a UTXO-chain address (BTC/LTC/BCH need a watch). - [Address nonce (ETH) (Addresses)](https://docs.rarebl.com/ai/address-nonce.md): Get the latest and pending nonce of an Ethereum address. - [Address resources (TRON) (Addresses)](https://docs.rarebl.com/ai/address-resources.md): Get the energy, bandwidth and frozen balances of a TRON account. - [Create a webhook (Webhooks)](https://docs.rarebl.com/ai/hooks-create.md): Create a webhook subscription (block, tx confirmations, address activity or token transfers). - [Get a webhook (Webhooks)](https://docs.rarebl.com/ai/hooks-get.md): Read a webhook subscription (needs X-Hook-Token). - [Update a webhook (Webhooks)](https://docs.rarebl.com/ai/hooks-update.md): Update a webhook subscription (needs X-Hook-Token). - [Pause a webhook (Webhooks)](https://docs.rarebl.com/ai/hooks-pause.md): Pause a webhook subscription (needs X-Hook-Token). - [Resume a webhook (Webhooks)](https://docs.rarebl.com/ai/hooks-resume.md): Resume a paused webhook subscription (needs X-Hook-Token). - [Delete a webhook (Webhooks)](https://docs.rarebl.com/ai/hooks-delete.md): Delete a webhook subscription (needs X-Hook-Token). - [Webhook deliveries (Webhooks)](https://docs.rarebl.com/ai/hooks-deliveries.md): List the last 100 delivery attempts of a webhook (needs X-Hook-Token). - [Send a test event (Webhooks)](https://docs.rarebl.com/ai/hooks-test.md): Send a signed sample event to a webhook URL (needs X-Hook-Token). - [Replay an event (Webhooks)](https://docs.rarebl.com/ai/hooks-replay.md): Replay a past webhook event (needs X-Hook-Token). - [Prices (Market)](https://docs.rarebl.com/ai/market-price.md): Reference prices for assets in usd, eur, gbp, ghs or ngn (median of public exchange feeds). - [Tickers (Market)](https://docs.rarebl.com/ai/market-tickers.md): Per-exchange tickers for an asset. - [Price history (Market)](https://docs.rarebl.com/ai/market-history.md): OHLCV candles (1m, 1h or 1d, at most 1,000) for an asset. - [Assets (Market)](https://docs.rarebl.com/ai/market-assets.md): List the assets that have market prices. - [FX rates (Market)](https://docs.rarebl.com/ai/market-fx.md): FX reference rates between currencies (for example usd to ghs and ngn).