Analytics

Fetch analytics data

post

The analytics endpoint returns all analytical data for an entity, position, transaction or asset. This includes market values, exposures, risk, performance, and other metrics.

Authorizations

Query parameters

requestPageSizeinteger · int32 · max: 10000Optional

Number of records per page

Default: 1000

pageTokenstringOptional

Token used for pagination. For the first page, this should not be provided. For subsequent pages, use the nextPageToken value returned in the previous response

Body

Request body for analytics data

idsinteger · int64[]Required

List of entity ids to fetch

Example: [1,2,3]

consolidationTypestring · enumRequired

DIRECT returns the entity's directly held assets. LOOK_THROUGH includes transactions of underlying entities linked through configured look-through relationships. If not provided, DIRECT is used

Default: DIRECTExample: DIRECTPossible values:

sincestring · dateRequired

Start date for the data to fetch

Default: 2000-01-01Example: 2025-09-30

untilstring · nullableOptional

End date for the data to fetch. If not provided, latest published date is used

Example: 2025-12-31

Responses

200

List of data with selected fields

application/json

Analytics data returned by the API

401

Unauthorized, missing or invalid authentication

403

Forbidden, user does not have permission

post/api/v2/analytics

POST /api/v2/analytics HTTP/1.1
Host: data.api.landytech.net
Content-Type: application/json
Accept: */*
Content-Length: 627

{
  "fields": [
    {
      "code": "ENTITY.ID"
    },
    {
      "code": "ENTITY.NAME"
    },
    {
      "code": "POSITION.DATE"
    },
    {
      "code": "ASSET.NAME"
    },
    {
      "code": "ASSET.TYPE"
    },
    {
      "code": "POSITION.CUSTODIAN_NAME"
    },
    {
      "code": "ENTITY.REPORTING_CURRENCY"
    },
    {
      "code": "POSITION.MARKET_VALUE_REPORTING"
    },
    {
      "name": "YTD Return",
      "code": "POSITION.RETURN",
      "parameters": {
        "period": "YTD"
      }
    },
    {
      "name": "1D VaR MC 95",
      "code": "POSITION.RISK",
      "parameters": {
        "risk_measure_id": 250
      }
    },
    {
      "name": "Lehman Crisis (2008)",
      "code": "POSITION.RISK",
      "parameters": {
        "risk_measure_id": 522
      }
    }
  ],
  "ids": [
    1,
    2,
    3
  ],
  "consolidationType": "DIRECT",
  "since": "2025-09-30",
  "until": "2025-12-31",
  "sort": {
    "name": "POSITION.DATE",
    "ascending": true
  }
}

{
  "data": {
    "ENTITY.ID": 10338,
    "ENTITY.NAME": "Barclays *899",
    "ENTITY.TYPE": "PORTFOLIO",
    "ENTITY.PORTFOLIO_PARENT_ENTITY_ID": 10337,
    "ENTITY.REPORTING_CURRENCY": "EUR",
    "ASSET.NAME": "Hurricane Energy PLC",
    "ASSET.ID": 1990,
    "ASSET.TYPE": "Common Stock",
    "TRANSACTION.SUBTYPE": "Purchase",
    "TRANSACTION.CUSTODIAN_TRANSACTION_ID": "1ab7d9fc-427f-42bf-97a8-1a8ff531efe4",
    "TRANSACTION.DESCRIPTION": "Purchase 9000 Hurricane Energy PLC 20251111",
    "TRANSACTION.DATE": "2025-11-11",
    "TRANSACTION.SETTLEMENT_DATE": "2025-11-13",
    "TRANSACTION.MOVEMENT_LOCAL": -350000,
    "TRANSACTION.GROSS_MOVEMENT_LOCAL": -346500,
    "TRANSACTION.QUANTITY": 9000,
    "TRANSACTION.NET_UNIT_PRICE_LOCAL": 38.888889,
    "TRANSACTION.GROSS_UNIT_PRICE_LOCAL": 38.5,
    "TRANSACTION.LOCAL_CURRENCY": "GBP",
    "TRANSACTION.LOCAL_CURRENCY2": "CAD",
    "TRANSACTION.MOVEMENT_REPORTING": -291666.6667,
    "TRANSACTION.GROSS_MOVEMENT_REPORTING": -288750,
    "TRANSACTION.GRANULARITY": {
      "COMMISSIONS_LOCAL": -1500,
      "STAMP_DUTY_LOCAL": -1000,
      "WITHHOLDING_TAX_LOCAL": -300,
      "COLLECTION_CHARGE_LOCAL": -200,
      "TAX_LOCAL": -500,
      "ACCRUED_INTEREST_LOCAL": 0
    },
    "TRANSACTION.PRIVATE_FUND_GRANULARITY": {
      "PE_DEDUCTIBLE": -90000,
      "PE_NON_DEDUCTIBLE": -10000,
      "PE_INVESTMENT": -90000,
      "PE_MANAGEMENT_FEES": -2000,
      "PE_FUND_EXPENSES": -3000,
      "PE_OTHER_FEES": -5000,
      "PE_EQUALISATION": 0,
      "PE_RECALLABLE": 10000,
      "PE_NON_RECALLABLE": 95000,
      "PE_CAPITAL_RETURN": 10000,
      "PE_CAPITAL_GAIN": 90000,
      "PE_INCOME": 5000
    },
    "TRANSACTION.REVERSAL": 0,
    "TRANSACTION.CUSTODIAN_REVERSED_TRANSACTION_ID": "abcdef12-3456-7890-abcd-ef1234567890",
    "POSITION.DATE": "2025-11-13",
    "POSITION.QUANTITY": 9000,
    "POSITION.MARKET_VALUE_LOCAL": 360000,
    "POSITION.UNIT_PRICE_LOCAL": 40,
    "POSITION.LOCAL_CURRENCY": "GBP",
    "POSITION.COST_VALUE_REPORTING": 263721.3762,
    "POSITION.AVERAGE_UNIT_COST_PRICE_LOCAL": 635.21,
    "POSITION.VWAP": 283.45,
    "ENTITY.RETURN": 0.003312,
    "POSITION.RETURN": 0.003312,
    "ENTITY.EXPOSURE": 1.001916,
    "POSITION.EXPOSURE": 1.001916,
    "POSITION.AGGREGATED_PNL": -73.942712,
    "ENTITY.PNL": 0.0156,
    "POSITION.MARKET_VALUE_NOTIONAL_REPORTING": 7068.854036,
    "ENTITY.CUMULATIVE_PERFORMANCE": 75.385618,
    "ASSET.CUMULATIVE_PERFORMANCE": 75.385618,
    "ENTITY.RISK": 173.456,
    "POSITION.RISK": 173.456
  },
  "pagination": {
    "nextPageToken": null,
    "hasNextPage": 0,
    "pageSize": 1000
  },
  "meta": {
    "requestId": "07f7230a-ad15-4cb6-8592-31ed9b1e880d",
    "responseType": "json"
  }
}