Skip to main content

​
Get User Activity

Fetch a paginated list of a user’s trading activity including buys, sells, and splits.
​
user
string
required
The user’s wallet address or proxy wallet address
​
limit
string
default:"50"
Number of activity records to return (max 50)
​
offset
string
default:"0"
Number of records to skip for pagination
​
conditionId
string
Optional condition ID to filter activity for a specific market
​
marketId
string
Optional market ID to filter activity for a specific market

​
Response

​
proxyWallet
string
The user’s proxy wallet address
​
timestamp
number
Unix timestamp of the activity (in seconds)
​
conditionId
string
The condition ID of the market
​
type
string
Type of activity: buy, sell, or split
​
size
number
Number of shares traded
​
usdcSize
number
USD value of the trade
​
transactionHash
string
Blockchain transaction hash
​
price
number
Price per share (0-1)
​
asset
string
The asset token address
​
side
string
Trade side: buy or sell
​
outcomeIndex
number
Index of the outcome (0 for Yes, 1 for No)
​
title
string
Market title
​
slug
string
Market slug identifier
​
icon
string
URL to market icon image
​
eventSlug
string
Event slug identifier
​
outcome
string
Outcome name (e.g., “Yes”, “No”)
​
name
string
User’s display name
​
pseudonym
string
User’s pseudonym
​
profileImage
string
URL to user’s profile image
​
profileImageOptimized
string
URL to optimized profile image
​
tags
string[]
Array of tag labels associated with the market

​
Example Request

cURL
curl -X GET "https://api.kuest.com/v1/activity?user=0x1234...&limit=20&offset=0" \
  -H "Content-Type: application/json"
```bash

### Example Response

```json
[
  {
    "proxyWallet": "0x1234567890abcdef",
    "timestamp": 1709500800,
    "conditionId": "0xabcd...",
    "type": "buy",
    "size": 100.5,
    "usdcSize": 65.32,
    "transactionHash": "0xtxhash...",
    "price": 0.65,
    "asset": "0xasset...",
    "side": "buy",
    "outcomeIndex": 0,
    "title": "Will Bitcoin reach $100k in 2024?",
    "slug": "bitcoin-100k-2024",
    "icon": "https://cdn.kuest.com/icons/bitcoin.png",
    "eventSlug": "crypto-predictions",
    "outcome": "Yes",
    "name": "trader_alice",
    "profileImage": "https://cdn.kuest.com/avatars/alice.jpg",
    "tags": ["crypto", "bitcoin"]
  }
]
```bash

<Note>
  Activity records are returned in reverse chronological order (newest first). Use pagination parameters to retrieve historical data.
</Note>

Build docs developers (and LLMs) love

Get started for freeTalk to us