API
Introduction
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/
If you run a local node, it exposes an HTTP server on port 20443
. The info endpoint would be localhost:20443/v2/info
.
Stacks Node RPC API endpoints
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.
Get contract interface using a contract_address
and contract name
Contract interface
Bad request
Not found
Internal Server Error
GET /v2/contracts/interface/{contract_address}/{contract_name} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "#/x-ext/a873530"
}
Broadcast raw transactions on the network. You can use the @stacks/transactions project to generate a raw transaction payload.
The node performs static validation checks on transactions before accepting them into the mempool, including:
Transaction format validation
Signature verification
Nonce checking
Fee validation
Size limits
Transaction ID of successful post of a raw tx to the node's mempool.
e161978626f216b2141b156ade10501207ae535fa365a13ef5d7a7c9310a09f2
Pattern: ^[0-9a-f]{64}$
Bad request
Internal Server Error
POST /v2/transactions HTTP/1.1
Host: localhost:20443
Content-Type: application/octet-stream
Accept: */*
Content-Length: 379
"binary format of 00000000010400bed38c2aadffa348931bcb542880ff79d607afec000000000000000000000000000000c800012b0b1fff6cccd0974966dcd665835838f0985be508e1322e09fb3d751eca132c492bda720f9ef1768d14fdabed6127560ba52d5e3ac470dcb60b784e97dc88c9030200000000000516df0ba3e79792be7be5e50a370289accfc8c9e032000000000000303974657374206d656d6f00000000000000000000000000000000000000000000000000"
e161978626f216b2141b156ade10501207ae535fa365a13ef5d7a7c9310a09f2
Attempt to fetch data from a contract data map. The contract is identified with [Stacks Address] and [Contract Name] in the URL path. The map is identified with [Map Name].
The key to lookup in the map is supplied via the POST body. This should be supplied as the hex string serialization of the key (which should be a Clarity value). Note, this is a JSON string.
The response is a JSON object with the following properties:
data
: The hex serialization of the map response. Note that map responses are Clarity option types, for non-existent values, this is a serialized none, and for all other responses, it is a serialized (some ...) object.proof
: The hex serialization of the Merkle proof for the data.
Success
Bad request
Not found
Internal Server Error
POST /v2/map_entry/{contract_address}/{contract_name}/{map_name} HTTP/1.1
Host: localhost:20443
Content-Type: application/json
Accept: */*
Content-Length: 6
"text"
{
"$ref": "./components/examples/clarity-data.example.json"
}
Upload a Nakamoto block to the node for processing.
Body - must be the binary (SIP-003) serialization of a
NakamotoBlock
.Authentication - only required when the query parameter
broadcast=1
is supplied. In that case the caller must include anAuthorization
header.
If set to "1"
the node will broadcast the uploaded block to peers.
When present the request must include a valid Authorization
header.
Binary SIP-003 encoding of a NakamotoBlock
Block upload result.
{"stacks_block_id":"abc123...","accepted":true}
Bad request
Unauthorized. Invalid or missing authentication token.
Internal Server Error
POST /v3/blocks/upload HTTP/1.1
Host: localhost:20443
authorization: YOUR_API_KEY
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8
"binary"
{
"stacks_block_id": "abc123...",
"accepted": true
}
Query the mempool for transactions that might be missing from the requesting node. This endpoint supports pagination and streaming of transaction data.
Transaction ID to start pagination from
^[0-9a-f]{64}$
Binary SIP-003 encoding of MemPoolSyncData
(BloomFilter
or TxTags
variants).
Transaction IDs
Stream of missing transactions
Binary stream of transactions and pagination data. The stream contains serialized transactions followed by a page ID for continuation.
Bad request
Internal Server Error
POST /v2/mempool/query HTTP/1.1
Host: localhost:20443
Content-Type: application/octet-stream
Accept: */*
Content-Length: 25
{
"transactions": [
"text"
]
}
binary
Upload a Stacks block to the node for processing. The block must be in binary format and associated with the given consensus hash.
Consensus hash (40 hex characters)
^[0-9a-f]{40}$
Binary-encoded Stacks block
Block upload result
{"stacks_block_id":"abc123...","accepted":true}
Bad request
Not found
Internal Server Error
POST /v2/blocks/upload/{consensus_hash} HTTP/1.1
Host: localhost:20443
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8
"binary"
{
"stacks_block_id": "abc123...",
"accepted": true
}
Get an unconfirmed transaction by its transaction ID. This looks in both the mempool and unconfirmed microblock stream.
Transaction ID (64 hexadecimal characters)
^[0-9a-f]{64}$
Unconfirmed transaction details
{"tx":"800000000004...","status":"Mempool"}
Bad request
Not found
Internal Server Error
GET /v2/transactions/unconfirmed/{txid} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"tx": "800000000004...",
"status": "Mempool"
}
Get the tip block of a tenure identified by consensus hash.
Consensus hash (40 characters)
^[0-9a-f]{40}$
Tenure tip block information
Bad request
Not found
Internal Server Error
GET /v3/tenures/tip/{consensus_hash} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/get-tenure-tip.example.json"
}
Get information about tenure forking between two consensus hashes. This is used to identify conflicting tenures in the Nakamoto consensus.
Starting consensus hash (40 hexadecimal characters, without 0x prefix)
^[0-9a-f]{40}$
Stopping consensus hash (40 hexadecimal characters, without 0x prefix)
^[0-9a-f]{40}$
Ordered list of tenure fork events from stop
back to (and including) start
Bad request
Not found
Internal Server Error
GET /v3/tenures/fork_info/{start}/{stop} HTTP/1.1
Host: localhost:20443
Accept: */*
[]
Get a specific Stacks 2.x era block by its block ID. This endpoint streams the block data from the filesystem storage where traditional Stacks blocks are stored as individual files.
Compatibility: Works with all Stacks 2.x blocks. For Nakamoto blocks (Stacks 3.x+), use /v3/blocks/{block_id}
.
Hex-encoded block ID (64 characters)
^[0-9a-f]{64}$
The block data
Bad request
Not found
Internal Server Error
GET /v2/blocks/{block_id} HTTP/1.1
Host: localhost:20443
Accept: */*
binary
Deprecated: This endpoint is deprecated since Nakamoto.** Stream (as a JSON array) up to quantity
most recent anchored Stacks block headers. The result is ordered from the current tip backwards.
Number of headers to return (max 256)
Array of block headers
Bad request
Not found
Internal Server Error
GET /v2/headers/{quantity} HTTP/1.1
Host: localhost:20443
Accept: */*
No content
Fetch a data variable from a smart contract. Returns the raw hex-encoded value of the variable.
Variable name
The data variable value
{"$ref":"./components/examples/clarity-data.example.json"}
Bad request
Not found
GET /v2/data_var/{principal}/{contract_name}/{var_name} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/clarity-data.example.json"
}
Get a list of replicas for a StackerDB instance.
List of StackerDB replicas
[{"ip":"127.0.0.1","port":20444,"public_key_hash":"03abc123..."}]
Bad request
Not found
Internal Server Error
GET /v2/stackerdb/{principal}/{contract_name}/replicas HTTP/1.1
Host: localhost:20443
Accept: */*
[
{
"ip": "127.0.0.1",
"port": 20444,
"public_key_hash": "03abc123..."
}
]
Write a chunk of data to a StackerDB instance.
The request body should contain a JSON object with the chunk data including slot_id, slot_version, signature, and hex-encoded data.
The response indicates whether the chunk was accepted, and if not, provides detailed error information. Note that failed writes return HTTP 200 with accepted: false, not HTTP error codes.
Chunk submission result (both success and failure cases)
Bad request
Not found
Internal Server Error
POST /v2/stackerdb/{principal}/{contract_name}/chunks HTTP/1.1
Host: localhost:20443
Content-Type: application/json
Accept: */*
Content-Length: 74
{
"$ref": "./components/examples/stackerdb-chunk-data-request.example.json"
}
No content
Get metadata about a StackerDB instance, including slot information.
StackerDB metadata
[{"slot_id":0,"slot_version":1,"data_hash":"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","signature":"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"}]
Bad request
Not found
Internal Server Error
GET /v2/stackerdb/{principal}/{contract_name} HTTP/1.1
Host: localhost:20443
Accept: */*
[
{
"slot_id": 0,
"slot_version": 1,
"data_hash": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
"signature": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
}
]
Get a specific version of a chunk of data from a StackerDB instance.
Slot ID
Specific slot version
StackerDB chunk data
Bad request
Not found
Internal Server Error
GET /v2/stackerdb/{principal}/{contract_name}/{slot_id}/{slot_version} HTTP/1.1
Host: localhost:20443
Accept: */*
binary
Get the latest version of a chunk of data from a StackerDB instance.
Slot ID
StackerDB chunk data
Not found
Internal Server Error
GET /v2/stackerdb/{principal}/{contract_name}/{slot_id} HTTP/1.1
Host: localhost:20443
Accept: */*
binary
Submit a microblock to the node for validation and relay. The body must be the SIP-003 binary serialization of a Microblock
and sent with Content-Type: application/octet-stream
.
Index-block hash of the accepted microblock
32-byte block-header hash (hex)
^[0-9a-f]{64}$
Bad request
Not found
Internal Server Error
POST /v2/microblocks HTTP/1.1
Host: localhost:20443
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8
"binary"
3e4f5d6b7c8a9e0ff1122303445566778899aabbccddeeff0011223344556677
Get unconfirmed microblocks starting from a specific sequence number. The microblocks are returned as a binary stream.
Hex-encoded parent block ID (64 characters)
^[0-9a-f]{64}$
Starting sequence number (0-65535)
Stream of unconfirmed microblocks
Bad request
Not found
Internal Server Error
GET /v2/microblocks/unconfirmed/{block_id}/{seq} HTTP/1.1
Host: localhost:20443
Accept: */*
binary
Hex-encoded microblock hash (64 characters)
^[0-9a-f]{64}$
The microblock data
Bad request
Not found
Internal Server Error
GET /v2/microblocks/{microblock_id} HTTP/1.1
Host: localhost:20443
Accept: */*
binary
Get microblocks that were confirmed by the given anchored block. The microblocks are returned as a binary stream of concatenated microblock data.
Hex-encoded Stacks block ID (64 characters)
^[0-9a-f]{64}$
Stream of confirmed microblocks
Not found
Internal Server Error
GET /v2/microblocks/confirmed/{block_id} HTTP/1.1
Host: localhost:20443
Accept: */*
binary
Get inventory of attachments for a given index block hash and page range. This returns a bitfield indicating which attachments are available.
Hex-encoded index block hash (64 characters)
^[0-9a-f]{64}$
max 8 pages per request
1,2,3
Pattern: ^[0-9]+(,[0-9]+){0,7}$
Attachment inventory bitfield
{"block_id":"0123456789abcdef0123456789abcdef0123456789abcdef","pages":[{"index":1,"inventory":[255,0,255,0]},{"index":2,"inventory":[0,255,0,255]}]}
Bad request
Not found
GET /v2/attachments/inv HTTP/1.1
Host: localhost:20443
Accept: */*
{
"block_id": "0123456789abcdef0123456789abcdef0123456789abcdef",
"pages": [
{
"index": 1,
"inventory": [
255,
0,
255,
0
]
},
{
"index": 2,
"inventory": [
0,
255,
0,
255
]
}
]
}
Get an attachment by its hash. Attachments are content stored in the Atlas network.
The attachment hash is a 40-character hex string (SHA-1 hash).
Hex-encoded SHA-1 hash of the attachment (40 characters)
^[0-9a-f]{40}$
The attachment content
Bad request
Not found
GET /v2/attachments/{hash} HTTP/1.1
Host: localhost:20443
Accept: */*
No content
Get node health information. A node is considered healthy if its Stacks tip height matches the maximum Stacks tip height observed among its connected peers. This endpoint returns:
difference_from_max_peer
: The difference in Stacks height between this node and its most advanced peer.max_stacks_height_of_neighbors
: The maximum Stacks height observed among the node"s connected peers.node_stacks_tip_height
: The current Stacks tip height of this node.
Specifies the set of peers to use for health checks.
initial
(default): Use only the initial bootstrap peers.all
: Use all connected peers.
initial
Possible values: Success
Bad request, such as an invalid neighbors
query parameter.
Failed to query for health (e.g., no data or no valid peers to query from).
GET /v3/health HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/node-health.example.json"
}
Get a JSON with the transaction details including the index_block_hash
, the hex-encoded transaction body, and the result
.
Transaction ID (64 hexadecimal characters)
^[0-9a-f]{64}$
Transaction JSON with index_block_hash, transaction body and result
Not found
Internal Server Error
Transaction indexing not enabled
GET /v3/transaction/{txid} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/get-transaction.example.json"
}
Get number of blocks signed by signer during a given reward cycle
Hex-encoded compressed Secp256k1 public key of signer
^0[23][0-9a-f]{64}$
Reward cycle number
Number of blocks signed
GET /v3/signer/{signer_pubkey}/{cycle_number} HTTP/1.1
Host: localhost:20443
Accept: */*
Number of blocks signed
{
"blocks_signed": 7
}
Get sortition information for a specific burn block height. Returns a single-element array with the matching sortition.
Burn block height (integer)
Sortition information for the burn block height
Bad request
Not found
Internal Server Error
GET /v3/sortitions/burn_height/{height} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/get-sortitions.example.json"
}
Get sortition information for a specific burn header hash. Returns a single-element array with the matching sortition.
Hex-encoded burn header hash (64 characters)
^(0x)?[0-9a-f]{64}$
Sortition information for the burn header hash
Bad request
Not found
Internal Server Error
GET /v3/sortitions/burn/{burn_header_hash} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/get-sortitions.example.json"
}
Get sortition information for a specific consensus hash. Returns a single-element array with the matching sortition.
Hex-encoded consensus hash (40 characters)
^(0x)?[0-9a-f]{40}$
Sortition information for the consensus hash
Bad request
Not found
Internal Server Error
GET /v3/sortitions/consensus/{consensus_hash} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/get-sortitions.example.json"
}
Get sortition information about the latest burn block with a winning miner AND the previous such burn block. Returns an array with two sortition objects.
Latest and last sortition information
Bad request
Not found
Internal Server Error
GET /v3/sortitions/latest_and_last HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/get-sortitions-latest-and-prior.example.json"
}
Get sortition information about the latest burnchain block processed by this node. Returns a single-element array with the latest sortition.
Latest sortition information
Bad request
Not found
Internal Server Error
GET /v3/sortitions HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/get-sortitions.example.json"
}
Fetch a sequence of Nakamoto blocks in a tenure. The blocks will be served in order from highest to lowest. The blocks will be encoded in their SIP-003 wire format, and concatenated together.
The tenure-start block ID of the tenure to query
The block ID hash of the highest block in this tenure that is already known to the caller. Neither the corresponding block nor any of its ancestors will be served. This is used to fetch tenure blocks that the caller does not have.
SIP-003-encoded Nakamoto blocks, concatenated together
GET /v3/tenures/{block_id} HTTP/1.1
Host: localhost:20443
Accept: */*
SIP-003-encoded Nakamoto blocks, concatenated together
binary
Fetch metadata about the ongoing Nakamoto tenure. This information is sufficient to obtain and authenticate the highest complete tenure, as well as obtain new tenure blocks.
Metadata about the ongoing tenure
GET /v3/tenures/info HTTP/1.1
Host: localhost:20443
Accept: */*
Metadata about the ongoing tenure
{
"$ref": "./components/examples/get-tenure-info.example.json"
}
Fetch a Nakamoto block by its height and optional tip.
The block's height
The raw SIP-003-encoded block will be returned.
Bad request
Not found
Internal Server Error
GET /v3/blocks/height/{block_height} HTTP/1.1
Host: localhost:20443
Accept: */*
binary
Get a specific Nakamoto block (Stacks 3.x+) by its index block hash. This endpoint streams the block data from the Nakamoto staging blocks database where Nakamoto blocks are stored with additional metadata including tenure information.
Compatibility: Works with Nakamoto blocks only. For Stacks 2.x blocks, use /v2/blocks/{block_id}
.
The block"s ID hash
The raw SIP-003-encoded block will be returned.
Bad request
Not found
Internal Server Error
GET /v3/blocks/{block_id} HTTP/1.1
Host: localhost:20443
Accept: */*
binary
Used to get stacker and signer set information for a given cycle.
This will only return information for cycles started in Epoch-2.5 where PoX-4 was active and subsequent cycles.
reward cycle number
Information for the given reward cycle
Could not fetch the given reward set
GET /v3/stacker_set/{cycle_number} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/get-stacker-set.example.json"
}
Used by stackers to validate a proposed Stacks block from a miner. This API endpoint requires a basic Authorization header.
Hex-encoded block data
Chain ID for the block
Block proposal has been accepted for processing. The result will be returned via the event observer.
Bad Request
Unauthorized. Invalid or missing authentication token.
There is an ongoing proposal validation being processed, the new request cannot be accepted until the prior request has been processed.
Internal Server Error
POST /v3/block_proposal HTTP/1.1
Host: localhost:20443
authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 73
{
"$ref": "./components/examples/post-block-proposal-request.example.json"
}
{
"$ref": "./components/examples/post-block-proposal-response.example.json"
}
Attempt to fetch the value of a constant inside a contract. The contract is identified with [Stacks Address] and [Contract Name] in the URL path. The constant is identified with [Constant Name].
In the response, data
is the hex serialization of the constant value.
Success
Bad request
Not found
Internal Server Error
GET /v2/constant_val/{contract_address}/{contract_name}/{constant_name} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/constant-value.example.json"
}
Attempt to fetch the metadata of a contract. The contract is identified with [Contract Address] and [Contract Name] in the URL path. The metadata key is identified with [Clarity Metadata Key].
In the response, data
is formatted as JSON.
Metadata key
Success
Bad request
Not found
Internal Server Error
GET /v2/clarity/metadata/{contract_address}/{contract_name}/{clarity_metadata_key} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/clarity-metadata.example.json"
}
Attempt to fetch the value of a MARF key. The key is a 64-character hex string representing the MARF node hash.
The 64-character hex-encoded hash of the MARF key.
^[0-9a-f]{64}$
Success
Bad request
Not found
GET /v2/clarity/marf/{marf_key_hash} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/clarity-data.example.json"
}
Determine whether or not a specified trait is implemented (either explicitly or implicitly) within a given contract.
Stacks address of the trait-defining contract.
SP2Z1K16238380NBP4T38A4G10A90Q03JJ2C2003
Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$
Contract name of the trait-defining contract.
some-trait
Pattern: ^[a-zA-Z]([a-zA-Z0-9]|[-_]){0,127}$
some-trait
Success
Bad request
Not found
GET /v2/traits/{contract_address}/{contract_name}/{trait_contract_address}/{trait_contract_name}/{trait_name} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/is-trait-implemented.example.json"
}
Get an estimated fee rate for STX transfer transactions. This is a fee rate per byte, returned as a JSON integer (microSTX per byte).
Fee rate in microSTX per byte
Fee rate in microSTX per byte
Internal Server Error
GET /v2/fees/transfer HTTP/1.1
Host: localhost:20443
Accept: */*
3
Get an estimated fee for the supplied transaction. This estimates the execution cost of the transaction, the current fee rate of the network, and returns estimates for fee amounts.
transaction_payload
is a hex-encoded serialization of the TransactionPayload for the transaction.estimated_len
is an optional argument that provides the endpoint with an estimation of the final length (in bytes) of the transaction, including any post-conditions and signatures
If the node cannot provide an estimate for the transaction (e.g., if the node has never seen a contract-call for the given contract and function) or if estimation is not configured on this node, a 400 response is returned. The 400 response will be a JSON error containing a reason
field which can be one of the following:
DatabaseError
- this Stacks node has had an internal database error while trying to estimate the costs of the supplied transaction.NoEstimateAvailable
- this Stacks node has not seen this kind of contract-call before, and it cannot provide an estimate yet.CostEstimationDisabled
- this Stacks node does not perform fee or cost estimation, and it cannot respond on this endpoint.
The 200 response contains the following data:
estimated_cost
- the estimated multi-dimensional cost of executing the Clarity VM on the provided transaction.estimated_cost_scalar
- a unitless integer that the Stacks node uses to compare how much of the block limit is consumed by different transactions. This value incorporates the estimated length of the transaction and the estimated execution cost of the transaction. The range of this integer may vary between different Stacks nodes. In order to compute an estimate of total fee amount for the transaction, this value is multiplied by the same Stacks node"s estimated fee rate.cost_scalar_change_by_byte
- a float value that indicates how much theestimated_cost_scalar
value would increase for every additional byte in the final transaction.estimations
- an array of estimated fee rates and total fees to pay in microSTX for the transaction. This array provides a range of estimates (default: 3) that may be used. Each element of the array contains the following fields:fee_rate
- the estimated value for the current fee rates in the networkfee
- the estimated value for the total fee in microSTX that the given transaction should pay. These values are the result of computing:fee_rate
xestimated_cost_scalar
. If the estimated fees are less than the minimum relay fee(1 ustx x estimated_len)
, then that minimum relay fee will be returned here instead.
Note: If the final transaction"s byte size is larger than supplied to estimated_len
, then applications should increase this fee amount by:
fee_rate
x cost_scalar_change_by_byte
x (final_size
- estimated_size
)
Estimated fees for the transaction
Fee estimation error
Internal Server Error
POST /v2/fees/transaction HTTP/1.1
Host: localhost:20443
Content-Type: application/json
Accept: */*
Content-Length: 69
{
"$ref": "./components/examples/fee-transaction-request.example.json"
}
{
"$ref": "./components/examples/fee-transaction-response.example.json"
}
Get the account data for the provided principal
Where balance is the hex encoding of a unsigned 128-bit integer (big-endian), nonce is a unsigned 64-bit integer, and the proofs are provided as hex strings.
For non-existent accounts, this does not 404, rather it returns an object with balance and nonce of 0.
Success
Bad request
Not found
Internal Server Error
GET /v2/accounts/{principal} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/account-data.example.json"
}
Call a read-only public function on a given smart contract without cost tracking.
The contract is identified with [Stacks Address] and [Contract Name] in the URL path. The function is identified with [Function Name].
The arguments to the function are supplied via the POST body. This should be a JSON object with two main properties:
sender
which should be a standard Stacks addressarguments
which should be an array of hex-encoded Clarity values.
This API endpoint requires a basic Authorization header.
{"sender":"SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0.get-info","arguments":["0x0011...","0x00231..."]}
Function executed successfully
Bad request
Not found
Timeout
Internal Server Error
POST /v3/contracts/fast-call-read/{contract_address}/{contract_name}/{function_name} HTTP/1.1
Host: localhost:20443
authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 102
{
"sender": "SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0.get-info",
"arguments": [
"0x0011...",
"0x00231..."
]
}
No content
Call a read-only public function on a given contract.
The contract is identified with [Stacks Address] and [Contract Name] in the URL path. The function is identified with [Function Name].
The arguments to the function are supplied via the POST body. This should be a JSON object with two main properties:
sender
which should be a standard Stacks addressarguments
which should be an array of hex-encoded Clarity values.
Function executed successfully
Bad request
Not found
Internal Server Error
POST /v2/contracts/call-read/{contract_address}/{contract_name}/{function_name} HTTP/1.1
Host: localhost:20443
Content-Type: application/json
Accept: */*
No content
Returns the Clarity source code of a given contract, along with the block height it was published in, and the MARF proof for the data.
Success
Bad request
Not found
Internal Server Error
GET /v2/contracts/source/{contract_address}/{contract_name} HTTP/1.1
Host: localhost:20443
Accept: */*
{
"$ref": "./components/examples/contract-source.example.json"
}
Last updated
Was this helpful?