Get Started

Send a raw transaction from a user wallet from the frontend, or server wallet from the backend using the thirdweb API.

• For server wallets, you can execute transactions with just your project secret key.

• For user wallets in React applications that use the SDK, you can obtain the user wallet auth token (JWT) with the useAuthToken() hook.

• For user wallets in TypeScript applications, you can get it by calling wallet.getAuthToken() on a connected inAppWallet() or ecosystemWallet().

  Request

  POST

  /v1/transactions

  fetch("https://api.thirdweb.com/v1/transactions", {

  method: "POST",

  headers: {

  "x-secret-key": "<your-project-secret-key>",

  },

  body: {

  chainId: 137,

  from: "0x1234567890123456789012345678901234567890",

  transactions: [

  {

  data: "0xa9059cbb000000000000000000000000742d35cc6634c0532925a3b8d43c67b8c8b3e9c6000000000000000000000000000000000000000000000000016345785d8a0000",

  to: "0xA0b86a33E6411E3036C1C4c7E815D0a82e3F5fD6",

  value: "0",

  },

  ],

  },

  });

  Headers5

  x-secret-keybackend

  Project secret key - for backend usage only. Should not be used in frontend code.

  x-client-idfrontend

  Project client ID - for frontend usage on authorized domains.

  x-ecosystem-idoptional

  Ecosystem ID - for ecosystem wallets.

  x-ecosystem-partner-idoptional

  Ecosystem partner ID - for ecosystem wallets.

  Authorizationfrontend

  Bearer token (JWT) for user wallet authentication

  Request Body3

  chainIdRequired

  The blockchain network identifier where all transactions will be executed.

  Example:

  137

  fromRequired

  The wallet address or ENS name that will send the transaction.

  Example:

  0x1234567890123456789012345678901234567890

  transactionsRequired

  Array of encoded blockchain transactions to execute. All transactions will use the same from address and chainId.

  Example:

  [

  {

  "data": "0xa9059cbb000000000000000000000000742d35cc6634c0532925a3b8d43c67b8c8b3e9c6000000000000000000000000000000000000000000000000016345785d8a0000",

  "to": "0xA0b86a33E6411E3036C1C4c7E815D0a82e3F5fD6",

  "value": "0"

  }

  ]

  Response

  200

  400

  401

  500

  {

  "result": {

  "transactionIds": [

  "string"

  ]

  }

  }