# USCPI

## **Synthetic Asset Description** 

A synthetic asset that tracks the latest price for the U.S. Consumer Price index for All Urban Consumers: All Items in U.S. City Average.

**Display Name:** U.S. Consumer Price Index for All Urban Consumers: All Items in U.S. City Average\
**Symbol:** USCPI\
**EMP Price Identifier:** Numerical\
**Market:** Published by <https://www.bls.gov/>\
**Data Update Frequency:** Monthly\
**Price Feed Source:** <https://fred.stlouisfed.org/docs/api/fred/>\
**Data Providers:**

* **Real-time or latest price:** Use the chart provided by this link <https://fred.stlouisfed.org/series/CPIAUCSL>
* **Historical data:** Configure the following URL by inputting values for 'api\_key=' and 'observation\_start=':
  * <https://api.stlouisfed.org/fred/series/observations?series_id=CPIAUCSL&api_key=API-KEY-VALUE&file_type=json&observation_start=YYYY-MM-DD>

### Manual Price Calculation&#x20;

To determine the monthly price for USCPI for the given month of a request timestamp, voters must do the following:

1. Get the request timestamp.
2. Convert the timestamp to UTC time.
3. Get the exact date/month/year.
4. Go to <https://fred.stlouisfed.org/docs/api/fred/series_observations.html>
5. Acquire an API key.
6. Using the following URL, enter the required values for 'api\_key=' and 'observation\_start=':
   * <https://api.stlouisfed.org/fred/series/observations?series_id=CPIAUCSL&api_key=API-KEY-VALUE&file_type=json&observation_start=YYYY-MM-DD>
7. Paste the configured URL into your browser's search bar.
8. Retrieve the CPI Price from the response JSON. The correct CPI price for a given date will be located beside the “value” keyword within the response JSON.

**Example response object**

{% code overflow="wrap" %}

```http
{"realtime_start":"2023-03-06","realtime_end":"2023-03-06","observation_start":"2022-12-22","observation_end":"9999-12-31","units":"lin","output_type":1,"file_type":"json","order_by":"observation_date","sort_order":"asc","count":2,"offset":0,"limit":100000,"observations":[{"realtime_start":"2023-03-06","realtime_end":"2023-03-06","date":"2022-12-01","value":"298.990"},{"realtime_start":"2023-03-06","realtime_end":"2023-03-06","date":"2023-01-01","value":"300.536"}]}
```

{% endcode %}