ams-sdk 1.0.5

Python SDK for the Alternative Macro Signals API

AMS-SDK

Python SDK for the Alternative Macro Signals (AMS) API, providing a convenient interface for authenticating and querying endpoints.

Please refer to the AMS API documentation for a detailed description of the API endpoints, including parameters specification.

---

Features ✨

• Easy Queries: Query from all AMS API endpoints in two lines of Python code

• Authentication: SDK takes care of the full authentication process, with just your API key required (given by AMS)

---

Installation 🛠️

Recommended:

pip install ams-sdk

Alternatively, from repo:

pip install git+https://github.com/alternative-macro-signals/ams-sdk.git

---

Requirements 📋

The following dependencies are necessary to use this SDK:

• Python 3.7 or higher (likely to work with 3+ but not tested)
• requests>=2.0.0 (installed automatically if needed)

---

Usage 📖

Initialization

First, initialize the AMSClient with the service URL and API key provided by AMS.

from ams_sdk.client import AMSClient

client = AMSClient(service_url=SERVICE_URL, api_key=API_KEY)

Authentication

Call the authenticate() method to fetch the bearer token required for further requests:

client.authenticate()

Querying Endpoints

Use the query_endpoint method to query specific AMS API endpoints:

result = client.query_endpoint("/nbstat", params={
 "location": "Japan",
 "txt": "rice",
 "start": "2021-01-01"
})
print(result)

Output

Transfer the nbstat output in a Pandas dataframe:

import pandas as pd
df = pd.DataFrame(result.get('content'))
df['date'] = pd.to_datetime(df['date'])
df = df.set_index('date')
df.sort_index(inplace=True)

---

API endpoints callable from AMSClient 🌐

/nbstat

Retrieve Inflation News Balance and News Volumes associated with specific text queries.

/nipi

Download NIPI data (meanwhile possible from the NIPI app or our CSV files endpoints)

/inb

Inflation NewsBot daily lists (meanwhile possible through dedicated JSON endpoints).

---

We welcome suggestions! 💡

📧: [e-mail]

---

Project Structure 📂

• client.py: Contains the AMSClient class which offers the core functionality for interacting with the API.
• utils.py: AMSClient usage examples.
• setup.py: Handles package configuration and installation details.
• README.md: Documentation for the ams-sdk.

---

License 📜

This project is licensed under the MIT License. See the LICENSE file for details.

---

Author

• Author: Laurent Bilke - [e-mail]
• Repository: GitHub

---

© 2025 Alternative Macro Signals. All rights reserved. https://alt.ms