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"
    }
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.wealthyhood.com/llms.txt

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

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.