The Stacks Blockchain API allows you to query the Stacks blockchain and interact with smart contracts. It was built to maintain pageable materialized views of the Stacks Blockchain.
Note that the Stacks Node RPC API and the Hiro Stacks API are two different things. The Hiro API is a centralized service run by Hiro, a developer tooling company, that makes it easy to get onboarded and begin interacting with the Stacks blockchain in a RESTful way. You can also run your own API server.
The Hiro Stacks API is a proxy for the Stacks Node API that makes it a bit easier to work with by providing additional functionality.
The RPC API is generated by every Stacks node and allows developers to self-host their own node and API for a more decentralized architecture.
The RPC API can be used without any authorization. The basepath for the API is:
# for mainnet, replace `testnet` with `mainnet`
https://api.testnet.hiro.so/{% hint style="warning" %}
If you run a local node, it exposes an HTTP server on port 20443. The info endpoint would be localhost:20443/v2/info.
{% endhint %}
The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every running Stacks node exposes an RPC API, which allows you to interact with the underlying blockchain. Instead of using a centrally hosted API, you can directly access the RPC API of a locally hosted Node.
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/contracts/interface/{contract_address}/{contract_name}" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/map_entry/{contract_address}/{contract_name}/{map_name}" method="post" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/contracts/source/{contract_address}/{contract_name}" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/contracts/call-read/{contract_address}/{contract_name}/{function_name}" method="post" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/accounts/{principal}" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/fees/transaction" method="post" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/fees/transfer" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/info" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/pox" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/traits/{contract_address}/{contract_name}/{trait_contract_address}/{trait_contract_name}/{trait_name}" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/clarity/marf/{clarity_marf_key}" method="post" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/clarity/metadata/{contract_address}/{contract_name}/{clarity_metadata_key}" method="post" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v2/constant_val/{contract_address}/{contract_name}/{constant_name}" method="post" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v3/block_proposal" method="post" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v3/stacker_set/{cycle_number}" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v3/blocks/{block_id}" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v3/blocks/height/{block_height}" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v3/tenures/info" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v3/tenures/{block_id}" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v3/sortitions/{lookup_kind}/{lookup}" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}
{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml" path="/v3/signer/{signer}/{cycle_number}" method="get" %} https://raw.githubusercontent.com/stacks-network/stacks-core/refs/heads/master/docs/rpc/openapi.yaml {% endswagger %}