Chain Query & Broadcast

Address Balance Query

Query token balances held by an address on a specific chain.

Request Path: POST /bgw-pro/wallet/v1/account/balancesV3

Request Parameters

Parameter	Type	Required	Description
chain	string	Yes	Chain identifier, e.g. eth, bnb, matic
address	string	Yes	User wallet address
contract	[]string	No	Token contract address list. Returns up to 1000 entries if omitted

Request Example


{
    "chain": "eth",
    "address": "0x000000000000Bb1B11e5Ac8099E92e366B64c133",
    "contract": ["0x2b591e99afE9f32eAA6214f7B7629768c40Eeb39"]
}

Response Example


{
    "code": 0,
    "data": {
        "0x2b591e99afE9f32eAA6214f7B7629768c40Eeb39": {
            "chain": "eth",
            "address": "0x000000000000Bb1B11e5Ac8099E92e366B64c133",
            "contract": "0x2b591e99afE9f32eAA6214f7B7629768c40Eeb39",
            "balance": "1.000000000000000000",
            "update_time": 1775358110
        }
    },
    "message": "success"
}

Gas Fee Query

Query the current gas price for a specified chain, with EIP-1559 fee model support for EVM chains.

Request Path: POST /bgw-pro/chain/public/getGasPriceV1

Request Parameters

Parameter	Type	Required	Description
chain	string	Yes	Chain identifier, e.g. eth, bnb, matic

Request Example


{
  "chain": "eth"
}

Response Example


{
  "code": 0,
  "message": "success",
  "data": {
    "gasPrice": "0.117109435",
    "mediumGasPrice": "0.13467585025",
    "fastGasPrice": "0.1756641525",
    "eip1559": {
      "baseFeePerGas": "0.116719073",
      "maxPriorityFeePerGas": "0.000054325",
      "maxPriorityFeePerGasTiered": {
        "normal": "0.000054325",
        "medium": "0.001",
        "fast": "0.020171544"
      }
    },
    "chainType": "evm"
  }
}

Response Fields

Field	Type	Description
gasPrice	string	Standard gas price (Gwei)
mediumGasPrice	string	Medium speed gas price
fastGasPrice	string	Fast speed gas price
eip1559.baseFeePerGas	string	EIP-1559 base fee
eip1559.maxPriorityFeePerGas	string	Default priority fee
eip1559.maxPriorityFeePerGasTiered.normal	string	Normal tier priority fee
eip1559.maxPriorityFeePerGasTiered.medium	string	Medium tier priority fee
eip1559.maxPriorityFeePerGasTiered.fast	string	Fast tier priority fee
chainType	string	Chain type, e.g. `evm`

Transaction Broadcast

Broadcast a signed raw transaction to the chain.

Request Path: POST /bgw-pro/chain/public/send

Request Parameters

Parameter	Type	Required	Description
chain	string	Yes	Chain identifier, e.g. eth, bnb, sol, trx
sig	string	Yes	Signed raw transaction (hex or base64, depending on chain)
useMevProtect	bool	No	Whether to enable MEV protection

Request Example


{
  "chain": "eth",
  "sig": "0xf86c808504a817c800825208940x1234...880de0b6b3a76400008025a0...",
  "useMevProtect": true
}

Response Example


{
  "code": 0,
  "message": "success",
  "data": {
    "txid": "0xabc123..."
  }
}