thirdwebDocs

GitHub

Search Docs

Ask AI

SDKs

Support

Changelog

Contracts

Get Started

Read, write, and deploy smart contracts on any EVM compatible blockchain.

HTTP

TypeScript

React

React Native

Unity

.NET

Unreal Engine

Read from Contracts

You can efficiently read data from multiple functions or contracts in a single request.

Write to Contracts

You can write multiple functions to multiple contracts on the same chain in a single request atomically, which will result in a single transaction for optimal gas efficiency.

Going further

Explore Full API References

For comprehensive guides on implementing the full thirdweb SDK, explore our language-specific documentation:

TypeScript

React

React Native

.NET

DotNet

Was this page helpful?

YesNo

Watch our
Video tutorials
View our
Changelog
Using AI?
View llms.txt

Request

POST

/v1/contracts/read


fetch("https://api.thirdweb.com/v1/contracts/read", {
  method: "POST",
  headers: {
    "x-secret-key": "<your-project-secret-key>",
  },
  body: {
    calls: [
      {
        contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        method: "function name() view returns (string)",
      },
      {
        contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        method: "function totalSupply() returns (uint256)",
      },
      {
        contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        method: "function balanceOf(address) returns (uint256)",
        params: ["0x742d35Cc6634C0532925a3b8D43C67B8c8B3E9C6"],
      },
    ],
    chainId: 8453,
  },
});

Headers4

Request Body2

Response

200

400

401

500


{
  "result": [
    {
      "success": true,
      "data": "value",
      "error": "string"
    }
  ]
}

Request

POST

/v1/contracts/write


fetch("https://api.thirdweb.com/v1/contracts/write", {
  method: "POST",
  headers: {
    "x-secret-key": "<your-project-secret-key>",
  },
  body: {
    calls: [
      {
        contractAddress: "0xe352Cf5f74e3ACfd2d59EcCee6373d2Aa996086e",
        method: "function approve(address spender, uint256 amount)",
        params: [
          "0x4fA9230f4E8978462cE7Bf8e6b5a2588da5F4264",
          1000000000,
        ],
      },
    ],
    chainId: 84532,
    from: "0x1234567890123456789012345678901234567890",
  },
});

Headers5

Request Body3

Response

200

400

401

402

404

500


{
  "result": {
    "transactionIds": [
      "string"
    ]
  }
}