API Reference

Sign transaction

posthttps://api.circle.com/v1/w3s/developer/sign/transaction

  • Reference
  • Playground

Sign a transaction from a specific developer-controlled wallet.

You must provide either a walletId or a walletAddress and blockchain pair in the request body.

NOTE: This endpoint is only available for the following chains: SOL, SOL-DEVNET, NEAR, NEAR-TESTNET, EVM, EVM-TESTNET. Each chain defines its own standard, please refer to Signing APIs doc.

Header parameters
X-Request-Id
string

Developer-provided parameter used to identify this request. Useful when communicating with Circle Support.

Body parameters
entitySecretCiphertext
string
Required

A base64 string expression of the entity secret ciphertext. The entity secret should be encrypted by the entity public key. Circle mandates that the entity secret ciphertext is unique for each API request.

walletId
string

System-generated unique identifier of the resource.

rawTransaction
string

Raw transaction string that needs to be signed. Excluded with transaction. Required without transaction. Required to be base64 encoded for NEAR, Solana chains. Required to be hex encoded for EVM chains.

transaction
string

Transaction object in JSON that needs to be signed. Excluded with rawTransaction. Required without rawTransaction.

NOTE: This field is only supported by EVM chains.

memo
string

The human readable explanation for this sign action. Useful for presenting with extra information.

blockchain
string

The blockchain network that the resource is to be created on or is currently on.

Allowed valuesETHETH-SEPOLIAAVAXAVAX-FUJIMATICMATIC-AMOYSOLSOL-DEVNETARBARB-SEPOLIANEARNEAR-TESTNETEVMEVM-TESTNETUNIUNI-SEPOLIABASEBASE-SEPOLIAOPOP-SEPOLIAAPTOSAPTOS-TESTNETARC-TESTNET
walletAddress
string

Blockchain generated unique identifier, associated with wallet (account), smart contract or other blockchain objects.

Response
RequestChoose a language
ResponseChoose an example
1{
2  "data": {
3    "signature": "3W6r38STvZuBSmk2bbbct132SjEsYSARo3CJi3JQvNUaFoYu...",
4    "signedTransaction": "AgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABpzlAhqqen7eyTe0KQ3w+9NS4E+7sscb+Cr...",
5    "txHash": "0x4a25cc5e661d8504b59c5f38ba93f010e8518966f00e2ceda7955c4b8621357d"
6  }
7}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.