Skip to main content

/v2/contracts/call-read/{contract_address}/{contract_name}/{function_name} REST API Endpoint

Call read-only function.

Updated on

Jun 13, 2025

Path Parameters

contract_address string: Stacks address.

contract_name string: Contract name.

function_name string: Function name.

Query Parameters

tip string: The Stacks chain tip to query from.

Body Parameters

sender string: The simulated tx-sender

arguments array: An array of hex serialized Clarity values

Returns

object object

An object which contains the following fields:

okay boolean: A flag indicating the success or failure of the request. If true, the request was successful; otherwise, it failed.

result string: The result of the contract source retrieval. It contains the source code of the requested contract.

cause string: In case of failure, this field provides information about the cause or reason for the failure.

Request

1
curl --location --request POST \
2
  "https://docs-demo.stacks-mainnet.quiknode.pro/v2/contracts/call-read/SP000000000000000000002Q6VF78/pox/get-pox-info" \
3
  --header "Content-Type: application/json" \
4
  --data '{
5
    "sender": "STM9EQRAB3QAKF8NKTP15WJT7VHH4EWG3DJB4W29",
6
    "arguments": []
7
  }'
8

1
curl --location --request POST \
2
  "https://docs-demo.stacks-mainnet.quiknode.pro/v2/contracts/call-read/SP000000000000000000002Q6VF78/pox/get-pox-info" \
3
  --header "Content-Type: application/json" \
4
  --data '{
5
    "sender": "STM9EQRAB3QAKF8NKTP15WJT7VHH4EWG3DJB4W29",
6
    "arguments": []
7
  }'
8

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free