Skip to main content
GET
/
v1
/
trade
/
{chain}
/
activities
Activity - List
curl --request GET \
  --url https://api.chainstream.io/v1/trade/{chain}/activities \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "chain": "<string>",
      "blockHeight": 123,
      "blockTimestamp": 123,
      "accountOwnerAddress": "<string>",
      "transactionSignature": "<string>",
      "tokenName": "<string>",
      "tokenSymbol": "<string>",
      "tokenImageUrl": "<string>",
      "tokenAddress": "<string>",
      "poolAddress": "<string>",
      "dexProgramAddress": "<string>",
      "dexProtocolFamily": "<string>",
      "dexImage": "<string>",
      "tokenAmount": "<string>",
      "tokenPriceInUsd": "<string>",
      "tokenPriceInNative": "<string>",
      "tokenAmountInUsd": "<string>",
      "tokenAmountInNative": "<string>",
      "type": "<string>",
      "sideTokenName": "<string>",
      "sideTokenSymbol": "<string>",
      "sideTokenImageUrl": "<string>",
      "sideTokenAddress": "<string>",
      "sideTokenPriceInUsd": "<string>",
      "sideTokenPriceInNative": "<string>",
      "sideTokenAmount": "<string>",
      "sideTokenAmountInUsd": "<string>",
      "sideTokenAmountInNative": "<string>",
      "status": "<string>"
    }
  ],
  "hasNext": false,
  "hasPrev": false,
  "startCursor": "<string>",
  "endCursor": "<string>",
  "total": 0
}
This API only retains data for the last 15 days.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
chain
enum<string>
required

A chain name listed in supported networks

Available options:
sol,
bsc,
eth

Query Parameters

​
cursor
string

Pagination cursor

​
limit
integer<int64>
default:20

Number of results per page

Required range: 1 <= x <= 100
​
direction
enum<string>
default:next

Pagination direction (next or prev)

Available options:
next,
prev
​
tokenAddress
string

Token address to query trades

Example:

"6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"

​
walletAddress
string

Wallet address to query trades

Example:

"3xd4LGVWtYXLBspR6X5JWbW49NXmEehfPtX6Kqx98b4w"

​
poolAddress
string

Pool address to filter trades

Example:

"6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"

​
beforeTimestamp
integer<int64>

Start timestamp for filtering trades (Unix epoch in seconds)

Example:

1717334400000

​
afterTimestamp
integer<int64>

End timestamp for filtering trades (Unix epoch in seconds)

Example:

1717334400000

​
beforeBlockHeight
integer<int64>

Filter trades before this block height

Example:

332417228

​
afterBlockHeight
integer<int64>

Filter trades after this block height

Example:

332417228

​
transactionsSignature
string

Transaction signature/hash

Example:

"37XpPt9Ak6JiE1V3sftJDtdUsvR9FVFRqkZmoT3dp4BTD9pgyTWn1XgHH6R7NjuJ4pBMAgj8JvZtxQrf4s6NTC5F,3QF8Fn4ReoEjQhfZHvJy8ykodBJRZktcP21j1bQ8aM6uFXQV1CuqUoPDLNGJpkUC6bLhghxWcf54VYzRaPM66GwH"

​
type
enum<string>

Activity type

Available options:
BUY,
SELL,
LIQUIDITY_INITIALIZE,
LIQUIDITY_ADD,
LIQUIDITY_REMOVE,
RED_PACKET_CREATE,
RED_PACKET_CLAIM,
RED_PACKET_COMPLETE,
RED_PACKET_REFUND
Example:

"BUY"

Response

200 - application/json
​
data
object[]
required

Array of trade data

​
hasNext
boolean
default:false

Indicates if there are more results

​
hasPrev
boolean
default:false

Indicates if there are previous results

​
startCursor
string

Cursor for first item in current page

​
endCursor
string

Cursor for last item in current page

​
total
integer<int64>
default:0

Total number of items