Wallet

Estimate network fee from blockchain (all supported chains; not controlled by Mudbase)

**Network fee (from blockchain only).** Returns network fee **estimated directly from the blockchain** via RPC or fee APIs. **Not controlled by Mudbase.** Both POST /api/wallet/estimate-network-fee (or calculate-fee) and this endpoint return network fee only; use either for gas/fee display. This endpoint is chain-oriented and supports full transaction shape for EVM. **EVM chains:** ethereum, polygon, arbitrum, optimism, base, bsc, binance, avalanche, celo — require `transaction` (from, and to/value or tokenAddress/amount). Response includes gasLimit, gasPrice, networkFee, estimatedTime, currency. **Non-EVM chains:** bitcoin, litecoin, dogecoin, solana, tron, ton, cardano — only `chain` is required; `transaction` is optional/ignored. Returns networkFee, estimatedTime, currency (and e.g. satPerVb for UTXO). See docs/FEE_ARCHITECTURE.md. Results cached 15s.

AuthBearer (JWT)
GroupWallet
Rate limitSee Rate Limits
POST/api/wallet/non-custodial/estimate-gas

SDK setup

Create a client and set credentials (JWT and/or API key) before calling the API. Match the authentication type shown above.

import { Configuration, WalletApi } from 'mudbase-sdk';

const configuration = new Configuration({
  basePath: 'https://cloud.mudbase.dev',
  accessToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c3JfbW9yZ2FuX2RlIiwiZW1haWwiOiJtb3JnYW4uY2hlbkBub3J0aHdpbmQuZGV2IiwiZXhwIjoxODI1MTI5NjAwfQ.doc_preview_sig',
});

const wallet = new WalletApi(configuration);
import { Configuration, WalletApi } from 'mudbase-sdk';

const configuration = new Configuration({
  basePath: 'https://cloud.mudbase.dev',
  accessToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c3JfbW9yZ2FuX2RlIiwiZW1haWwiOiJtb3JnYW4uY2hlbkBub3J0aHdpbmQuZGV2IiwiZXhwIjoxODI1MTI5NjAwfQ.doc_preview_sig',
});

const wallet = new WalletApi(configuration);

Example request

Call this endpoint using the client from SDK setup. Use View HTTP for a raw cURL example.

const { data: result } = await wallet.estimateNonCustodialGas(
  {
    chain: "feed synthesize",
    transaction: "panel back up"
  }
);
const { data: result } = await wallet.estimateNonCustodialGas(
  {
    chain: "feed synthesize",
    transaction: "panel back up"
  }
);

Playground

live

Test this endpoint with your own credentials. Your requests will be sent to the live API.

Use the auth endpoints to obtain a JWT.

No Request Yet

Send a request to see the full inspector

Authentication

Requires JWT
Note
Include your JWT in the Authorization: Bearer YOUR_TOKEN header (user-facing apps, RBAC). View authentication guide →

Request Body

json
{
  "chain": "arbitrum",
  "transaction": {
    "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "to": "0x53d284357ec70cE289D6D64134DfAc8E511c8a3D",
    "value": "1.0",
    "data": "0xa9059cbb000000000000000000000000...",
    "tokenAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "amount": "1.0"
  }
}
{
  "chain": "arbitrum",
  "transaction": {
    "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "to": "0x53d284357ec70cE289D6D64134DfAc8E511c8a3D",
    "value": "1.0",
    "data": "0xa9059cbb000000000000000000000000...",
    "tokenAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "amount": "1.0"
  }
}

Responses

200Network fee from blockchain RPC (not from Mudbase logic)

Ethereum (ETH) — from RPC

json
{
  "success": true,
  "data": {
    "chain": "ethereum",
    "gasLimit": "21000",
    "gasPrice": "30000000000",
    "gasPriceGwei": 30,
    "estimatedCost": "630000000000000",
    "networkFee": "0.00063 ETH",
    "estimatedTime": "15 seconds",
    "currency": "ETH"
  }
}
{
  "success": true,
  "data": {
    "chain": "ethereum",
    "gasLimit": "21000",
    "gasPrice": "30000000000",
    "gasPriceGwei": 30,
    "estimatedCost": "630000000000000",
    "networkFee": "0.00063 ETH",
    "estimatedTime": "15 seconds",
    "currency": "ETH"
  }
}

Polygon (MATIC)

json
{
  "success": true,
  "data": {
    "chain": "polygon",
    "gasLimit": "21000",
    "gasPrice": "50000000000",
    "gasPriceGwei": 50,
    "estimatedCost": "1050000000000000",
    "networkFee": "0.00105 MATIC",
    "estimatedTime": "15 seconds",
    "currency": "MATIC"
  }
}
{
  "success": true,
  "data": {
    "chain": "polygon",
    "gasLimit": "21000",
    "gasPrice": "50000000000",
    "gasPriceGwei": 50,
    "estimatedCost": "1050000000000000",
    "networkFee": "0.00105 MATIC",
    "estimatedTime": "15 seconds",
    "currency": "MATIC"
  }
}

Arbitrum One (ETH)

json
{
  "success": true,
  "data": {
    "chain": "arbitrum",
    "gasLimit": "21000",
    "gasPrice": "100000000",
    "gasPriceGwei": 0.1,
    "estimatedCost": "2100000000000",
    "networkFee": "0.0000021 ETH",
    "estimatedTime": "15 seconds",
    "currency": "ETH"
  }
}
{
  "success": true,
  "data": {
    "chain": "arbitrum",
    "gasLimit": "21000",
    "gasPrice": "100000000",
    "gasPriceGwei": 0.1,
    "estimatedCost": "2100000000000",
    "networkFee": "0.0000021 ETH",
    "estimatedTime": "15 seconds",
    "currency": "ETH"
  }
}

