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": "IE00B4L5Y983",
      "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": "IE00B4L5Y983",
      "consideration": {
        "currency": "EUR",
        "amount": 185
      },
      "displayAmount": 1.85,
      "displayDate": "2024-07-05T09:30:00.000Z"
    }
  }
]
Return a reverse-chronological feed of asset activity for the authenticated user, covering investment orders and dividend transactions linked to the requested ISIN. Rewards are not included in the B2B API. 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": "IE00B4L5Y983",
      "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": "IE00B4L5Y983",
      "consideration": {
        "currency": "EUR",
        "amount": 185
      },
      "displayAmount": 1.85,
      "displayDate": "2024-07-05T09:30:00.000Z"
    }
  }
]

Response fields

type
"order" | "dividend"
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.

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.

Pattern: ^[a-f0-9]{24}$

Path Parameters

isin
string
required

ISIN of the investment product to retrieve.

Pattern: ^[A-Z0-9]{12}$

Query Parameters

limit
integer

Maximum number of activity items to return.

Required range: x >= 1

Response

Ordered feed of recent activity for the asset.

type
enum<string>
required
Available options:
order
item
object
required

Order schema for asset recent activity. Aligned with InvestmentOrder format.