Skip to main content
GET
/
activity
Get wallet activity
curl --request GET \
  --url https://data-api.forka.st/activity
[
  {
    "proxyWallet": "0x56687bF447db6fFa42FfE2204a05edAa20f55839",
    "timestamp": 1718125200,
    "conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
    "type": "TRADE",
    "size": 200,
    "usdcSize": 91.5,
    "transactionHash": "0xe12b59bdc88cc2f545aba5dfa8d6c7c1a2477bf44a909b2098e8bff25b6f8891",
    "price": 0.46,
    "asset": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917:0",
    "side": "BUY",
    "outcomeIndex": 0,
    "title": "Will the Fed cut rates in September?",
    "slug": "fed-rate-cut-sep-2024",
    "icon": "https://cdn.forka.st/markets/fed.png",
    "eventSlug": "fomc-2024-policy",
    "outcome": "Yes",
    "name": "Macro Whale",
    "pseudonym": "macro.whale",
    "bio": "Macro strategist backing major economic events.",
    "profileImage": "https://cdn.forka.st/users/macro-whale.png",
    "profileImageOptimized": "https://cdn.forka.st/users/[email protected]"
  },
  {
    "proxyWallet": "0x56687bF447db6fFa42FfE2204a05edAa20f55839",
    "timestamp": 1717664400,
    "conditionId": "0x8eee3789813eead2d47db3bdf6a1c5021f564ef18e2aefc8b80b9dcd5d6f8ac5",
    "type": "TRADE",
    "size": 150.25,
    "usdcSize": 72.62,
    "transactionHash": "0x74a824dddf426a1138d3fb0dc32d61837721528de933e3f3f9bf37fd61e48bb4",
    "price": 0.48,
    "asset": "0x8eee3789813eead2d47db3bdf6a1c5021f564ef18e2aefc8b80b9dcd5d6f8ac5:1",
    "side": "SELL",
    "outcomeIndex": 1,
    "title": "Will turnout exceed 60% in the French election?",
    "slug": "france-turnout-60",
    "icon": "https://cdn.forka.st/markets/france-election.png",
    "eventSlug": "french-presidential-2024",
    "outcome": "No",
    "name": "Civic Data Fund",
    "pseudonym": "civic.fund",
    "bio": "Collective focused on political prediction markets.",
    "profileImage": "https://cdn.forka.st/users/civic-fund.png",
    "profileImageOptimized": "https://cdn.forka.st/users/[email protected]"
  }
]
🟠 Trades, splits, merges, redemptions, and neg-risk conversions are live today. Reward events and profile metadata will appear once the remaining feeds are wired in.
https://data-api.forka.st/activity returns a ledger-style list that interleaves trades, splits, merges, redemptions, conversions, and rewards. Each row is enriched with market metadata and profile info so your UI can display avatars and event titles without extra queries.

​
Filtering

  • user is required and must be the wallet (proxy or EOA) you want to inspect.
  • market accepts comma-separated condition IDs with standard form encoding.
  • type accepts CSV-style lists of activity categories (TRADE, SPLIT, MERGE, REDEEM, REWARD, CONVERSION).
  • start / end can bound the time window using Unix timestamps.
  • side helps you isolate buys vs. sells when type=TRADE rows are included.

​
Pagination and sorting

Use limit (max 500) and offset (max 10,000) to page through large histories. sortBy toggles between TIMESTAMP, TOKENS, or CASH ordering, and sortDirection controls ascending/descending results.

Query Parameters

​
user
string
required

Wallet whose activity feed should be returned. Required.

Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

​
limit
integer

Maximum number of events to return (max 500).

Example:

100

​
offset
integer

Number of rows to skip (max 10,000).

Example:

0

Response

Activity records returned.

​
proxyWallet
string

0x-prefixed EVM address (40 hex chars).

Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

​
conditionId
string

0x-prefixed 64-character hex string.

Example:

"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"

​
type
enum<string>
Available options:
TRADE,
SPLIT,
MERGE,
REDEEM,
REWARD,
CONVERSION
​
size
number
​
usdcSize
number
​
timestamp
integer<int64>
​
price
number
​
side
string | null
​
asset
string | null
​
outcomeIndex
integer | null
​
transactionHash
string
​
title
string | null
​
slug
string | null
​
icon
string | null
​
eventSlug
string | null
​
outcome
string | null
​
name
string | null
​
pseudonym
string | null
​
bio
string | null
​
profileImage
string | null
​
profileImageOptimized
string | null