curl --request POST \
  --url https://api.dfns.io/wallets/{walletId}/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '
{
  "kind": "Eip1559",
  "to": "0xe5a2ebc128e262ab1e3bd02bffbe16911adfbffc",
  "value": "1",
  "maxFeePerGas": "1000000000",
  "maxPriorityFeePerGas": "1000000"
}
'

{
  "id": "tx-583hu-sp2p7-slvb9nqpa3hd8bus",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "requester": {
    "userId": "us-6b58p-r53sr-rlrd3l5cj3uc4ome",
    "tokenId": "to-202a0-cdo33-o65mbt6q758lvvnt"
  },
  "requestBody": {
    "kind": "Transaction",
    "transaction": "<string>",
    "externalId": "<string>"
  },
  "dateRequested": "2023-04-14T20:41:28.715Z",
  "reason": "<string>",
  "txHash": "<string>",
  "fee": "<string>",
  "approvalId": "ap-2a9in-tt2a1-983lho480p35ejd0",
  "datePolicyResolved": "2023-04-14T20:41:28.715Z",
  "dateBroadcasted": "2023-04-14T20:41:28.715Z",
  "dateConfirmed": "2023-04-14T20:41:28.715Z",
  "externalId": "<string>",
  "replacementId": "<string>",
  "details": {}
}

Sign and Broadcast Transaction

Sign & Broadcast transaction enables communication with any arbitrary smart contract of the target blockchain. You can construct a transaction that performs a complex task and this endpoint will sign the transaction, add the signature and broadcast it to chain. It can be used to call smart contract functions like mint tokens and even deploy new smart contracts.

Status	Definition
Pending	The request is pending approval due to a policy applied to the wallet.
Executing	The request is approved and is in the process of being executed. note this status is only set for a short time between pending and broadcasted.
Broadcasted	The transaction has been successfully written to the mempool.
Confirmed	The transaction has been confirmed on-chain by our indexing pipeline.
Failed	Indicates either a system failure to complete the request or the transaction failed on chain.
Rejected	The request has been rejected by a policy approval action.

for reading from a “view” function on EVM chains, please use Read Contract endpoint.

POST

wallets

{walletId}

transactions

curl --request POST \
  --url https://api.dfns.io/wallets/{walletId}/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '
{
  "kind": "Eip1559",
  "to": "0xe5a2ebc128e262ab1e3bd02bffbe16911adfbffc",
  "value": "1",
  "maxFeePerGas": "1000000000",
  "maxPriorityFeePerGas": "1000000"
}
'

{
  "id": "tx-583hu-sp2p7-slvb9nqpa3hd8bus",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "requester": {
    "userId": "us-6b58p-r53sr-rlrd3l5cj3uc4ome",
    "tokenId": "to-202a0-cdo33-o65mbt6q758lvvnt"
  },
  "requestBody": {
    "kind": "Transaction",
    "transaction": "<string>",
    "externalId": "<string>"
  },
  "dateRequested": "2023-04-14T20:41:28.715Z",
  "reason": "<string>",
  "txHash": "<string>",
  "fee": "<string>",
  "approvalId": "ap-2a9in-tt2a1-983lho480p35ejd0",
  "datePolicyResolved": "2023-04-14T20:41:28.715Z",
  "dateBroadcasted": "2023-04-14T20:41:28.715Z",
  "dateConfirmed": "2023-04-14T20:41:28.715Z",
  "externalId": "<string>",
  "replacementId": "<string>",
  "details": {}
}

Authentication

✅ Organization User (CustomerEmployee)
✅ Delegated User (EndUser)
✅ Service Account

Required Permissions

Wallets:Transactions:Create: Always required
FeeSponsors:Use: Required if feeSponsorId is specified.

Authorizations

Authorization

string

header

required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

X-DFNS-USERACTION

string

header

required

User Action Signature: Used to sign the change-inducing API requests. More details how to generate the token: User Action Signing flows

Path Parameters

walletId

string

required

Wallet id.

Required string length: 1 - 64

Body

application/json

Signs an unsigned transaction and broadcasts it to chain. For EVM transactions, you may use JSON objects:

