chain

Create Fee Transaction

Initiates a fee-collection transaction on the blockchain, deducting a default or customizable basis-point fee from the sender. The response returns chain ID, addresses, gas limits, and nonce, ensuring proper verification of fee deductions and transfers.

💡 Compute Unit Value: 5 (Fixed)

post/defi/v1/chain/createfeetransaction

Request

Base URL
https://svc.blockdaemon.com
URL
https://svc.blockdaemon.com/defi/v1/chain/createfeetransaction
Auth
API key in header X-API-Key

Request body

chainId'1' | '11155111' | '25' | '56' | '97' | '43114' | '338' | '43113' | '421614' | '17000' | '42161' | '10' | '11155420' | '4002' | '324' | '300' | '137' | '80002' | '250' | '8453' | '84532'

The unique ID to direct queries or transactions to the correct blockchain. Find more here.

chainSymbolstring

The abbreviated chain name for queries or transactions.

fromstring required

Public blockchain address of the sender initiating the transaction. Format depends on the chain (e.g., 0xABCDEF... for EVM, G... for Stellar).

tostring required

Public blockchain address of the recipient. Format depends on the chain (e.g., 0xABCDEF... for EVM, G... for Stellar).

gasstring

Maximum number of gas units to allocate for the transaction, as an integer string (e.g., '200000'). If omitted, gas is estimated automatically. Note: this is gas units, not wei or gwei.

valuestring required

Amount of native currency to send with the transaction, specified in wei (integer string). Example: '1000000000000000000' = 1 ETH.

datastring

Encoded function call data for the transaction.

gasPricestring

Price per unit of gas in wei, for legacy (pre-EIP-1559) transactions (integer string). Example: '20000000000' = 20 gwei.

referenceIdstring required

A unique identifier generated for each POST request to enable tracking and referencing of the associated transaction.

simulateboolean

When true, dry-runs the transaction batch via eth_simulateV1 and returns a simulate field with status and error on each transaction.

Example request

{
  "chainId": "1",
  "chainSymbol": "ETH",
  "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "to": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "gas": "100000",
  "value": "10",
  "data": "0x40e53eb7000000000000000000000000000000000000000000000000000000000016e360",
  "gasPrice": "10000",
  "referenceId": "8eec8150896e4fdaa26d4d1a1338d676",
  "simulate": false
}

Response

Successful response

statusnumber

msgstring

Example response

{
  "status": 200,
  "msg": "success",
  "data": {
    "chainId": "1",
    "from": "0xDdE53141420C90550e87dF0349D79B3a6161f6F6",
    "to": "0x558D7be6092Ca91DA26521Ac25b982D883218E2d",
    "value": "15961584451717",
    "gas": "30000",
    "nonce": 87
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.