Back to All

0.12.0 (August 18, 2023)

about 2 months ago by ReadMe API

Add unique tickers for Parcl_ids

We are pleased to introduce unique ticker symbols for certain parcl_ids. The first parcls with tickers are ones in either the Case-Shiller 20 or on the Parcl trading platform. Parcl tickers are in the following format: COUNTRY.REGION.STATE{if below MSA/Region}.LOCATION_ABBREVATION.

For example,

  • the Parcl Labs ticker for Austin city is USA.CITY.TX.ATX
  • the Parcl Labs ticker for New York MSA is USA.MSA.NYC

We are also introducing tickers in collaboration with external media partners. The media ticker will have a slightly different format, .PLABS.REGION.LOCATION_ABBREVIATION. For this ticker, MSA is converted to Metro.

For example,

  • the media ticker for Austin city is .PLABS.CITY.ATX
  • the media ticker for New York MSA is .PLABS.METRO.NYC

Example markets response with tickers for Austin, TX.

    {
        "parcl_id": 5380879,
        "location_type": "CITY",
        "name": "Austin",
        "state": "TX",
        "state_name": "Texas",
        "state_fips_code": "48",
        "census_region": "West South Central",
        "country_code": "USA",
        "tickers": [
            {
                "key": "parcl_labs",
                "symbol": "USA.CITY.TX.ATX"
            },
            {
                "key": "media",
                "symbol": ".PLABS.CITY.ATX"
            }
        ]
    },
	{
        "parcl_id": 2900187,
        "location_type": "MSA",
        "name": "New York",
        "state": "NY",
        "state_name": "New York",
        "state_fips_code": "36",
        "census_region": "Middle Atlantic",
        "country_code": "USA",
        "tickers": [
            {
                "key": "parcl_labs",
                "symbol": "USA.MSA.NYC"
            },
            {
                "key": "media",
                "symbol": ".PLABS.METRO.NYC"
            }
        ]
    }

Add additional search functionality into markets endpoint

We've added additionl search and filter functionality into the markets endpoint. You can now filter by

  • parcl_id - a precise search for one parcl_id
  • location name - a fuzzy search for a location name
  • country_code - a 2 or 3 digit country code to filter for specific countries. Currently USA and FRA are supported
  • ticker - a Boolean that will only return parcl_ids that contain a ticker symbol
  • state - the same functionality as the existing state_abbreviation filter, but in a simpler query key. State_abbreviation is still usable to maintain backward compatibilty.

Additionally, REGION is now a searchable enum in the location_type filter.

Deprecate weather endpoint

The v1/place/:parclId/weather endpoint has been deprecated.