Field	Description	Type - Optional
type	Ethereum transaction type. 0 for legacy transaction; 2 for EIP-1559 transaction; 4 for EIP-7702 transaction. Default is 2 if undefined.	Integer (optional)
to	The destination address or target contract. Leave undefined when the transaction is a contract deployment.	String (optional)
value	The amount of native tokens to transfer in minimum denomination.	String (optional)
data	ABI encoded function call data in hex format. Can also be the encoded smart contract data when the transaction is a contract deployment.	String (optional)
nonce	The transaction number to guarantee idempotency. If omitted, it will be provided automatically. Note the same nonce can be submitted multiple times with a higher maxFeePerGas to "overwrite" existing transactions in the mempool.	Integer or String (optional)
gasLimit	The maximum amount of gas that can be spent for executing the transaction. If omitted, it will be calculated automatically.	String (optional)
gasPrice	The amount of per unit gas. Only valid for a type 0 legacy transaction. If omitted, it will be calculated automatically.	String (optional)
maxFeePerGas	The maximum amount of per unit gas willing to be paid for the transaction. Valid for type 2 and type 4 transactions. If omitted, it will be calculated automatically.	String (optional)
maxPriorityFeePerGas	The maximum amount of per unit gas to be included as a tip to the validator. Valid for type 2 and type 4 transactions. If omitted, it will be calculated automatically.	String (optional)
authorizationList	A list that indicates what code the signer of each authorization desires to execute in the context of their EOA. Only valid for type 4 transaction.	Authorization (optional)

