# Stacks Documentation
> Bitcoin L2 with Clarity smart contracts. Stacks REST API V2 (V1 deprecated) and Rosetta API.

- [Quicknode Stacks REST API Overview](https://www.quicknode.com/docs/stacks.md): Get started with Stacks REST API on Quicknode. Access reliable, low-latency blockchain infrastructure with globally distributed endpoints for seamless development.

## Making API Requests
- [Stacks QuickStart](https://www.quicknode.com/docs/stacks/quickstart.md): Get started with Stacks RPC on Quicknode. Follow this QuickStart to create a Stacks endpoint and make your first API request.
- [Stacks API Endpoints](https://www.quicknode.com/docs/stacks/endpoints.md): Learn how to use Stacks REST endpoints, make API requests, and handle responses with Quicknode.
- [Stacks Endpoint Security](https://www.quicknode.com/docs/stacks/endpoint-security.md): Learn about endpoint security options and how to set up a Quicknode Stacks endpoint for optimal performance and security.
- [Stacks Error Code Reference](https://www.quicknode.com/docs/stacks/error-references.md): Learn about Stacks error codes, including HTTP, JSON-RPC, and Quicknode's own custom error codes.

## API Reference
- [Stacks API Overview](https://www.quicknode.com/docs/stacks/api-overview.md): Overview of supported Stacks APIs, networks, and supported products on Quicknode.

## REST API V2 (Recommended)
- [/extended REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended.md): Retrieves the running status of the Stacks Blockchain API, including the server version and current chain tip information.
- [/extended/v2/addresses/{address}/balances/ft REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-addresses_address-balances-ft.md): Retrieves Retrieves a paginated list of fungible token (FT) balances for a specific Stacks address
- [/extended/v2/addresses/{address}/balances/ft/token REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-addresses_address-balances-ft_token.md): Retrieves the balance of a specific fungible token (FT) for a given Stacks address
- [/extended/v2/addresses/{address}/balances/stx REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-addresses_address-balances-stx.md): Retrieves comprehensive STX token balance information for a specific Stacks address, including current balances, pending transactions, miner rewards, and locking details
- [/extended/v2/addresses/{address}/transactions REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-addresses_address-transactions.md): Retrieves transactions sent or received by a STX address or smart contract ID
- [/extended/v2/addresses/{address}/transactions/{tx_id}/events REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-addresses_address-transactions_tx_id-events.md): Get events for an address transaction
- [/extended/v2/blocks](https://www.quicknode.com/docs/stacks/v2/extended-v2-blocks.md): Retrieves a list of recently mined blocks
- [/extended/v2/blocks/{height_or_hash} REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-blocks_height_or_hash.md): Get detailed information about a specific block by its height or hash
- [/extended/v2/blocks/{height_or_hash}/transactions REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-blocks_height_or_hash_transactions.md): /extended/v2/blocks/{height_or_hash}/transactions REST API Endpoint
- [/extended/v2/blocks/average-times REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-blocks-average-times.md): Returns the average block time statistics for the blockchain over various predefined periods.
- [/extended/v2/burn-blocks REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-burn-blocks.md): Get list of Stacks blocks associated with a specific burn block. The burn block can be identified by its height, hash, or using 'latest' for the most recent burn block
- [/extended/v2/burn-blocks/{height_or_hash} REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-burn-blocks_height_or_hash.md): Retrieves a single burn block
- [/extended/v2/burn-blocks/{height_or_hash}/blocks REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-burn-blocks_height_or_hash-blocks.md): Retrieves a list of blocks confirmed by a specific burn block. The burn block can be identified by its height, hash, or using 'latest' for the most recent burn block
- [/extended/v2/mempool/fees REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-mempool-fees.md): Provides fee estimates for different transaction types in the Stacks blockchain mempool.
- [/extended/v2/pox/cycles REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-pox-cycles.md): Retrieves information about Proof of Transfer (PoX) cycles
- [/extended/v2/pox/cycles/{cycle_number} REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-pox-cycles_cycle_number.md): Retrieves detailed information about a specific Proof of Transfer (PoX) cycle identified by its cycle number
- [/extended/v2/pox/cycles/{cycle_number}/signers REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-pox-cycles_cycle_number_signers.md): Retrieves a paginated list of signers (participants) who have locked STX tokens in a specific Proof of Transfer (PoX) cycle
- [/extended/v2/pox/cycles/{cycle_number}/signers/{signer_key} REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-pox-cycles_cycle_number_signers_signer_key.md): Retrieves detailed information about a specific signer (participant) in a particular Proof of Transfer (PoX) cycle
- [/extended/v2/pox/cycles/{cycle_number}/signers/{signer_key}/stackers REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-pox-cycles_cycle_number_signers_signer_key_stackers.md): Retrieves a paginated list of individual stackers who locked their STX tokens with a specific signer in a particular Proof of Transfer (PoX) cycle.
- [/extended/v2/smart-contracts/status REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/extended-v2-smart-contracts-status.md): Retrieves the deployment status of multiple smart contracts
- [/v2/accounts/{principal} REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/v2-accounts-principal.md): Get account info.
- [/v2/contracts/call-read/{contract_address}/{contract_name}/{function_name} REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/v2-contracts-call-read-contract_address-contract_name-function_name.md): Call read-only function.
- [/v2/contracts/interface/{contract_address}/{contract_name} REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/v2-contracts-interface-contract_address-contract_name.md): Retrieves a contract interface with a given `contract_address` and `contract name`.
- [/v2/contracts/source/{contract_address}/{contract_name} REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/v2-contracts-source-contract_address-contract_name.md): Retrieves the Clarity source code of a given contract, along with the block height it was published in, and the MARF proof for the data.
- [/v2/fees/transaction REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/v2-fees-transaction.md): Get approximate fees for the given transaction.
- [/v2/fees/transfer REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/v2-fees-transfer.md): Retrieves an estimated fee rate for STX transfer transactions. This a a fee rate / byte, and is returned as a JSON integer.
- [/v2/info REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/v2-info.md): Retrieves information about the Core API including the server version.
- [/v2/map_entry/{contract_address}/{contract_name}/{map_name} REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/v2-map_entry-contract_address-contract_name-map_name.md): Get specific data-map inside a contract.
- [/v2/pox REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/v2-pox.md): Retrieves Proof-of-Transfer (PoX) information. Can be used for Stacking.
- [/v2/prices/names/{name} REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/v2-prices-names-name.md): Retrieves the price of a name. The `amount` given will be in the smallest possible units of the currency.
- [/v2/prices/namespaces/{tld} REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/v2-prices-namespaces-tld.md): Retrieves the price of a namespace. The `amount` given will be in the smallest possible units of the currency.
- [/v2/transactions REST API Endpoint](https://www.quicknode.com/docs/stacks/v2/v2-transactions.md): Broadcasts raw transactions on the network.

## REST API V1 (Deprecated)
- [/extended/v1/address/{address}/mempool REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-address-address-mempool.md): Retrieves all transactions for a given address that are currently in mempool.
- [/extended/v1/address/{principal}/assets REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-address-principal-assets.md): Retrieves a list of all assets events associated with an account or a Contract Identifier. This includes Transfers, Mints.
- [/extended/v1/address/{principal}/balances REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-address-principal-balances.md): Retrieves total account balance information for a given Address or Contract Identifier. This includes the balances of STX Tokens, Fungible Tokens and Non-Fungible Tokens for the account.
- [/extended/v1/address/{principal}/nonces REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-address-principal-nonces.md): Retrieves the latest nonce values used by an account by inspecting the mempool, microblock transactions, and anchored transactions.
- [/extended/v1/address/{principal}/stx REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-address-principal-stx.md): Retrieves STX token balance for a given Address or Contract Identifier.
- [/extended/v1/address/{principal}/stx_inbound REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-address-principal-stx_inbound.md): Retrieves a list of STX transfers with memos to the given principal. This includes regular transfers from a stx-transfer transaction type, and transfers from contract-call transactions and the send-many-memo bulk sending contract.
- [/extended/v1/address/{principal}/transactions REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-address-principal-transactions.md): Retrieves a list of all transactions for a given address or contract identifier.
- [/extended/v1/address/{principal}/transactions_with_transfers REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-address-principal-transactions_with_transfers.md): Retrieves all transactions for an account or contract identifier including STX transfers for each transaction.
- [/extended/v1/address/{principal}/{tx_id}/with_transfers REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-address-principal-tx_id-with_transfers.md): Retrieves transaction details for a given Transcation Id tx_id, for a given account or contract Identifier.
- [/extended/v1/block REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-block.md): Retrieves a list of recently mined blocks. If you need to actively monitor new blocks, we recommend subscribing to WebSockets or Socket.iofor real-time updates.
- [/extended/v1/block/by_burn_block_hash/{burn_block_hash} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-block-by_burn_block_hash-burn_block_hash.md): Retrieves block details of a specific block for a given burnchain block hash.
- [/extended/v1/block/by_burn_block_height/{burn_block_height} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-block-by_burn_block_height-burn_block_height.md): Retrieves block details of a specific block for a given burn chain height.
- [/extended/v1/block/by_height/{height} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-block-by_height-height.md): Retrieves block details of a specific block at a given block height.
- [/extended/v1/block/{hash} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-block-hash.md): Retrieves block details of a specific block for a given chain height.
- [/extended/v1/burnchain/reward_slot_holders REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-burnchain-reward_slot_holders.md): Retrieves a list of the Bitcoin addresses that would validly receive Proof-of-Transfer commitments.
- [/extended/v1/burnchain/reward_slot_holders/{address} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-burnchain-reward_slot_holders-address.md): Retrieves a list of the Bitcoin addresses that would validly receive Proof-of-Transfer commitments for a given reward slot holder recipient address.
- [/extended/v1/burnchain/rewards REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-burnchain-rewards.md): Retrieves a list of recent burnchain (e.g. Bitcoin) reward recipients with the associated amounts and block info.
- [/extended/v1/burnchain/rewards/{address} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-burnchain-rewards-address.md): Retrieves a list of recent burnchain (e.g. Bitcoin) rewards for the given recipient with the associated amounts and block info.
- [/extended/v1/burnchain/rewards/{address}/total REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-burnchain-rewards-address-total.md): Retrieves the total burnchain (e.g. Bitcoin) rewards for a given recipient `address`.
- [/extended/v1/contract/by_trait REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-contract-by_trait.md): Retrieves a list of contracts based on the following traits listed in JSON format - functions, variables, maps, fungible tokens and non-fungible tokens.
- [/extended/v1/contract/{contract_id} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-contract-contract_id.md): Retrieves details of a contract with a given `contract_id`.
- [/extended/v1/contract/{contract_id}/events REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-contract-contract_id-events.md): Retrieves a list of events that have been triggered by a given `contract_id`.
- [/extended/v1/faucets/stx REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-faucets-stx.md): Get STX testnet tokens.
- [/extended/v1/fee_rate REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-fee_rate.md): Get approximate fees for the given transaction.
- [/extended/v1/info/network_block_time/{network} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-info-network_block_time-network.md): Retrieves the target block time for a given network. The network can be mainnet or testnet. The block time is hardcoded and will change throughout the implementation phases of the testnet.
- [/extended/v1/info/network_block_times REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-info-network_block_times.md): Retrieves the target block times for mainnet and testnet. The block time is hardcoded and will change throughout the implementation phases of the testnet.
- [/extended/v1/microblock REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-microblock.md): Get recent microblocks.
- [/extended/v1/microblock/{hash} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-microblock-hash.md): Retrieves a specific microblock by `hash`.
- [/extended/v1/microblock/unanchored/txs REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-microblock-unanchored-txs.md): Retrieves transactions that have been streamed in microblocks but not yet accepted or rejected in an anchor block.
- [/extended/v1/search/{id} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-search-id.md): Search blocks, transactions, contracts, or accounts by hash/ID.
- [/extended/v1/stx_supply REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-stx_supply.md): Retrieves the total and unlocked STX supply.
- [/extended/v1/stx_supply/circulating/plain REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-stx_supply-circulating-plain.md): Retrieves the STX tokens currently in circulation that have been unlocked as plain text.
- [/extended/v1/stx_supply/legacy_format REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-stx_supply-legacy_format.md): Retrieves total supply of STX tokens including those currently in circulation that have been unlocked.
- [/extended/v1/stx_supply/total/plainn REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-stx_supply-total-plain.md): Retrieves the total supply for STX tokens as plain text.
- [/extended/v1/tokens/ft/stx/holders REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-tokens-ft-stx-holders.md): Retrieves a list of STX token holders and their balances on the Stacks blockchain.
- [/extended/v1/tokens/nft/history REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-tokens-nft-history.md): Non-Fungible Token history.
- [/extended/v1/tokens/nft/holdings REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-tokens-nft-holdings.md): Non-Fungible Token holdings.
- [/extended/v1/tokens/nft/mints REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-tokens-nft-mints.md): Non-Fungible Token mints.
- [/extended/v1/tx REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-tx.md): Get recent transactions.
- [/extended/v1/tx/block/{block_hash} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-tx-block-block_hash.md): Retrieves a list of all transactions within a block for a given block hash.
- [/extended/v1/tx/block_height/{height} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-tx-block_height-height.md): Retrieves all transactions within a block at a given height.
- [/extended/v1/tx/events REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-tx-events.md): Transaction Events.
- [/extended/v1/tx/mempool REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-tx-mempool.md): Get mempool transactions.
- [/extended/v1/tx/mempool/dropped REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-tx-mempool-dropped.md): Get dropped mempool transactions.
- [/extended/v1/tx/multiple REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-tx-multiple.md): Retrieves a list of transactions for a given list of transaction IDs.
- [/extended/v1/tx/{tx_id} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-tx-tx_id.md): Retrieves transaction details for a given transaction ID.
- [/extended/v1/tx/{tx_id}/raw REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/extended-v1-tx-tx_id-raw.md): Retrieves a hex encoded serialized transaction for a given ID.
- [/v1/addresses/{blockchain}/{address} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/v1-addresses-blockchain-address.md): Retrieves a list of names owned by the address provided.
- [v1-names REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/v1-names.md): Retrieves a list of all names known to the node.
- [/v1/names/{name} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/v1-names-name.md): Retrieves details of a given name including the `address`, `status` and last transaction id - `last_txid`.
- [/v1/names/{name}/subdomains REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/v1-names-name-subdomains.md): Retrieves the list of subdomains for a specific name.
- [/v1/names/{name}/zonefile REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/v1-names-name-zonefile.md): Retrieves a user’s raw zone file. This only works for RFC-compliant zone files. This method returns an error for names that have non-standard zone files.
- [/v1/names/{name}/zonefile/{zoneFileHash} REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/v1-names-name-zonefile-zoneFileHash.md): Retrieves the historical zonefile specified by the username and zone hash.
- [/v1/namespaces REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/v1-namespaces.md): Retrieves a list of all namespaces known to the node.
- [/v1/namespaces/{tld}/names REST API Endpoint](https://www.quicknode.com/docs/stacks/v1/v1-namespaces-tld-names.md): Retrieves a list of names within a given namespace.

## Rosetta API
- [/network/list REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-network-list.md): Get List of Available Networks.
- [/network/status REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-network-status.md): Get Network Status.
- [/network/options REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-network-options.md): Get Network Options.
- [/account/balance REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-account-balance.md): Get an Account's Balance.
- [/block REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-block.md): Get a Block.
- [/block/transaction REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-block-transaction.md): Get a Block Transaction.
- [/mempool REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-mempool.md): Get All Mempool Transactions.
- [/mempool/transaction REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-mempool-transaction.md): Get a Mempool Transaction.
- [/construction/derive REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-construction-derive.md): Derive an AccountIdentifier from a PublicKey.
- [/construction/preprocess REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-construction-preprocess.md): Create a Request to Fetch Metadata.
- [/construction/preprocess-operations REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-construction-preprocess-operations.md): Parse High-Level Construction Operations.
- [/construction/metadata REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-construction-metadata.md): Get Metadata for Transaction Construction.
- [/construction/payloads REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-construction-payloads.md): Generate an Unsigned Transaction and Signing Payloads.
- [/construction/combine REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-construction-combine.md): Create Network Transaction from Signatures.
- [/construction/parse REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-construction-parse.md): Parse a Transaction.
- [/construction/hash REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-construction-hash.md): Get the Hash of a Signed Transaction.
- [/construction/submit REST API Endpoint](https://www.quicknode.com/docs/stacks/rosetta-api/rosetta-construction-submit.md): Submit a Signed Transaction.

## Marketplace
- [Supported Marketplace Add-Ons for Stacks](https://www.quicknode.com/docs/stacks/marketplace-addons.md): Supported Marketplace Add-Ons Overview for Stacks