Introduction

Get Trades#

Retrieve the recent transactions of a token.

Request URL#

GET https://web3.okx.com/api/v5/dex/market/trades

Request Parameters#

Parameter	Type	Required	Description
chainIndex	String	Yes	Unique identifier for the chain. e.g., `1`: Ethereum. See more here.
tokenContractAddress	String	Yes	Token contract address (e.g., 0x382bb369d343125bfb2117af9c149795c6c65c50)
after	String	No	Pagination of data to return records earlier than the requested id.
limit	String	No	Number of results per request. The maximum is 500 and default is 100.

Response Parameters#

Parameter	Type	Description
id	String	Unique trade id
chainIndex	String	Unique identifier for the chain. (e.g., 1 for Ethereum. See ChainIndex)
tokenContractAddress	String	Token contract address
txHashUrl	String	On-chain txhash of the transactions
userAddress	String	Authorizer of the transaction
dexName	String	Name of the dex where the trade occured
poolLogoUrl	String	Pool logo url
type	String	trade Type. `buy` `sell`
changedTokenInfo	String	exchanged info
> amount	String	token exchanged amount in this trade
> tokenSymbol	String	Token symbol
> tokenContractAddress	String	Token contract address
price	String	Latest token price
volume	String	USD value of this trade
time	String	Timestamp of the price, Unix timestamp format in milliseconds
isFiltered	String	If the trade is filtered for price and k-line calculation. `0`: not filtered `1`: filtered"

Get Price

Get Candlesticks

Request Example#

shell

curl --location --request GET 'https://web3.okx.com/api/v5/dex/market/trades?chainIndex=501&tokenContractAddress=HeLp6NuQkmYB4pYWo2zYs22mESHXPQYzXbB8n4V98jwC' \
--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":[
    {
    "id":"1739439633000!@#120!@#14731892839",
    "chainIndex": "501",
    "tokenContractAddress": "HeLp6NuQkmYB4pYWo2zYs22mESHXPQYzXbB8n4V98jwC",
    "txHashUrl": "https://solscan.io/tx/zgDzoiVG4XuDgQcoEg9vhpRyfyk5thNUQuTeTCeF289Qec5iraeCrUzPLyiE2UCviox2ebbTcsagGvzYF7M5uqs",
    "userAddress": "2kCm1RHGJjeCKL4SA3ZJCLyXqUD7nEJ7GMtVaP7c6jQ8",
    "dexName": "Orca Whirlpools",
    "poolLogoUrl": "https://static.okx.com/cdn/wallet/logo/dex_orcaswap.png",
    "type": "sell",
    "changedTokenInfo": [
    {
    "amount":"100.396595878", 
    "tokenSymbol":"ai16z",
    "tokenContractAddress": "HeLp6NuQkmYB4pYWo2zYs22mESHXPQYzXbB8n4V98jwC"
    },
    {
    "amount":"2.482831", 
    "tokenSymbol":"SOL",
    "tokenContractAddress": "So11111111111111111111111111111111111111112"
    }
    ]
    "price": "26.458143090226812",
    "volume": "519.788163",
    "time": "1739439633000",
    "isFiltered": "0"
    }
    ],
  "msg":"",
}

Get Price

Get Candlesticks