For Starknet transactions, you may use invocation request objects (https://github.com/starkware-libs/starknet-specs/blob/v0.8.1/api/starknet_api_openrpc.json#L2621):

Field	Description	Type - Optional
calldata	Array of encoded function call parameters	Array of Strings (required)
nonce	Transaction nonce in hex format	String (required)
version	Transaction version in hex format. Typically "0x3" for current transactions	String (required)
resourceBounds	Gas bounds for L1, L2, and L1 data gas	Object (required)
↳ resourceBounds.l1Gas	L1 gas configuration with maxAmount and maxPricePerUnit	Object (required)
↳ resourceBounds.l2Gas	L2 gas configuration with maxAmount and maxPricePerUnit	Object (required)
↳ resourceBounds.l1DataGas	L1 data gas configuration with maxAmount and maxPricePerUnit	Object (required)
tip	Transaction tip in hex format. Typically "0x0"	String (required)
paymasterData	Paymaster data array	Array of Strings (required)
accountDeploymentData	Account deployment data array	Array of Strings (required)
nonceDataAvailabilityMode	Data availability mode for nonce. Typically "L1" for now	String (required)
feeDataAvailabilityMode	Data availability mode for fee. Typically "L1" for now	String (required)

For Concordium transactions, you may use JSON objects (from https://github.com/Concordium/concordium-node-sdk-js/blob/sdk/12.0.0-alpha.3/packages/sdk/src/transactions/Transaction.ts#L102)

Field	Description	Type - Optional
Header	Transaction header for the intermediary state of account transactions, i.e. prior to being signing.	Object (required)
↳ Header.executionEnergyAmount	The destination address or target contract. Leave undefined when the transaction is a contract deployment.	String/Number/BigInt (required)
↳ Header.numSignatures	The number of signatures the transaction can hold. If "undefined", this will be defined at the time of signing	Integer (optional)
↳ Header.sender	The account address that is source of this transaction	String (optional)
↳ Header.nonce	The account nonce	String/Number/BigInt (optional)
↳ Header.expiry	expiration of the transaction	Integer (optional)
Payload	The transaction account payload in JSON format (https://github.com/Concordium/concordium-node-sdk-js/blob/main/packages/sdk/src/accountTransactions.ts#L646)	Object (required)

{
  "kind": "Transaction",
  "transaction": {
    "to": "0x00fb58432ef9d418bf6688bcf0a226d2fcaa18e2",
    "data": "0x40d097c3000000000000000000000000d2f77f85a50cdd650ca562f3a180284e1d5b4934",
    "maxFeePerGas": "1626000000000",
    "maxPriorityFeePerGas": "1332000000000"
  }
}

{
  "kind": "Transaction",
  "transaction": {
    "type": "INVOKE",
    "calldata": [
      "1",
      "2009894490435840142178314390393166646092438090257831307886760648929397478285",
      "232670485425082704932579856502088130646006032362877466777181098476241604910",
      "3",
      "296727860213112272332383824629975240127004024814636931420022890499591637514",
      "1",
      "0"
    ],
    "nonce": "0x51",
    "version": "0x3",
    "resourceBounds": {
      "l1Gas": { "maxAmount": "0x0", "maxPricePerUnit": "0x239a01ff6e6c" },
      "l2Gas": { "maxAmount": "0x1694a0", "maxPricePerUnit": "0x10c388d00" },
      "l1DataGas": { "maxAmount": "0x120", "maxPricePerUnit": "0x98e8" }
    },
    "tip": "0x0",
    "paymasterData": [],
    "accountDeploymentData": [],
    "nonceDataAvailabilityMode": "L1",
    "feeDataAvailabilityMode": "L1",
  }
}

{
  "kind": "Transaction",
  "transaction": {
    "header": {
      "sender": undefined,
      "nonce": undefined,
      "expiry": undefined,
      "executionEnergyAmount": 300
    },
    "payload": {
      "type": "transferWithMemo",
      "toAddress": "4HhAcToZs6rtxGcgsBRS3VcjeAECPTTSTFVUKS6rBSVEZAPL6d",
      "memo": "000968656c6c6f20636364",
      "amount": "1"
    }
  }
}

kind

enum<string>

required

Available options:

Transaction

transaction

required

The unsigned hex encoded transaction or JSON transactions for compatible networks.

Pattern: ^(0x)?([0-9a-fA-F][0-9a-fA-F])*$

externalId

string

A unique ID from your system. It can be leveraged to be used as an idempotency key (read more here).

Required string length: 1 - 50

Response

200 - application/json

Success

string

required

Transaction id.

Required string length: 1 - 64

Pattern: ^tx-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"tx-583hu-sp2p7-slvb9nqpa3hd8bus"

walletId

string

required

Wallet id.

Required string length: 1 - 64

Pattern: ^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

network

enum<string>

required

Available options:

Algorand,

AlgorandTestnet,

Aptos,

AptosTestnet,

ArbitrumOne,

ArbitrumSepolia,

ArcTestnet,

AvalancheC,

AvalancheCFuji,

BabylonGenesis,

BabylonTestnet5,

Base,

BaseSepolia,

Berachain,

BerachainBepolia,

Bitcoin,

BitcoinSignet,

BitcoinTestnet4,

BitcoinCash,

Bob,

BobSepolia,

Bsc,

BscTestnet,

Canton,

CantonTestnet,

Cardano,

CardanoPreprod,

Concordium,

ConcordiumTestnet,

Celo,

CeloAlfajores,

Codex,

CodexSepolia,

CosmosHub4,

CosmosIcsTestnet,

Dogecoin,

DogecoinTestnet,

Ethereum,

EthereumClassic,

EthereumClassicMordor,

EthereumSepolia,

EthereumHoodi,

FlareC,

FlareCCoston2,

FlowEvm,

FlowEvmTestnet,

Hedera,

HederaTestnet,

Ink,

InkSepolia,

InternetComputer,

Ion,

IonTestnet,

Iota,

IotaTestnet,

Kusama,

KusamaAssetHub,

Litecoin,

LitecoinTestnet,

Movement,

MovementTestnet,

Near,

NearTestnet,

Optimism,

OptimismSepolia,

Origyn,

Plasma,

PlasmaTestnet,

Plume,

PlumeSepolia,

Paseo,

PaseoAssetHub,

Polkadot,

PolkadotAssetHub,

Polygon,

PolygonAmoy,

Polymesh,

PolymeshTestnet,

Race,

RaceSepolia,

Rayls,

RaylsTestnet,

Robinhood,

RobinhoodSepolia,

SeiAtlantic2,

SeiPacific1,

Solana,

SolanaDevnet,

Sonic,

SonicTestnet,

Starknet,

StarknetSepolia,

Stellar,

StellarTestnet,

Sui,

SuiTestnet,

Tezos,

TezosGhostnet,

TezosShadownet,

Tempo,

TempoModerato,

Tsc,

TscTestnet1,

Ton,

TonTestnet,

Tron,

TronNile,

Westend,

WestendAssetHub,

Xdc,

XdcApothem,

XLayer,

XLayerSepolia,

XrpLedger,

XrpLedgerTestnet

requester

object

required

The user who initiated the request.

Show child attributes

requestBody

Transaction · object

required

Signs an unsigned transaction and broadcasts it to chain. For EVM transactions, you may use JSON objects:

Field	Description	Type - Optional
type	Ethereum transaction type. 0 for legacy transaction; 2 for EIP-1559 transaction; 4 for EIP-7702 transaction. Default is 2 if undefined.	Integer (optional)
to	The destination address or target contract. Leave undefined when the transaction is a contract deployment.	String (optional)
value	The amount of native tokens to transfer in minimum denomination.	String (optional)
data	ABI encoded function call data in hex format. Can also be the encoded smart contract data when the transaction is a contract deployment.	String (optional)
nonce	The transaction number to guarantee idempotency. If omitted, it will be provided automatically. Note the same nonce can be submitted multiple times with a higher maxFeePerGas to "overwrite" existing transactions in the mempool.	Integer or String (optional)
gasLimit	The maximum amount of gas that can be spent for executing the transaction. If omitted, it will be calculated automatically.	String (optional)
gasPrice	The amount of per unit gas. Only valid for a type 0 legacy transaction. If omitted, it will be calculated automatically.	String (optional)
maxFeePerGas	The maximum amount of per unit gas willing to be paid for the transaction. Valid for type 2 and type 4 transactions. If omitted, it will be calculated automatically.	String (optional)
maxPriorityFeePerGas	The maximum amount of per unit gas to be included as a tip to the validator. Valid for type 2 and type 4 transactions. If omitted, it will be calculated automatically.	String (optional)
authorizationList	A list that indicates what code the signer of each authorization desires to execute in the context of their EOA. Only valid for type 4 transaction.	Authorization (optional)

For Starknet transactions, you may use invocation request objects (https://github.com/starkware-libs/starknet-specs/blob/v0.8.1/api/starknet_api_openrpc.json#L2621):

Field	Description	Type - Optional
calldata	Array of encoded function call parameters	Array of Strings (required)
nonce	Transaction nonce in hex format	String (required)
version	Transaction version in hex format. Typically "0x3" for current transactions	String (required)
resourceBounds	Gas bounds for L1, L2, and L1 data gas	Object (required)
↳ resourceBounds.l1Gas	L1 gas configuration with maxAmount and maxPricePerUnit	Object (required)
↳ resourceBounds.l2Gas	L2 gas configuration with maxAmount and maxPricePerUnit	Object (required)
↳ resourceBounds.l1DataGas	L1 data gas configuration with maxAmount and maxPricePerUnit	Object (required)
tip	Transaction tip in hex format. Typically "0x0"	String (required)
paymasterData	Paymaster data array	Array of Strings (required)
accountDeploymentData	Account deployment data array	Array of Strings (required)
nonceDataAvailabilityMode	Data availability mode for nonce. Typically "L1" for now	String (required)
feeDataAvailabilityMode	Data availability mode for fee. Typically "L1" for now	String (required)

For Concordium transactions, you may use JSON objects (from https://github.com/Concordium/concordium-node-sdk-js/blob/sdk/12.0.0-alpha.3/packages/sdk/src/transactions/Transaction.ts#L102)

Field	Description	Type - Optional
Header	Transaction header for the intermediary state of account transactions, i.e. prior to being signing.	Object (required)
↳ Header.executionEnergyAmount	The destination address or target contract. Leave undefined when the transaction is a contract deployment.	String/Number/BigInt (required)
↳ Header.numSignatures	The number of signatures the transaction can hold. If "undefined", this will be defined at the time of signing	Integer (optional)
↳ Header.sender	The account address that is source of this transaction	String (optional)
↳ Header.nonce	The account nonce	String/Number/BigInt (optional)
↳ Header.expiry	expiration of the transaction	Integer (optional)
Payload	The transaction account payload in JSON format (https://github.com/Concordium/concordium-node-sdk-js/blob/main/packages/sdk/src/accountTransactions.ts#L646)	Object (required)

{
  "kind": "Transaction",
  "transaction": {
    "to": "0x00fb58432ef9d418bf6688bcf0a226d2fcaa18e2",
    "data": "0x40d097c3000000000000000000000000d2f77f85a50cdd650ca562f3a180284e1d5b4934",
    "maxFeePerGas": "1626000000000",
    "maxPriorityFeePerGas": "1332000000000"
  }
}

{
  "kind": "Transaction",
  "transaction": {
    "type": "INVOKE",
    "calldata": [
      "1",
      "2009894490435840142178314390393166646092438090257831307886760648929397478285",
      "232670485425082704932579856502088130646006032362877466777181098476241604910",
      "3",
      "296727860213112272332383824629975240127004024814636931420022890499591637514",
      "1",
      "0"
    ],
    "nonce": "0x51",
    "version": "0x3",
    "resourceBounds": {
      "l1Gas": { "maxAmount": "0x0", "maxPricePerUnit": "0x239a01ff6e6c" },
      "l2Gas": { "maxAmount": "0x1694a0", "maxPricePerUnit": "0x10c388d00" },
      "l1DataGas": { "maxAmount": "0x120", "maxPricePerUnit": "0x98e8" }
    },
    "tip": "0x0",
    "paymasterData": [],
    "accountDeploymentData": [],
    "nonceDataAvailabilityMode": "L1",
    "feeDataAvailabilityMode": "L1",
  }
}

{
  "kind": "Transaction",
  "transaction": {
    "header": {
      "sender": undefined,
      "nonce": undefined,
      "expiry": undefined,
      "executionEnergyAmount": 300
    },
    "payload": {
      "type": "transferWithMemo",
      "toAddress": "4HhAcToZs6rtxGcgsBRS3VcjeAECPTTSTFVUKS6rBSVEZAPL6d",
      "memo": "000968656c6c6f20636364",
      "amount": "1"
    }
  }
}

Show child attributes

status

enum<string>

required

Available options:

Pending,

Executing,

Broadcasted,

Confirmed,

Failed,

Rejected

dateRequested

string<date-time>

required

ISO 8601 date (must be UTC). When the transaction was requested.

Example:

"2023-04-14T20:41:28.715Z"

reason

string

txHash

string

fee

string

approvalId

string

Required string length: 1 - 64

Pattern: ^ap-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"ap-2a9in-tt2a1-983lho480p35ejd0"

datePolicyResolved

string<date-time>

ISO 8601 date (must be UTC). When the transaction was approved by policy reviewers.

Example:

"2023-04-14T20:41:28.715Z"

dateBroadcasted

string<date-time>

ISO 8601 date (must be UTC). When the transaction was broadcasted to the blockchain.

Example:

"2023-04-14T20:41:28.715Z"

dateConfirmed

string<date-time>

ISO 8601 date (must be UTC). When the transaction was confirmed on chain.

Example:

"2023-04-14T20:41:28.715Z"

externalId

string

replacementId

string

The id of the replacement transaction (cancel or speed-up) issued for this transaction.

details

object

Structured representation of the data used to construct the signature (e.g. nonce, gas parameters). Shape is blockchain specific.

Show child attributes

Last modified on July 9, 2026

Broadcast

List Transactions

⌘I

API Authorization

Identity & Access Management

Wallets & Transactions

Management

Webhooks

Sign and Broadcast Transaction

Authentication

Required Permissions

Authorizations

Path Parameters

Body

Response

​Authentication

​Required Permissions

Authorizations

Path Parameters

Body

Response

Authentication

Required Permissions