Optimism (ETH)

json
{
  "success": true,
  "data": {
    "chain": "optimism",
    "gasLimit": "21000",
    "gasPrice": "1000000",
    "gasPriceGwei": 0.001,
    "estimatedCost": "21000000000",
    "networkFee": "0.000000021 ETH",
    "estimatedTime": "15 seconds",
    "currency": "ETH"
  }
}
{
  "success": true,
  "data": {
    "chain": "optimism",
    "gasLimit": "21000",
    "gasPrice": "1000000",
    "gasPriceGwei": 0.001,
    "estimatedCost": "21000000000",
    "networkFee": "0.000000021 ETH",
    "estimatedTime": "15 seconds",
    "currency": "ETH"
  }
}

Base (ETH)

json
{
  "success": true,
  "data": {
    "chain": "base",
    "gasLimit": "21000",
    "gasPrice": "1000000000",
    "gasPriceGwei": 0.001,
    "estimatedCost": "21000000000000",
    "networkFee": "0.000021 ETH",
    "estimatedTime": "15 seconds",
    "currency": "ETH"
  }
}
{
  "success": true,
  "data": {
    "chain": "base",
    "gasLimit": "21000",
    "gasPrice": "1000000000",
    "gasPriceGwei": 0.001,
    "estimatedCost": "21000000000000",
    "networkFee": "0.000021 ETH",
    "estimatedTime": "15 seconds",
    "currency": "ETH"
  }
}

BNB Smart Chain (BNB)

json
{
  "success": true,
  "data": {
    "chain": "bsc",
    "gasLimit": "21000",
    "gasPrice": "5000000000",
    "gasPriceGwei": 5,
    "estimatedCost": "105000000000000",
    "networkFee": "0.000105 BNB",
    "estimatedTime": "15 seconds",
    "currency": "BNB"
  }
}
{
  "success": true,
  "data": {
    "chain": "bsc",
    "gasLimit": "21000",
    "gasPrice": "5000000000",
    "gasPriceGwei": 5,
    "estimatedCost": "105000000000000",
    "networkFee": "0.000105 BNB",
    "estimatedTime": "15 seconds",
    "currency": "BNB"
  }
}

Avalanche C-Chain (AVAX)

json
{
  "success": true,
  "data": {
    "chain": "avalanche",
    "gasLimit": "21000",
    "gasPrice": "25000000000",
    "gasPriceGwei": 25,
    "estimatedCost": "525000000000000",
    "networkFee": "0.000525 AVAX",
    "estimatedTime": "15 seconds",
    "currency": "AVAX"
  }
}
{
  "success": true,
  "data": {
    "chain": "avalanche",
    "gasLimit": "21000",
    "gasPrice": "25000000000",
    "gasPriceGwei": 25,
    "estimatedCost": "525000000000000",
    "networkFee": "0.000525 AVAX",
    "estimatedTime": "15 seconds",
    "currency": "AVAX"
  }
}

Celo (CELO)

json
{
  "success": true,
  "data": {
    "chain": "celo",
    "gasLimit": "21000",
    "gasPrice": "1000000000",
    "gasPriceGwei": 1,
    "estimatedCost": "21000000000000",
    "networkFee": "0.000021 CELO",
    "estimatedTime": "15 seconds",
    "currency": "CELO"
  }
}
{
  "success": true,
  "data": {
    "chain": "celo",
    "gasLimit": "21000",
    "gasPrice": "1000000000",
    "gasPriceGwei": 1,
    "estimatedCost": "21000000000000",
    "networkFee": "0.000021 CELO",
    "estimatedTime": "15 seconds",
    "currency": "CELO"
  }
}

Bitcoin (BTC) — non-EVM

json
{
  "success": true,
  "data": {
    "chain": "bitcoin",
    "networkFee": "0.00002500 BTC",
    "estimatedTime": "10–30 minutes",
    "satPerVb": 15,
    "feeSat": 3750
  }
}
{
  "success": true,
  "data": {
    "chain": "bitcoin",
    "networkFee": "0.00002500 BTC",
    "estimatedTime": "10–30 minutes",
    "satPerVb": 15,
    "feeSat": 3750
  }
}

Solana (SOL) — non-EVM

json
{
  "success": true,
  "data": {
    "chain": "solana",
    "networkFee": "0.000005 SOL",
    "lamports": 5000,
    "estimatedTime": "15 seconds",
    "currency": "SOL"
  }
}
{
  "success": true,
  "data": {
    "chain": "solana",
    "networkFee": "0.000005 SOL",
    "lamports": 5000,
    "estimatedTime": "15 seconds",
    "currency": "SOL"
  }
}

Tron (TRX) — non-EVM

json
{
  "success": true,
  "data": {
    "chain": "tron",
    "networkFee": "1 TRX",
    "estimatedTime": "3 seconds",
    "currency": "TRX"
  }
}
{
  "success": true,
  "data": {
    "chain": "tron",
    "networkFee": "1 TRX",
    "estimatedTime": "3 seconds",
    "currency": "TRX"
  }
}
400—
401—
429—

Errors

CodeMeaning
400—
401—
429—
Run in PostmanDownload OpenAPI

Next

NEXT →API Reference OverviewBase URL, rate limits, pagination, and the full endpoint index.NEXT →AuthenticationAPI keys, Bearer tokens, and user sessions.NEXT →API PlaygroundSearch any endpoint and send a live request.
Edit this page on GitHub