Skip to content

Sales Volume History

POST /api/sales/volume/history

Historical time series of transaction volumes.

Example Request

curl --location 'https://ws-osservatorio.realitycs.it/api/sales/volume/history' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
   "ty_zone": "com",
   "id_zone": "100005",
   "window": "1M",
   "contract": 1,
   "year": 2024,
   "month": 12,
   "typology": 4,
   "nation": "IT"
}'

Request Fields

Field Required Default Description Type Example Notes
ty_zone yes Zone type string com
id_zone yes Zone ID string 100005
window yes Time window string 1M
contract yes Contract type number 1
year yes Required year number 2024
month yes Required month number 12
cadastral_typology optional Esatate cadastral typology string A4
nation optional IT Nation code string IT

JSON keys in the response

  • sales_qtraw: NTN (rielab. dati AdE)

Example Response

{
    "_metadata": {
        "message": "",
        "query": {},
        "status": 200,
        "request_id": "4cc03232-7427-4f7e-ae64-762372e9e14b"
    },
    "items": [
        {
            "sales_qtraw": [
                {
                    "month": 6,
                    "qtraw": 6046,
                    "year": 2020
                },
                {
                    "month": 9,
                    "qtraw": 6715,
                    "year": 2020
                },
                {
                    "month": 12,
                    "qtraw": 9226,
                    "year": 2020
                },
                {
                    "month": 3,
                    "qtraw": 7948,
                    "year": 2021
                },
                {
                    "month": 6,
                    "qtraw": 10048,
                    "year": 2021
                },
                {
                    "month": 9,
                    "qtraw": 8213,
                    "year": 2021
                },
                {
                    "month": 12,
                    "qtraw": 10650,
                    "year": 2021
                },
                {
                    "month": 3,
                    "qtraw": 8788,
                    "year": 2022
                },
                {
                    "month": 6,
                    "qtraw": 10181,
                    "year": 2022
                },
                {
                    "month": 9,
                    "qtraw": 8477,
                    "year": 2022
                },
                {
                    "month": 12,
                    "qtraw": 10469,
                    "year": 2022
                },
                {
                    "month": 3,
                    "qtraw": 8034,
                    "year": 2023
                },
                {
                    "month": 6,
                    "qtraw": 8952,
                    "year": 2023
                }
            ]
        }
    ]
}