Trade API

Get Gas Price#

Dynamically obtain estimated gas prices for various chains.

Request URL#

GET https://web3.okx.com/api/v5/dex/pre-transaction/gas-price

Request Parameters#

ParameterTypeRequiredDescription
chainIndexStringYesUnique identifier for the chain.
e.g., 1: Ethereum.
See more here.

Response Parameters#

EVM & Tron#

ParameterTypeDescription
normalStringMedium gas price. For EVM, it is in wei. For Tron,it is in SUN
minStringLow gas price. For EVM, it is in wei. For Tron,it is in SUN
maxStringHigh gas price. For EVM, it is in wei. For Tron,it is in SUN
supporteip1559BooleanWhether supports 1559
eip1559ProtocolObject1559 protocol

eip1559 Protocol#

ParameterTypeDescription
eip1559ProtocolObjectStructure of 1559 protocol
>suggestBaseFeeStringSuggested base fee = base fee * 1.25, in wei
>baseFeeStringBase fee, in wei
>proposePriorityFeeStringMedium priority fee, in wei
>safePriorityFeeStringLow priority fee, in wei
>fastPriorityFeeStringHigh priority fee, in wei

Solana#

ParameterTypeDescription
priorityFeeStringPriority fee per compute unit. Only applicable to Solana
>proposePriorityFeeStringMedium priority fee in microlamports.( it is also called Medium compute unit price )
>safePriorityFeeStringLow priority fee in microlamports.( it is also called Low compute unit price )
>fastPriorityFeeBooleanHigh priority fee in microlamports.( it is also called High compute unit price )

Request Example#

shell
curl --location --request GET 'https://web3.okx.com/api/v5/dex/pre-transaction/gas-price?chainIndex=1' \
--header 'Content-Type: application/json' \
--header 'OK-ACCESS-PROJECT: 86af********d1bc' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'

Response Example#

200
{
    "code": "0",
    "data": [
        {
            "normal" : "21289500000", // Medium gas price
            "min" : "15670000000",    // Low gas price
            "max" : "29149000000",    // High gas price            
            "supportEip1559" : true,  // Whether supports 1559
            "erc1599Protocol": {
                "suggestBaseFee" : "15170000000", // Suggested base fee
                "baseFee" : "15170000000",        // Base fee
                "proposePriorityFee" : "810000000", // Medium priority fee
                "safePriorityFee" : "500000000",    // Low priority fee
                "fastPriorityFee" : "3360000000"    // High priority fee
            },
            "priorityFee":{}
       }     
    ],
    "msg": ""
}