Skip to main content
GET
/
api
/
v3
/
{userAddress}
/
user
/
order-events
Get user order events
curl --request GET \
  --url https://api.kuru.io/api/v3/{userAddress}/user/order-events
{
  "data": {
    "data": [
      {
        "eventType": "trade",
        "transactionHash": "0xdef456...",
        "blockTimestamp": "2024-01-28T12:00:00.000Z",
        "eventData": {
          "orderId": "0xabc...",
          "marketAddress": "0x111...",
          "marketId": 3,
          "owner": "0xabc123...",
          "orderSize": "1000000000000000000",
          "filledSize": "500000000000000000",
          "fillPrice": "49998000000000000000000",
          "updatedSize": "500000000000000000",
          "isBuy": false,
          "sizePrecision": "1000000000000000000",
          "pricePrecision": "10000",
          "baseFilled": "500000000000000000",
          "baseFilledInUsd": "24999000000000000000000",
          "baseToken": {
            "address": "0x...",
            "name": "Chog",
            "symbol": "CHOG",
            "decimal": 18,
            "logoUrl": "https://..."
          },
          "quoteToken": {
            "address": "0x...",
            "name": "USD Coin",
            "symbol": "USDC",
            "decimal": 6,
            "logoUrl": "https://..."
          }
        }
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "pageSize": 50
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.kuru.io/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
userAddress
string
required

Ethereum address of the user (case-insensitive)

Example:

"0xabc123..."

Query Parameters

​
limit
integer
default:100

Maximum number of events to return in this window (payload cap, not a cursor)

Required range: x >= 1
Example:

50

​
offset
integer
default:0

Number of events to skip (legacy pagination; not recommended for high-volume market-maker polling)

Required range: x >= 0
Example:

0

​
marketAddress
string

Filter to a specific market contract address

Example:

"0x111..."

​
fromTimestamp
integer

Unix epoch in seconds; include events at or after this time (recommended cursor start)

Required range: x >= 0
Example:

1706400000

​
toTimestamp
integer

Unix epoch in seconds; include events at or before this time (recommended cursor end)

Required range: x >= 0
Example:

1706486400

​
eventType
enum<string>

Filter to a single event type

Available options:
order-created,
order-canceled,
trade
Example:

"trade"

Response

Successful response

​
data
object
required