Holdings

You need to pass authorization header to consume APIs on this page

Sample CURL request

curl -X GET \
  'http://45.55.149.131:8002/api/v1.0/holdings?ticker=IBB&count=20&offset=0' \
  -H 'token: 123dummytoken'

Get all holdings for a given CompositeTicker in the decreasing order of their weights.

Request:
GET /api/v1.0/holdings?ticker=IVV&count=2&offset=10


Response:

{
  "data": {
    "CompositeName": "iShares Core S&P 500 ETF",
    "CompositeTicker": "IVV",
    "Date": "20170328",
    "ETFType": "US Equities",
    "LeverageRatio": "",
    "constituents": [
      {
        "BBGIDComposite": "BBG000BK6PH2",
        "BloombergSymbol": "",
        "CUSIP": "",
        "ConstituentName": "GENERAL ELECTRIC CO",
        "ConstituentTicker": "GE",
        "ConstituentType": "EQUI",
        "ContractExpiryDate": "",
        "Coupon": "",
        "Currency": "",
        "Face": "",
        "ISIN": "US3696041033",
        "ISOMarketIdentifierCode": "",
        "Identifier": "2380498",
        "IdentifierType": "SEDOL",
        "IndexProviderCode": "",
        "IndustryGroup": "",
        "Location": "US",
        "MarketValueHeld": "1293163378",
        "Maturity": "",
        "NotionalValue": "1293163377.86",
        "QuantityHeld": "43658453",
        "QuantityPerShare": "",
        "QuantityUnits": "",
        "RIC": "",
        "SEDOL": "2380498",
        "Weighting": "0.012742"
      },
      {
        "BBGIDComposite": "BBG000BSJLV4",
        "BloombergSymbol": "",
        "CUSIP": "",
        "ConstituentName": "AT&T INC",
        "ConstituentTicker": "T",
        "ConstituentType": "EQUI",
        "ContractExpiryDate": "",
        "Coupon": "",
        "Currency": "",
        "Face": "",
        "ISIN": "US00206R1023",
        "ISOMarketIdentifierCode": "",
        "Identifier": "2831811",
        "IdentifierType": "SEDOL",
        "IndexProviderCode": "",
        "IndustryGroup": "",
        "Location": "US",
        "MarketValueHeld": "1277228362",
        "Maturity": "",
        "NotionalValue": "1277228361.80",
        "QuantityHeld": "30732155",
        "QuantityPerShare": "",
        "QuantityUnits": "",
        "RIC": "",
        "SEDOL": "2831811",
        "Weighting": "0.012585"
      }
    ]
  },
  "message": null,
  "status": true
}

Default and max value for count is 1000.

Default value for offset is 0.

The user can use a combination of count and offset to implement a pagination-like behavior for any downstream system.

Get all CompositeTickers which contain a given ConstituentTicker as its Constituent (Reverse Lookup).

Request:
GET /api/v1.0/constituent/in?ticker=z
 
 
Response:
{
    "data": [
        {
            "CompositeName": "Fidelity NASDAQ Composite Index Tracking Stock ETF",
            "CompositeTicker": "ONEQ",
            "ConstituentName": "Zillow Group Inc",
            "ETFType": "US Equities",
            "Location": "US",
            "Sponsor": "Fidelity",
            "Weighting": "0.0004"
        },
        {
            "CompositeName": "Fidelity MSCI Information Technology Index ETF",
            "CompositeTicker": "FTEC",
            "ConstituentName": "Zillow Group Inc",
            "ETFType": "US Equities",
            "Location": "US",
            "Sponsor": "Fidelity",
            "Weighting": "0.0007"
        }
    ],
    "message": null,
    "status": true
}