Skip to main content
GET
/
investment-products
/
{isin}
/
recent-activity
curl -X GET 'https://api.wealthyhood.com/investment-products/IE00B4L5Y983/recent-activity?limit=10' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'x-user-id: 64f0c51e7fb3fc001234abcd'

[
  {
    "type": "order",
    "item": {
      "id": "64f5b3137fb3fc001234abce",
      "status": "Pending",
      "isin": "GB00B03MLX29",
      "side": "Buy",
      "settlementCurrency": "EUR",
      "quantity": 1.02,
      "consideration": {
        "currency": "EUR",
        "amount": 2550,
        "amountSubmitted": 2550
      },
      "displayAmount": 25.5,
      "displayQuantity": 1.02,
      "executionWindow": {
        "executionType": "REALTIME"
      },
      "displayExchangeRate": {
        "rate": 1.285,
        "currency": "EUR"
      },
      "isCancellable": true,
      "estimatedRealTimeCommission": 0.1,
      "displayDate": "2024-07-12T14:15:00.000Z",
      "transaction": {
        "id": "64f5b2d87fb3fc001234abcd",
        "category": "AssetTransaction",
        "status": "Pending",
        "portfolioTransactionCategory": "update",
        "createdAt": "2024-07-12T14:14:30.000Z"
      }
    }
  },
  {
    "type": "dividend",
    "item": {
      "id": "64e3c0a17fb3fc0067890def",
      "category": "DividendTransaction",
      "status": "Settled",
      "isin": "GB00B03MLX29",
      "consideration": {
        "currency": "EUR",
        "amount": 185
      },
      "displayAmount": 1.85,
      "displayDate": "2024-07-05T09:30:00.000Z"
    }
  },
  {
    "type": "reward",
    "item": {
      "id": "64d2c7f87fb3fc0043210cab",
      "status": "Settled",
      "asset": "etfs_global_sp500",
      "isin": "IE00B4L5Y983",
      "consideration": {
        "currency": "EUR",
        "amount": 1500
      },
      "displayAmount": 15,
      "displayDate": "2024-07-01T08:00:00.000Z",
      "isCancellable": false
    }
  }
]
Return a reverse-chronological feed of asset activity for the authenticated user, covering investment orders, dividend transactions, and Wealthyhood rewards linked to the requested ISIN. Provide the optional limit parameter to cap the total number of combined items returned.

​
Authentication & headers

​
Authorization
string
required
Bearer token issued by Auth0. Format: Bearer YOUR_ACCESS_TOKEN and must include the read:users scope.
​
x-user-id
string
required
MongoDB identifier of the user context (24-char hex). Required to resolve the correct portfolio and FX conversions.

​
Path parameters

​
isin
string
required
ISIN of the investment product to fetch activity for.

​
Query parameters

​
limit
integer
Maximum number of activity entries to return. When omitted, the feed returns all available items.

​
Example request

curl -X GET 'https://api.wealthyhood.com/investment-products/IE00B4L5Y983/recent-activity?limit=10' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'x-user-id: 64f0c51e7fb3fc001234abcd'

​
Example response

[
  {
    "type": "order",
    "item": {
      "id": "64f5b3137fb3fc001234abce",
      "status": "Pending",
      "isin": "GB00B03MLX29",
      "side": "Buy",
      "settlementCurrency": "EUR",
      "quantity": 1.02,
      "consideration": {
        "currency": "EUR",
        "amount": 2550,
        "amountSubmitted": 2550
      },
      "displayAmount": 25.5,
      "displayQuantity": 1.02,
      "executionWindow": {
        "executionType": "REALTIME"
      },
      "displayExchangeRate": {
        "rate": 1.285,
        "currency": "EUR"
      },
      "isCancellable": true,
      "estimatedRealTimeCommission": 0.1,
      "displayDate": "2024-07-12T14:15:00.000Z",
      "transaction": {
        "id": "64f5b2d87fb3fc001234abcd",
        "category": "AssetTransaction",
        "status": "Pending",
        "portfolioTransactionCategory": "update",
        "createdAt": "2024-07-12T14:14:30.000Z"
      }
    }
  },
  {
    "type": "dividend",
    "item": {
      "id": "64e3c0a17fb3fc0067890def",
      "category": "DividendTransaction",
      "status": "Settled",
      "isin": "GB00B03MLX29",
      "consideration": {
        "currency": "EUR",
        "amount": 185
      },
      "displayAmount": 1.85,
      "displayDate": "2024-07-05T09:30:00.000Z"
    }
  },
  {
    "type": "reward",
    "item": {
      "id": "64d2c7f87fb3fc0043210cab",
      "status": "Settled",
      "asset": "etfs_global_sp500",
      "isin": "IE00B4L5Y983",
      "consideration": {
        "currency": "EUR",
        "amount": 1500
      },
      "displayAmount": 15,
      "displayDate": "2024-07-01T08:00:00.000Z",
      "isCancellable": false
    }
  }
]

​
Response fields

​
type
"order" | "dividend" | "reward"
required
Identifies the activity category represented by the item payload.
​
item
object
required
Category-specific payload. Orders include enriched execution data, dividends expose settlement amounts, and rewards include displayable bonus information.

Authorizations

​
Authorization
string
header
required

Auth0-issued access token that includes the read:users scope.

Headers

​
x-user-id
string
required

MongoDB identifier of the Wealthyhood user whose subscription context should be applied.

Path Parameters

​
isin
string
required

ISIN of the investment product to retrieve.

Query Parameters

​
limit
integer

Maximum number of activity items to return.

Required range: x >= 1

Response

Ordered feed of recent activity for the asset.

  • Option 1
  • Option 2
  • Option 3
​
type
enum<string>
required
Available options:
order
​
item
object
required