ESG API

The ESG API provides Environmental, Social, and Governance scores for publicly traded companies. These scores are essential for sustainable investing, risk assessment, and corporate responsibility analysis. Each category provides detailed metrics on different aspects of a company's sustainability performance.

GET/esg/:ticker

Retrieves comprehensive ESG (Environmental, Social, and Governance) scores for a specific company. Returns scores for overall ESG performance as well as individual category scores. These metrics are critical for evaluating a company's sustainability practices, social impact, and corporate governance standards.

Path Parameters

Parameter	Type	Required	Description
ticker	string	Required	Stock ticker symbol of the company (e.g., "AAPL", "MSFT", "GOOGL")

Examples:

https://api.axionquant.com/esg/AAPL

https://api.axionquant.com/esg/MSFT

Response Fields

category string

ESG category (e.g., "esg", "environment", "social", "governance", "controversy")

score number

Numerical score on a 0-100 scale (higher is better for ESG categories; for controversy, lower indicates more significant issues)

grade string

Letter grade equivalent (AAA, AA, A, BBB, BB, B, CCC, CC)

id string

Unique identifier for the score record

Scoring System

AAA

90-100

80-89

70-79

BBB

50-69

30-49

20-29

CCC

10-19

0-9

ESG Scores

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4esg_data = client.esg.data('AAPL')
5print(esg_data)

Response

[
  {
    "category": "esg",
    "score": 42.86,
    "grade": "BB",
    "id": "1"
  },
  {
    "category": "social",
    "score": 40,
    "grade": "BB",
    "id": "5"
  },
  {
    "category": "governance",
    "score": 31,
    "grade": "BB",
    "id": "6"
  },
  {
    "category": "controversy",
    "score": 20,
    "grade": "B",
    "id": "3"
  },
  {
    "category": "environment",
    "score": 57,
    "grade": "BBB",
    "id": "4"
  }
]

Sentiment API

The Sentiment API provides comprehensive sentiment analysis across social media, news articles, and analyst reports for public companies. These insights are essential for gauging market sentiment, identifying emerging trends, and understanding public perception of specific stocks.

GET/sentiment/:ticker/all

Retrieves comprehensive sentiment analysis across three key data sources: social media (Google, Twitter, Reddit), financial news, and AI-powered analyst reports. This aggregated view provides a holistic understanding of market sentiment towards a specific company.

Path Parameters

Parameter	Type	Required	Description
ticker	string	Required	Stock ticker symbol (e.g., "AAPL", "TSLA", "MSFT")

Examples:

https://api.axionquant.com/sentiment/AAPL/all

https://api.axionquant.com/sentiment/MSFT/all

Response Fields

socialSentiment

Object containing social media sentiment analysis

label string

Overall sentiment label (POSITIVE/NEGATIVE)

score number

Confidence score (0.0-1.0)

breakdown

Detailed breakdown of positive/negative segments

newsSentiment

Object containing financial news sentiment analysis (same structure as socialSentiment)

analystSentiment

Object containing AI-powered analyst sentiment

sentiment string

Analyst sentiment label (POSITIVE/NEGATIVE)

score number

Confidence score (0.0-1.0)

All Sentiment Data

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4sentiment = client.sentiment.all('AAPL')
5print(sentiment)

Response

{
  "socialSentiment": {
    "label": "NEGATIVE",
    "score": 0.979367434978485,
    "breakdown": {
      "positive": {
        "count": 0,
        "avgScore": 0
      },
      "negative": {
        "count": 100,
        "avgScore": 0.979367434978485
      }
    }
  },
  "newsSentiment": {
    "label": "NEGATIVE",
    "score": 0.952301025390625,
    "breakdown": {
      "positive": {
        "count": 10,
        "avgScore": 0.875148761272431
      },
      "negative": {
        "count": 16,
        "avgScore": 0.952301025390625
      }
    }
  },
  "analystSentiment": {
    "sentiment": "POSITIVE",
    "score": 0.66
  }
}

GET/sentiment/:ticker/analyst

Provides AI-powered sentiment analysis of analyst reports, research notes, and investment recommendations. Offers insights into professional analyst sentiment and forward-looking perspectives on the company.

Path Parameters

Parameter	Type	Required	Description
ticker	string	Required	Stock ticker symbol (e.g., "AAPL", "TSLA", "MSFT")

Examples:

https://api.axionquant.com/sentiment/AAPL/analyst

https://api.axionquant.com/sentiment/MSFT/analyst

Response Fields

sentiment string

Analyst sentiment label (POSITIVE/NEGATIVE)

score number

Confidence score (0.0-1.0)

Analyst Sentiment

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4sentiment = client.sentiment.analyst('AAPL')
5print(sentiment)

Response

{
  "sentiment": "NEGATIVE",
  "score": 0.31
}