{"id":9979,"library":"nominal-api","title":"Nominal API Python Client","description":"The official Python client for the Nominal API, providing programmatic access to financial time-series data, including inflation, economic indicators, and asset prices. The library is actively maintained and frequently updated, often releasing new versions with minor bug fixes and feature enhancements, though breaking changes can occur in pre-1.0 releases.","status":"active","version":"0.1198.0","language":"python","source_language":"en","source_url":"https://github.com/nominal-api/nominal-api-python","tags":["api-client","financial-data","time-series","economics"],"install":[{"cmd":"pip install nominal-api","lang":"bash","label":"Install latest version"}],"dependencies":[{"reason":"Used internally for making HTTP requests to the Nominal API.","package":"requests","optional":false}],"imports":[{"wrong":"from nominal_api import NominalAPIClient","symbol":"NominalAPIClient","correct":"from nominal_api import NominalAPIClient"}],"quickstart":{"code":"import os\nfrom nominal import NominalAPIClient\n\napi_key = os.environ.get('NOMINAL_API_KEY', 'YOUR_NOMINAL_API_KEY_HERE')\n\nif api_key == 'YOUR_NOMINAL_API_KEY_HERE':\n    print(\"Please set the NOMINAL_API_KEY environment variable or replace 'YOUR_NOMINAL_API_KEY_HERE' with your actual key.\")\nelse:\n    try:\n        client = NominalAPIClient(api_key=api_key)\n        # Fetch CPI data for USD between specified dates\n        timeseries_data = client.get_timeseries(\"USD.CPI\", \"2020-01-01\", \"2020-12-31\")\n        print(\"Successfully fetched data:\")\n        print(f\"First entry: {timeseries_data[0]}\")\n        print(f\"Last entry: {timeseries_data[-1]}\")\n    except Exception as e:\n        print(f\"An error occurred: {e}\")","lang":"python","description":"Initialize the NominalAPIClient with your API key and fetch time-series data. This example retrieves CPI data for USD for the year 2020. Ensure your API key is configured either as an environment variable or directly in the code."},"warnings":[{"fix":"Update your import statement from `from nominal import NominalClient` to `from nominal import NominalAPIClient` and all instantiations.","message":"The main client class name changed from `NominalClient` to `NominalAPIClient`.","severity":"breaking","affected_versions":">=0.1170.0"},{"fix":"Convert any `datetime` objects passed as `start` or `end` parameters to strings using `date_object.strftime('%Y-%m-%d')`.","message":"Date parameters for `get_timeseries` and similar methods now require string formats ('YYYY-MM-DD') instead of `datetime` objects.","severity":"breaking","affected_versions":">=0.1187.0"},{"fix":"Always pin your `nominal-api` version in production environments (`nominal-api==X.Y.Z`) and test thoroughly when upgrading to a new version.","message":"The library is still in a pre-1.0 major version (0.x.x), meaning backward-incompatible changes can be introduced in minor or patch releases.","severity":"gotcha","affected_versions":"<1.0.0"},{"fix":"Always load your `NOMINAL_API_KEY` from environment variables, a secure vault, or a configuration file that is not committed to source control.","message":"API keys are sensitive. Exposing them in source control or public environments is a security risk.","severity":"gotcha","affected_versions":"All"}],"env_vars":null,"search_vec":"'-1.0':55 'access':15 'activ':32 'api':2,12,58 'api-cli':57 'asset':27 'break':49 'bug':43 'chang':50 'client':4,8,59 'data':21,62 'econom':24,66 'enhanc':47 'featur':46 'financi':17,61 'financial-data':60 'fix':44 'frequent':35 'includ':22 'indic':25 'inflat':23 'librari':30 'maintain':33 'minor':42 'new':39 'nomin':1,11 'occur':52 'offici':6 'often':37 'pre':54 'price':28 'programmat':14 'provid':13 'python':3,7 'releas':38,56 'seri':20,65 'though':48 'time':19,64 'time-seri':18,63 'updat':36 'version':40","created_at":"2026-04-17T01:21:45.499493+00:00","updated_at":"2026-04-17T01:21:45.499493+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'NominalAPIClient' from 'nominal_api' (/tmp/tmpqlslg9mo/venv/lib/python3.12/site-packages/nominal_api/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"0.1274.0","cli_name":"","cli_version":null,"type":"library","homepage":"https://nominalapi.com","github":null,"docs":null,"changelog":null,"pypi":"https://pypi.org/project/nominal-api/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["payments","data","http-networking","serialization"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}