Skip to content

Execute a Chain Transaction

Use this endpoint to broadcast a state-changing transaction to an EVM-compatible chain. This is ideal for performing actions like token transfers, contract interactions, or submitting signed transactions. The transaction is signed by an FSCO wallet and sent on-chain.

Before you begin, ensure:

  • You have a valid FSCO walletId
  • Your transaction is correctly encoded as txData (RLP or calldata)
  • The wallet has sufficient native tokens to cover gas
POST /v2/chain/execute
{
"txData": "0xabcdef...",
"chainId": 137,
"walletId": "wallet-uuid",
"sentAt": "2025-05-08T12:00:00Z"
}
  • txData: RLP-encoded transaction data (or raw calldata if unsigned)
  • chainId: Numeric EVM chain ID (e.g. 1 for Ethereum, 137 for Polygon)
  • walletId: ID of the FSCO wallet that will sign and send the transaction
  • sentAt: ISO timestamp marking submission time
execute-transaction.sh
curl -X POST https://api.fsco.io/v2/chain/execute \
-H "Authorization: Bearer $FSCO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"txData": "0xabcdef...",
"chainId": 137,
"walletId": "wallet-uuid",
"sentAt": "2025-05-08T12:00:00Z"
}'
response.json
{
"queryId": "uuid-string"
}

The response contains a queryId which uniquely identifies the transaction within FSCO. You can use this to retrieve the transaction later or monitor its status.