Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Dataset: DOF Rolling Sales

Jump to bottom
Maxwell Austensen edited this page Dec 17, 2022 · 1 revision

dof_sales

The dof_sales dataset can be added to NYCDB by running:

> nycdb --download dof_sales
> nycdb --load dof_sales

Provenance

The dataset comes from the NYC Open Data portal:

Context

Every property sale transaction is published by the Department of Finance. Each transaction includes address information, borough, block, and lot numbers, as well as sale price and date of sale.

The dataset is released on a 12-month rolling basis and published every couple months. A final set of sales data is published at the end of the calendar year, and archived in the DOF website.

The sales data published on the website goes back to 2003, and is divided by borough. dof_sales joins all these individual excel files.

Data dictionary

You can see the data dictionary for each field on the NYC website.

Click to Expand the dof_sales Data Dictionary
column_name data_type description
Borough char(1) The name of the borough in which the property is located.
Neighborhood text Department of Finance assessors determine the neighborhood name in the course of valuing properties. The common name of the neighborhood is generally the same as the name Finance designates. However, there may be slight differences in neighborhood boundary lines and some sub-neighborhoods may not be included.
BuildingClassCategory text This is a field that we are including so that users of the Rolling Sales Files can easily identify similar properties by broad usage (e.g. One Family Homes) without looking up individual Building Classes. Files are sorted by Borough, Neighborhood, Building Class Category, Block and Lot.
TaxClassAtPresent text Tax class (1, 2, 3, or 4) at present
Block char(5) A Tax Block is a sub-division of the borough on which real properties are located. The Department of Finance uses a Borough-Block-Lot classification to label all real property in the City. “Whereas” addresses describe the street location of a property, the block and lot distinguishes one unit of real property from another, such as the different condominiums in a single building. Also, block and lots are not subject to name changes based on which side of the parcel the building puts its entrance on.
Lot char(4) A Tax Lot is a subdivision of a Tax Block and represents the property unique location.
EaseMent text An easement is a right, such as a right of way, which allows an entity to make limited use of another’s real property. For example: MTA railroad tracks that run across a portion of another property.
BuildingClassAtPresent text The Building Classification is used to describe a property’s constructive use. The first position of the Building Class is a letter that is used to describe a general class of properties (for example “A” signifies one-family homes, “O” signifies office buildings. “R” signifies condominiums). The second position, a number, adds more specific information about the property’s use or construction style (using our previous examples “A0” is a Cape Cod style one family home, “O4” is a tower type office building and “R5” is a commercial condominium unit). The term Building Class used by the Department of Finance is interchangeable with the term Building Code used by the Department of Buildings. See NYC Building Classifications.
Address text The street address of the property as listed on the Sales File. Coop sales include the apartment number in the address field.
ApartmentNumber text The apartment unit, if there is one.
ZipCode char(5) The property’s postal code.
ResidentialUnits integer The number of residential units at the listed property.
CommercialUnits integer The number of commercial units at the listed property.
TotalUnits integer The total number of units at the listed property.
LandSquareFeet integer The land area of the property listed in square feet.
GrossSquareFeet integer The total area of all the floors of a building as measured from the exterior surfaces of the outside walls of the building, including the land area and space within any building or structure on the property.
YearBuilt integer Year the structure on the property was built.
TaxClassAtTimeOfSale text Tax class at time of sale
BuildingClassAtTimeOfSale text Building class at time of sale. The Building Classification is used to describe a property’s constructive use. The first position of the Building Class is a letter that is used to describe a general class of properties (for example “A” signifies one-family homes, “O” signifies office buildings. “R” signifies condominiums). The second position, a number, adds more specific information about the property’s use or construction style (using our previous examples “A0” is a Cape Cod style one family home, “O4” is a tower type office building and “R5” is a commercial condominium unit). The term Building Class as used by the Department of Finance is interchangeable with the term Building Code as used by the Department of Buildings.
SalePrice bigint Price paid for the property.
SaleDate date Date the property sold.
bbl char(10) A combination of three numeric codes--a 1-digit borough number, a block number (up to 5 digits) and a lot number (up to 4 digits)--designated and modified by the Department of Finance (DOF). BBLs are used by various city agencies to identify real estate for taxes, zoning, construction, and other purposes.
id 'serial PRIMARY KEY' Unique id number assigned to transaction.

Tables

This dataset has the following tables:

  • dof_sales is the only table in this dataset and contains sale price and date for a given property/unit.

Example queries

Following are some useful SQL queries related to the dataset.

Obtaining all sales within a zip code

SELECT saleprice FROM dof_sales WHERE zipcode = '10121';

Known Issues and Data Pitfalls

  • address fields (house number, street, etc) may not be accurate as they are input manually from the original source
  • attempts to clean fields may result in inaccuracies

Clone this wiki locally