Holdings

Get a list of all holdings

Changed on

Retrieves a list of all holdings that the user has permission to view.

get/holding

Request

  • Base URL
    https://api.treasuryspring.com/api/v1
  • Auth
    HTTP bearer

Query parameters

entity_codestring nullable

Parameter to filter holdings by entity code

min_subscription_datestring date nullable

Parameter to filter holdings by minimum subscription date

max_subscription_datestring date nullable

Parameter to filter holdings by maximum subscription date

min_maturity_datestring date nullable

Parameter to filter holdings by minimum maturity date

max_maturity_datestring date nullable

Parameter to filter holdings by maximum maturity date

min_modified_datestring date nullable

Parameter to filter holdings by modification date

include_zero_cashboolean

Also return Cash holdings with a zero balance, at cost: 0. By default a Cash holding is left out while its balance is zero.

limitinteger

Page size used for pagination

offsetinteger

Offset used for pagination

Response

List of holdings

valueDatestring date required

Date of the response (London timezone)

Example response

{
  "holdings": [
    {
      "calendars": [
        "TreasurySpring",
        "United Kingdom"
      ],
      "cellCode": "Example-IC",
      "cost": 5000,
      "currency": "GBP",
      "cutoffDatetime": "2024-04-15T12:15:00",
      "entityCode": "TEST0001",
      "extendedMaturityDate": "2025-01-01",
      "extensionDays": 30,
      "extensionOptionDate": "2025-01-01",
      "extensionStartDate": "2025-01-01",
      "extensionStartValue": 5000,
      "finalDays": 90,
      "finalized": true,
      "isOnBalanceSheet": true,
      "issueDate": "2024-01-01",
      "maturityActions": [
        {
          "amount": 5000,
          "currency": "GBP",
          "holdingUid": "74628ebad0f54881b3c76acf146eb3c3",
          "subscriptionUid": "dade0389c66241bd8366b017f1ffe19a",
          "type": "ROLL",
          "uid": "96cd54e5ddfd41b0a77afef15a96660d"
        }
      ],
      "maturityDate": "2025-01-01",
      "maturityValue": 7000,
      "mmyA360F": 5.42,
      "mmyA365F": 5.5,
      "name": "TreasurySpring Bluebird-IC GBP-BACR-1M/TEST0001/2024-5-14/2024-6-14",
      "nextFinalYield": 5.5,
      "nextYield": 5.5,
      "noticeDate": "2024-12-31",
      "obligorExposureCode": "BACR[GC]",
      "obligorExposureName": "Barclays Bank Plc [Gov secured]",
      "pricePerShare": 10,
      "productCode": "GBP-BACR[GC]-3M",
      "selectableNextDatetime": "2024-12-30T09:00:00",
      "subscriptionUid": "dade0389c66241bd8366b017f1ffe19a",
      "type": "Fixed",
      "uid": "c660adab8e394383a3f839dd9d66bf9e",
      "value": 6000,
      "yield": 5
    }
  ],
  "pageInfo": {
    "hasNextPage": true,
    "limit": 100,
    "totalCount": 200
  },
  "valueDate": "2025-01-01"
}

Changes