Starknet Add Deploy Account Transaction

v1.0.0

Base URL

https://starknet.nownodes.ioNOWNodes Starknet mainnet endpoint

Deploys a new Starknet account contract by submitting a deploy account transaction.

Authentication

api-keyAuthapiKey

NOWNodes API key passed in the api-key header.

API Key: api-key in header

Node

Starknet Node JSON-RPC methods

Starknet Add Deploy Account Transaction

POST

https://starknet.nownodes.io/

Deploys a new Starknet account contract by submitting a deploy account transaction.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_addDeployAccountTransactionrequired

paramsArray<object>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Add Deploy Account Transaction

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_addDeployAccountTransaction",
    "params": [
      {
        "type": "DEPLOY_ACCOUNT",
        "version": "0x3",
        "signature": [
          "0x4850b6d7c79f24cf36777a8adaa78974897f6b13eb8b8ede63f71671e297aff",
          "0x308ce97058625362b84affcf9aaf88cdf090a7b24ca1a5f4f5dc85bd7cbc0cd"
        ],
        "nonce": "0x0",
        "contract_address_salt": "0x4f74c6a0d14ac896720dbba50616ab91dd059578f73c12353356c56da6df1d8",
        "constructor_calldata": [
          "0x0",
          "0x4f74c6a0d14ac896720dbba50616ab91dd059578f73c12353356c56da6df1d8",
          "0x1"
        ],
        "class_hash": "0x036078334509b514626504edc9fb252328d1a240e4e948bef8d0c08dff45927f",
        "resource_bounds": {
          "l1_data_gas": {
            "max_amount": "0x5dc",
            "max_price_per_unit": "0x5f6eb0b3f"
          },
          "l1_gas": {
            "max_amount": "0x0",
            "max_price_per_unit": "0xc6f3b40b6c000"
          },
          "l2_gas": {
            "max_amount": "0x16e360",
            "max_price_per_unit": "0x1dcd65000"
          }
        },
        "tip": "0x0",
        "paymaster_data": [],
        "nonce_data_availability_mode": "L1",
        "fee_data_availability_mode": "L1"
      }
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_addDeployAccountTransaction",
      "params": [
        {
          "type": "DEPLOY_ACCOUNT",
          "version": "0x3",
          "signature": [
            "0x4850b6d7c79f24cf36777a8adaa78974897f6b13eb8b8ede63f71671e297aff",
            "0x308ce97058625362b84affcf9aaf88cdf090a7b24ca1a5f4f5dc85bd7cbc0cd"
          ],
          "nonce": "0x0",
          "contract_address_salt": "0x4f74c6a0d14ac896720dbba50616ab91dd059578f73c12353356c56da6df1d8",
          "constructor_calldata": [
            "0x0",
            "0x4f74c6a0d14ac896720dbba50616ab91dd059578f73c12353356c56da6df1d8",
            "0x1"
          ],
          "class_hash": "0x036078334509b514626504edc9fb252328d1a240e4e948bef8d0c08dff45927f",
          "resource_bounds": {
            "l1_data_gas": {
              "max_amount": "0x5dc",
              "max_price_per_unit": "0x5f6eb0b3f"
            },
            "l1_gas": {
              "max_amount": "0x0",
              "max_price_per_unit": "0xc6f3b40b6c000"
            },
            "l2_gas": {
              "max_amount": "0x16e360",
              "max_price_per_unit": "0x1dcd65000"
            }
          },
          "tip": "0x0",
          "paymaster_data": [],
          "nonce_data_availability_mode": "L1",
          "fee_data_availability_mode": "L1"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_addDeployAccountTransaction",
  "params": [
    {
      "type": "DEPLOY_ACCOUNT",
      "version": "0x3",
      "signature": [
        "0x4850b6d7c79f24cf36777a8adaa78974897f6b13eb8b8ede63f71671e297aff",
        "0x308ce97058625362b84affcf9aaf88cdf090a7b24ca1a5f4f5dc85bd7cbc0cd"
      ],
      "nonce": "0x0",
      "contract_address_salt": "0x4f74c6a0d14ac896720dbba50616ab91dd059578f73c12353356c56da6df1d8",
      "constructor_calldata": [
        "0x0",
        "0x4f74c6a0d14ac896720dbba50616ab91dd059578f73c12353356c56da6df1d8",
        "0x1"
      ],
      "class_hash": "0x036078334509b514626504edc9fb252328d1a240e4e948bef8d0c08dff45927f",
      "resource_bounds": {
        "l1_data_gas": {
          "max_amount": "0x5dc",
          "max_price_per_unit": "0x5f6eb0b3f"
        },
        "l1_gas": {
          "max_amount": "0x0",
          "max_price_per_unit": "0xc6f3b40b6c000"
        },
        "l2_gas": {
          "max_amount": "0x16e360",
          "max_price_per_unit": "0x1dcd65000"
        }
      },
      "tip": "0x0",
      "paymaster_data": [],
      "nonce_data_availability_mode": "L1",
      "fee_data_availability_mode": "L1"
    }
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_addDeployAccountTransaction",
  "params": [
    {
      "type": "DEPLOY_ACCOUNT",
      "version": "0x3",
      "signature": [
        "0x4850b6d7c79f24cf36777a8adaa78974897f6b13eb8b8ede63f71671e297aff",
        "0x308ce97058625362b84affcf9aaf88cdf090a7b24ca1a5f4f5dc85bd7cbc0cd"
      ],
      "nonce": "0x0",
      "contract_address_salt": "0x4f74c6a0d14ac896720dbba50616ab91dd059578f73c12353356c56da6df1d8",
      "constructor_calldata": [
        "0x0",
        "0x4f74c6a0d14ac896720dbba50616ab91dd059578f73c12353356c56da6df1d8",
        "0x1"
      ],
      "class_hash": "0x036078334509b514626504edc9fb252328d1a240e4e948bef8d0c08dff45927f",
      "resource_bounds": {
        "l1_data_gas": {
          "max_amount": "0x5dc",
          "max_price_per_unit": "0x5f6eb0b3f"
        },
        "l1_gas": {
          "max_amount": "0x0",
          "max_price_per_unit": "0xc6f3b40b6c000"
        },
        "l2_gas": {
          "max_amount": "0x16e360",
          "max_price_per_unit": "0x1dcd65000"
        }
      },
      "tip": "0x0",
      "paymaster_data": [],
      "nonce_data_availability_mode": "L1",
      "fee_data_availability_mode": "L1"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "contract_address": "0x5c8d90015e33db695a5e78331713d1e570a16675d9325480ca414644d7a1ef3",
    "transaction_hash": "0x3a9e66fdca21872cc9955da943c5d5cefaa02f6fc9de64ae363730994920837"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Block Hash and Number

POST

https://starknet.nownodes.io/

Returns the hash and number of the latest accepted block.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_blockHashAndNumberrequired

paramsArray<any>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Block Hash and Number

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_blockHashAndNumber",
    "params": []
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_blockHashAndNumber",
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_blockHashAndNumber",
  "params": []
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_blockHashAndNumber",
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "block_hash": "0x01da266b45a8950153584dd333778d450220164627318624dfd7b933176e4457",
    "block_number": 638358
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Block Number

POST

https://starknet.nownodes.io/

Returns the number of the latest accepted block.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_blockNumberrequired

paramsArray<any>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Block Number

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_blockNumber",
    "params": []
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_blockNumber",
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_blockNumber",
  "params": []
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_blockNumber",
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": 638358
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Call

POST

https://starknet.nownodes.io/

Calls a contract function without creating a transaction.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_callrequired

paramsArray<object>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Call

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_call",
    "params": [
      {
        "contract_address": "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
        "entry_point_selector": "0x12ead94ae9d3f9d2bdb6b847cf255f1f398193a1f88884a0ae8e18f24a037b6",
        "calldata": [
          "0xbfc2ea1a458d7cac752a4a688dbb8e0cff399e1b"
        ]
      },
      {
        "block_tag": "latest"
      }
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_call",
      "params": [
        {
          "contract_address": "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
          "entry_point_selector": "0x12ead94ae9d3f9d2bdb6b847cf255f1f398193a1f88884a0ae8e18f24a037b6",
          "calldata": [
            "0xbfc2ea1a458d7cac752a4a688dbb8e0cff399e1b"
          ]
        },
        {
          "block_tag": "latest"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_call",
  "params": [
    {
      "contract_address": "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
      "entry_point_selector": "0x12ead94ae9d3f9d2bdb6b847cf255f1f398193a1f88884a0ae8e18f24a037b6",
      "calldata": [
        "0xbfc2ea1a458d7cac752a4a688dbb8e0cff399e1b"
      ]
    },
    {
      "block_tag": "latest"
    }
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_call",
  "params": [
    {
      "contract_address": "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
      "entry_point_selector": "0x12ead94ae9d3f9d2bdb6b847cf255f1f398193a1f88884a0ae8e18f24a037b6",
      "calldata": [
        "0xbfc2ea1a458d7cac752a4a688dbb8e0cff399e1b"
      ]
    },
    {
      "block_tag": "latest"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Chain ID

POST

https://starknet.nownodes.io/

Returns the Starknet chain identifier.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_chainIdrequired

paramsArray<any>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Chain ID

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_chainId",
    "params": []
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_chainId",
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_chainId",
  "params": []
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_chainId",
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x534e5f4d41494e"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Estimate Fee

POST

https://starknet.nownodes.io/

Estimates the fee for one or more transactions without submitting them.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_estimateFeerequired

paramsArray<Array<object>>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Estimate Fee

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_estimateFee",
    "params": [
      [
        {
          "type": "INVOKE",
          "version": "0x3",
          "sender_address": "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
          "calldata": [
            "0x1"
          ],
          "signature": [
            "0x1",
            "0x2"
          ],
          "nonce": "0x1",
          "resource_bounds": {
            "l1_gas": {
              "max_amount": "0x0",
              "max_price_per_unit": "0x0"
            },
            "l2_gas": {
              "max_amount": "0x0",
              "max_price_per_unit": "0x0"
            },
            "l1_data_gas": {
              "max_amount": "0x0",
              "max_price_per_unit": "0x0"
            }
          },
          "tip": "0x0",
          "paymaster_data": [],
          "account_deployment_data": [],
          "nonce_data_availability_mode": "L1",
          "fee_data_availability_mode": "L1"
        }
      ],
      [
        "SKIP_VALIDATE"
      ],
      {
        "block_tag": "latest"
      }
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_estimateFee",
      "params": [
        [
          {
            "type": "INVOKE",
            "version": "0x3",
            "sender_address": "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
            "calldata": [
              "0x1"
            ],
            "signature": [
              "0x1",
              "0x2"
            ],
            "nonce": "0x1",
            "resource_bounds": {
              "l1_gas": {
                "max_amount": "0x0",
                "max_price_per_unit": "0x0"
              },
              "l2_gas": {
                "max_amount": "0x0",
                "max_price_per_unit": "0x0"
              },
              "l1_data_gas": {
                "max_amount": "0x0",
                "max_price_per_unit": "0x0"
              }
            },
            "tip": "0x0",
            "paymaster_data": [],
            "account_deployment_data": [],
            "nonce_data_availability_mode": "L1",
            "fee_data_availability_mode": "L1"
          }
        ],
        [
          "SKIP_VALIDATE"
        ],
        {
          "block_tag": "latest"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_estimateFee",
  "params": [
    [
      {
        "type": "INVOKE",
        "version": "0x3",
        "sender_address": "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
        "calldata": [
          "0x1"
        ],
        "signature": [
          "0x1",
          "0x2"
        ],
        "nonce": "0x1",
        "resource_bounds": {
          "l1_gas": {
            "max_amount": "0x0",
            "max_price_per_unit": "0x0"
          },
          "l2_gas": {
            "max_amount": "0x0",
            "max_price_per_unit": "0x0"
          },
          "l1_data_gas": {
            "max_amount": "0x0",
            "max_price_per_unit": "0x0"
          }
        },
        "tip": "0x0",
        "paymaster_data": [],
        "account_deployment_data": [],
        "nonce_data_availability_mode": "L1",
        "fee_data_availability_mode": "L1"
      }
    ],
    [
      "SKIP_VALIDATE"
    ],
    {
      "block_tag": "latest"
    }
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_estimateFee",
  "params": [
    [
      {
        "type": "INVOKE",
        "version": "0x3",
        "sender_address": "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
        "calldata": [
          "0x1"
        ],
        "signature": [
          "0x1",
          "0x2"
        ],
        "nonce": "0x1",
        "resource_bounds": {
          "l1_gas": {
            "max_amount": "0x0",
            "max_price_per_unit": "0x0"
          },
          "l2_gas": {
            "max_amount": "0x0",
            "max_price_per_unit": "0x0"
          },
          "l1_data_gas": {
            "max_amount": "0x0",
            "max_price_per_unit": "0x0"
          }
        },
        "tip": "0x0",
        "paymaster_data": [],
        "account_deployment_data": [],
        "nonce_data_availability_mode": "L1",
        "fee_data_availability_mode": "L1"
      }
    ],
    [
      "SKIP_VALIDATE"
    ],
    {
      "block_tag": "latest"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "l1_gas_consumed": "0x0",
      "l1_gas_price": "0x21f956748",
      "l2_gas_consumed": "0x16e360",
      "l2_gas_price": "0x1dcd65000",
      "l1_data_gas_consumed": "0x5dc",
      "l1_data_gas_price": "0x5f6eb0b3f",
      "overall_fee": "0x123456",
      "unit": "FRI"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get Block Transaction Count

POST

https://starknet.nownodes.io/

Returns the number of transactions in a block.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getBlockTransactionCountrequired

paramsArray<object>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get Block Transaction Count

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getBlockTransactionCount",
    "params": [
      {
        "block_number": 638358
      }
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getBlockTransactionCount",
      "params": [
        {
          "block_number": 638358
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getBlockTransactionCount",
  "params": [
    {
      "block_number": 638358
    }
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getBlockTransactionCount",
  "params": [
    {
      "block_number": 638358
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": 42
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get Block With Receipts

POST

https://starknet.nownodes.io/

Returns a block with full transactions and their receipts.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getBlockWithReceiptsrequired

paramsArray<object>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get Block With Receipts

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getBlockWithReceipts",
    "params": [
      {
        "block_number": 638358
      }
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getBlockWithReceipts",
      "params": [
        {
          "block_number": 638358
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getBlockWithReceipts",
  "params": [
    {
      "block_number": 638358
    }
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getBlockWithReceipts",
  "params": [
    {
      "block_number": 638358
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "status": "ACCEPTED_ON_L2",
    "block_hash": "0x1da266b45a8950153584dd333778d450220164627318624dfd7b933176e4457",
    "block_number": 638358,
    "timestamp": 1714988247,
    "transactions": [
      {
        "transaction": {
          "transaction_hash": "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b",
          "type": "INVOKE",
          "version": "0x3"
        },
        "receipt": {
          "transaction_hash": "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b",
          "finality_status": "ACCEPTED_ON_L2",
          "execution_status": "SUCCEEDED",
          "events": []
        }
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get Block With Tx Hashes

POST

https://starknet.nownodes.io/

Returns a block including transaction hashes.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getBlockWithTxHashesrequired

paramsArray<object>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get Block With Tx Hashes

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getBlockWithTxHashes",
    "params": [
      {
        "block_hash": "0x01da266b45a8950153584dd333778d450220164627318624dfd7b933176e4457"
      }
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getBlockWithTxHashes",
      "params": [
        {
          "block_hash": "0x01da266b45a8950153584dd333778d450220164627318624dfd7b933176e4457"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getBlockWithTxHashes",
  "params": [
    {
      "block_hash": "0x01da266b45a8950153584dd333778d450220164627318624dfd7b933176e4457"
    }
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getBlockWithTxHashes",
  "params": [
    {
      "block_hash": "0x01da266b45a8950153584dd333778d450220164627318624dfd7b933176e4457"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "status": "ACCEPTED_ON_L2",
    "block_hash": "0x1da266b45a8950153584dd333778d450220164627318624dfd7b933176e4457",
    "parent_hash": "0x25924599f0f11617302f66604eb314ab2edc45221e199cfff2606c609ed004f",
    "block_number": 638358,
    "new_root": "0x4cba2e296652489fdad9afa6a21baed41cbf7a49b83cd9084606d3b0cd93eae",
    "timestamp": 1714988247,
    "sequencer_address": "0x1176a1bd84444c89232ec27754698e5d2e7e1a7f1539f12027f28b23ec9f3d8",
    "transactions": [
      "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get Block With Txs

POST

https://starknet.nownodes.io/

Returns a block including full transaction objects.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getBlockWithTxsrequired

paramsArray<object>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get Block With Txs

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getBlockWithTxs",
    "params": [
      {
        "block_number": 638358
      }
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getBlockWithTxs",
      "params": [
        {
          "block_number": 638358
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getBlockWithTxs",
  "params": [
    {
      "block_number": 638358
    }
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getBlockWithTxs",
  "params": [
    {
      "block_number": 638358
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "status": "ACCEPTED_ON_L2",
    "block_hash": "0x1da266b45a8950153584dd333778d450220164627318624dfd7b933176e4457",
    "block_number": 638358,
    "timestamp": 1714988247,
    "transactions": [
      {
        "transaction_hash": "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b",
        "type": "INVOKE",
        "version": "0x3",
        "nonce": "0x1",
        "sender_address": "0x049e0ccb70e1f1684f43116e9e42e60d0f64d3d254be8d8a1143dba43dead733",
        "calldata": [
          "0x1"
        ]
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get Class

POST

https://starknet.nownodes.io/

Returns a contract class by class hash at a specified block.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getClassrequired

paramsArray<object>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get Class

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getClass",
    "params": [
      {
        "block_tag": "latest"
      },
      "0x036078334509b514626504edc9fb252328d1a240e4e948bef8d0c08dff45927f"
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getClass",
      "params": [
        {
          "block_tag": "latest"
        },
        "0x036078334509b514626504edc9fb252328d1a240e4e948bef8d0c08dff45927f"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getClass",
  "params": [
    {
      "block_tag": "latest"
    },
    "0x036078334509b514626504edc9fb252328d1a240e4e948bef8d0c08dff45927f"
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getClass",
  "params": [
    {
      "block_tag": "latest"
    },
    "0x036078334509b514626504edc9fb252328d1a240e4e948bef8d0c08dff45927f"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "sierra_program": [
      "0x1",
      "0x2"
    ],
    "contract_class_version": "0.1.0",
    "entry_points_by_type": {
      "CONSTRUCTOR": [],
      "EXTERNAL": [],
      "L1_HANDLER": []
    },
    "abi": []
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get Class At

POST

https://starknet.nownodes.io/

Returns the contract class deployed at an address in a specified block.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getClassAtrequired

paramsArray<object>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get Class At

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getClassAt",
    "params": [
      {
        "block_tag": "latest"
      },
      "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733"
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getClassAt",
      "params": [
        {
          "block_tag": "latest"
        },
        "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getClassAt",
  "params": [
    {
      "block_tag": "latest"
    },
    "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733"
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getClassAt",
  "params": [
    {
      "block_tag": "latest"
    },
    "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "sierra_program": [
      "0x1",
      "0x2"
    ],
    "contract_class_version": "0.1.0",
    "entry_points_by_type": {
      "CONSTRUCTOR": [],
      "EXTERNAL": [],
      "L1_HANDLER": []
    },
    "abi": []
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get Contract Class Hash

POST

https://starknet.nownodes.io/

Returns the class hash of the contract deployed at an address.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getClassHashAtrequired

paramsArray<object>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get Contract Class Hash

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getClassHashAt",
    "params": [
      {
        "block_tag": "latest"
      },
      "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733"
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getClassHashAt",
      "params": [
        {
          "block_tag": "latest"
        },
        "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getClassHashAt",
  "params": [
    {
      "block_tag": "latest"
    },
    "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733"
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getClassHashAt",
  "params": [
    {
      "block_tag": "latest"
    },
    "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x036078334509b514626504edc9fb252328d1a240e4e948bef8d0c08dff45927f"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get Events

POST

https://starknet.nownodes.io/

Returns events matching a filter with pagination.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getEventsrequired

paramsArray<object>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get Events

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getEvents",
    "params": [
      {
        "from_block": {
          "block_number": 638000
        },
        "to_block": {
          "block_tag": "latest"
        },
        "address": "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
        "keys": [
          [
            "0x1"
          ]
        ],
        "chunk_size": 10
      }
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getEvents",
      "params": [
        {
          "from_block": {
            "block_number": 638000
          },
          "to_block": {
            "block_tag": "latest"
          },
          "address": "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
          "keys": [
            [
              "0x1"
            ]
          ],
          "chunk_size": 10
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getEvents",
  "params": [
    {
      "from_block": {
        "block_number": 638000
      },
      "to_block": {
        "block_tag": "latest"
      },
      "address": "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
      "keys": [
        [
          "0x1"
        ]
      ],
      "chunk_size": 10
    }
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getEvents",
  "params": [
    {
      "from_block": {
        "block_number": 638000
      },
      "to_block": {
        "block_tag": "latest"
      },
      "address": "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
      "keys": [
        [
          "0x1"
        ]
      ],
      "chunk_size": 10
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "events": [
      {
        "from_address": "0x049e0ccb70e1f1684f43116e9e42e60d0f64d3d254be8d8a1143dba43dead733",
        "keys": [
          "0x1"
        ],
        "data": [
          "0x2"
        ],
        "block_hash": "0x1da266b45a8950153584dd333778d450220164627318624dfd7b933176e4457",
        "block_number": 638358,
        "transaction_hash": "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get Nonce

POST

https://starknet.nownodes.io/

Returns the nonce of a contract at a specified block.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getNoncerequired

paramsArray<object>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get Nonce

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getNonce",
    "params": [
      {
        "block_tag": "latest"
      },
      "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733"
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getNonce",
      "params": [
        {
          "block_tag": "latest"
        },
        "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getNonce",
  "params": [
    {
      "block_tag": "latest"
    },
    "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733"
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getNonce",
  "params": [
    {
      "block_tag": "latest"
    },
    "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get State Update

POST

https://starknet.nownodes.io/

Returns the state update for a block.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getStateUpdaterequired

paramsArray<object>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get State Update

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getStateUpdate",
    "params": [
      {
        "block_number": 638358
      }
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getStateUpdate",
      "params": [
        {
          "block_number": 638358
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getStateUpdate",
  "params": [
    {
      "block_number": 638358
    }
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getStateUpdate",
  "params": [
    {
      "block_number": 638358
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "block_hash": "0x1da266b45a8950153584dd333778d450220164627318624dfd7b933176e4457",
    "new_root": "0x4cba2e296652489fdad9afa6a21baed41cbf7a49b83cd9084606d3b0cd93eae",
    "old_root": "0x25924599f0f11617302f66604eb314ab2edc45221e199cfff2606c609ed004f",
    "state_diff": {
      "storage_diffs": [],
      "deprecated_declared_classes": [],
      "declared_classes": [],
      "deployed_contracts": [],
      "replaced_classes": [],
      "nonces": []
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get Storage

POST

https://starknet.nownodes.io/

Returns the value of a contract storage key at a specified block.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getStorageAtrequired

paramsArray<string>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get Storage

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getStorageAt",
    "params": [
      "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
      "0x0",
      {
        "block_tag": "latest"
      }
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getStorageAt",
      "params": [
        "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
        "0x0",
        {
          "block_tag": "latest"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getStorageAt",
  "params": [
    "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
    "0x0",
    {
      "block_tag": "latest"
    }
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getStorageAt",
  "params": [
    "0x049E0cCb70e1F1684F43116e9E42e60D0f64d3D254Be8D8A1143dba43dEad733",
    "0x0",
    {
      "block_tag": "latest"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get Transaction By Hash

POST

https://starknet.nownodes.io/

Returns a transaction by its hash.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getTransactionByHashrequired

paramsArray<string>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get Transaction By Hash

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getTransactionByHash",
    "params": [
      "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getTransactionByHash",
      "params": [
        "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getTransactionByHash",
  "params": [
    "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getTransactionByHash",
  "params": [
    "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "transaction_hash": "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b",
    "type": "INVOKE",
    "version": "0x3",
    "nonce": "0x1",
    "sender_address": "0x049e0ccb70e1f1684f43116e9e42e60d0f64d3d254be8d8a1143dba43dead733",
    "calldata": [
      "0x1"
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get Transaction Receipt

POST

https://starknet.nownodes.io/

Returns the receipt of a transaction.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getTransactionReceiptrequired

paramsArray<string>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get Transaction Receipt

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getTransactionReceipt",
    "params": [
      "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getTransactionReceipt",
      "params": [
        "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getTransactionReceipt",
  "params": [
    "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getTransactionReceipt",
  "params": [
    "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "transaction_hash": "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b",
    "actual_fee": {
      "amount": "0x123456",
      "unit": "FRI"
    },
    "finality_status": "ACCEPTED_ON_L2",
    "execution_status": "SUCCEEDED",
    "events": [],
    "messages_sent": [],
    "type": "INVOKE"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Get Transaction Status

POST

https://starknet.nownodes.io/

Returns the finality and execution status of a transaction.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_getTransactionStatusrequired

paramsArray<string>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Get Transaction Status

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_getTransactionStatus",
    "params": [
      "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
    ]
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_getTransactionStatus",
      "params": [
        "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getTransactionStatus",
  "params": [
    "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
  ]
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_getTransactionStatus",
  "params": [
    "0x074ea8c6b3c1d9beedb52f7b38f263fb4b79de8a72ad36f5a951bf67f83a3b9b"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "finality_status": "ACCEPTED_ON_L2",
    "execution_status": "SUCCEEDED"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Spec Version

POST

https://starknet.nownodes.io/

Returns the Starknet JSON-RPC specification version supported by the node.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_specVersionrequired

paramsArray<any>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Spec Version

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_specVersion",
    "params": []
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_specVersion",
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_specVersion",
  "params": []
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_specVersion",
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0.8.1"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Starknet Syncing Status

POST

https://starknet.nownodes.io/

Returns false when the node is not syncing, otherwise synchronization progress.

Body

application/json

jsonrpcstring2.0required

idinteger | stringrequired

methodstringstarknet_syncingrequired

paramsArray<any>required

Response

200OK

Successful JSON-RPC response

400Bad Request

Invalid JSON-RPC request or parameters

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or upstream server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Starknet Syncing Status

curl -X POST 'https://starknet.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "starknet_syncing",
    "params": []
  }'

const response = await fetch('https://starknet.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "starknet_syncing",
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_syncing",
  "params": []
}

response = requests.post('https://starknet.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "starknet_syncing",
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "starting_block_hash": "0x1",
    "starting_block_num": "0x1",
    "current_block_hash": "0x2",
    "current_block_num": "0x9bd96",
    "highest_block_hash": "0x3",
    "highest_block_num": "0x9bd9a"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Documentation

Authentication

Node

Node

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization