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": "<string>",
  "walletId": "<string>",
  "network": "Algorand",
  "requester": {
    "userId": "<string>",
    "tokenId": "<string>"
  },
  "requestBody": {
    "kind": "Transaction",
    "transaction": "<string>",
    "externalId": "<string>"
  },
  "status": "Pending",
  "reason": "<string>",
  "txHash": "<string>",
  "fee": "<string>",
  "approvalId": "<string>",
  "dateRequested": "<string>",
  "datePolicyResolved": "<string>",
  "dateBroadcasted": "<string>",
  "dateConfirmed": "<string>",
  "externalId": "<string>"
}

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": "<string>",
  "walletId": "<string>",
  "network": "Algorand",
  "requester": {
    "userId": "<string>",
    "tokenId": "<string>"
  },
  "requestBody": {
    "kind": "Transaction",
    "transaction": "<string>",
    "externalId": "<string>"
  },
  "status": "Pending",
  "reason": "<string>",
  "txHash": "<string>",
  "fee": "<string>",
  "approvalId": "<string>",
  "dateRequested": "<string>",
  "datePolicyResolved": "<string>",
  "dateBroadcasted": "<string>",
  "dateConfirmed": "<string>",
  "externalId": "<string>"
}

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

X-DFNS-USERACTION

string

header

required

Path Parameters

walletId

string

required

Minimum length: 1

Body

application/json

Transaction
PSBT
SignDocDirect
EVM Sponsored transaction
Canton Transfer Preapproval
<Deprecated> EVM Transaction
<Deprecated> EVM EIP-1559

kind

enum<string>

required

Available options:

Transaction

transaction

required

externalId

string

Required string length: 1 - 50

Response

200 - application/json

string

required

walletId

string

required

network

enum<string>

required

Available options:

Algorand,

AlgorandTestnet,

Aptos,

AptosTestnet,

ArbitrumOne,

ArbitrumSepolia,

AvalancheC,

AvalancheCFuji,

BabylonGenesis,

BabylonTestnet5,

Base,

BaseSepolia,

Berachain,

BerachainBepolia,

Bitcoin,

BitcoinSignet,

BitcoinTestnet3,

BitcoinCash,

Bob,

BobSepolia,

Bsc,

BscTestnet,

Canton,

CantonTestnet,

Cardano,

CardanoPreprod,

Celo,

CeloAlfajores,

Codex,

CodexSepolia,

CosmosHub4,

CosmosIcsTestnet,

Dogecoin,

Ethereum,

EthereumGoerli,

EthereumSepolia,

EthereumHolesky,

EthereumHoodi,

FantomOpera,

FantomTestnet,

FlareC,

FlareCCoston2,

FlowEvm,

FlowEvmTestnet,

Hedera,

HederaTestnet,

Ink,

InkSepolia,

InternetComputer,

Ion,

IonTestnet,

Iota,

IotaTestnet,

Kaspa,

Kusama,

KusamaAssetHub,

Litecoin,

Near,

NearTestnet,

Optimism,

OptimismSepolia,

Origyn,

Plasma,

PlasmaTestnet,

Plume,

PlumeSepolia,

Paseo,

PaseoAssetHub,

Polkadot,

PolkadotAssetHub,

Polygon,

PolygonAmoy,

Polymesh,

PolymeshTestnet,

Race,

RaceSepolia,

SeiAtlantic2,

SeiPacific1,

Solana,

SolanaDevnet,

Starknet,

StarknetSepolia,

Stellar,

StellarTestnet,

Sui,

SuiTestnet,

Tsc,

TscTestnet1,

Tezos,

TezosGhostnet,

Ton,

TonTestnet,

Tron,

TronNile,

Westend,

WestendAssetHub,

XrpLedger,

XrpLedgerTestnet

requester

object

required

Show child attributes

requestBody

object

required

Transaction
PSBT
SignDocDirect
EVM Sponsored transaction
Canton Transfer Preapproval
<Deprecated> EVM Transaction
<Deprecated> EVM EIP-1559
Offer Settlement
Account Activation
Transaction Cancellation

Show child attributes

status

enum<string>

required

Available options:

Pending,

Executing,

Broadcasted,

Confirmed,

Failed,

Rejected

dateRequested

string

required

reason

string

txHash

string

fee

string

approvalId

string

datePolicyResolved

string

dateBroadcasted

string

dateConfirmed

string

externalId

string

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

API Authorization

Identity & Access Management

Wallets & Transactions

Management

Webhooks

​Authentication

​Required Permissions

Authorizations

Path Parameters

Body

Response

Authentication

Required Permissions