Get Strategy

Returns the details of a specific strategy, including its linked accounts, funding logs, and historical snapshots.

GET /portfolios/{portfolioId}/strategies/{strategyId}

cURL

cURL

curl --request GET \
  --url https://lighthouse.one/v1/api/portfolios/{portfolioId}/strategies/{strategyId} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "01JSGMSKSS5RBJ976GR1PTZ3V3",
  "name": "ETH Staking",
  "startsAt": "2025-01-15T00:00:00.000+00:00",
  "endsAt": null,
  "status": "ONGOING",
  "description": "Diversified ETH staking across protocols",
  "accountingCurrency": "USD",
  "positionsValue": 125430.5,
  "fundingValue": 100000,
  "pnlValue": 25430.5,
  "positions": [
    {
      "id": "01JZYKJR05YBC7WHRYNKTVCP07-1",
      "network": "Ethereum",
      "platform": "Lido",
      "account": "Main Wallet",
      "address": "0x2be4b1f8787ae0aab54d15aa20bb90909160967a",
      "type": "Staked",
      "assetSymbol": "stETH",
      "assetName": "Lido Staked Ether",
      "assetContext": "supply",
      "amount": 32.5,
      "price": 3500,
      "usdValue": 113750,
      "description": null
    },
    {
      "id": "01JZYKJR05VY46XPH5CKBPVAPX-1",
      "network": "Ethereum",
      "platform": "Rocket Pool",
      "account": "Main Wallet",
      "address": "0x2be4b1f8787ae0aab54d15aa20bb90909160967a",
      "type": "Staked",
      "assetSymbol": "rETH",
      "assetName": "Rocket Pool ETH",
      "assetContext": "supply",
      "amount": 3.4,
      "price": 3430.5,
      "usdValue": 11663.7
    }
  ],
  "accounts": [
    {
      "id": "01JR8KXYZ12ABC34DEF56GH789",
      "name": "Main Wallet",
      "address": "0x2be4b1f8787ae0aab54d15aa20bb90909160967a"
    }
  ],
  "funding": [
    {
      "id": "01JT1MNOP45QRS67TUV89WX012",
      "action": "ASSETS_IN",
      "executedAt": "2025-01-15T10:30:00.000+00:00",
      "amount": 50,
      "price": 2000,
      "value": 100000,
      "asset": "ETH"
    }
  ],
  "snapshots": [
    {
      "id": "01JU2ABCD78EFG90HIJ12KL345",
      "createdAt": "2025-04-23T07:57:30.760+00:00",
      "positionsValue": 125430.5,
      "fundingValue": 100000,
      "pnlValue": 25430.5
    },
    {
      "id": "01JU1MNOP56QRS78TUV90WX123",
      "createdAt": "2025-04-22T08:57:32.664+00:00",
      "positionsValue": 121200.75,
      "fundingValue": 100000,
      "pnlValue": 21200.75
    }
  ],
  "comments": [
    {
      "author": "Warren Nakamoto",
      "timestamp": "2026-02-05T11:55:37.383+00:00",
      "content": "Rebalanced staking positions across Lido and Rocket Pool"
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

portfolioId · string · required

A unique identifier for the portfolio. The portfolioId can be obtained from the Lighthouse API keys settings.

strategyId · string · required

The ID of the strategy to retrieve.

Query Parameters

includeComments · boolean · default: false

When set to true, the response will include a comments array (if any comments exist for this strategy).

Response

200 - application/json

Strategy detail response

id · string · required

The unique identifier of the strategy

name · string · required

The name of the strategy

status · enum<string> · required

The current status of the strategy, computed from start and end dates

Available options: PLANNED, ONGOING, COMPLETED

accountingCurrency · enum<string> · required

The accounting currency used for the strategy values

Available options: USD, ETH, BTC

positionsValue · number · required

The current value of the strategy positions in the accounting currency

fundingValue · number · required

The total funding deployed into the strategy in the accounting currency

pnlValue · number · required

The profit and loss of the strategy in the accounting currency

positions · object[] · required

The current positions included in this strategy, resolved from the latest portfolio snapshot

Show child attributes

accounts · object[] · required

The accounts linked to this strategy

Show child attributes

funding · object[] · required

The funding log entries for this strategy, ordered by execution date

Show child attributes

snapshots · object[] · required

Historical snapshot data points for this strategy, ordered by most recent first

Show child attributes

startsAt · string | null

The start date of the strategy in ISO 8601 format

endsAt · string | null

The end date of the strategy in ISO 8601 format

description · string

An optional description of the strategy

comments · object[]

Comments on the strategy, only included when includeComments=true

Show child attributes