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"
  }
]

Analysts - Sentiment API

GET/sentiment/:ticker/analyst

Provides 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
}

Journalists - Sentiment API

GET/sentiment/:ticker/news

Analyzes sentiment from financial news articles and press releases. Provides insights into how traditional media is covering the company, including earnings reports, product announcements, and corporate developments.

Path Parameters

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

Examples:

https://api.axionquant.com/sentiment/TSLA/news

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

Response Fields

Same structure as Social Media Sentiment response.

label string

Overall sentiment label (POSITIVE/NEGATIVE)

score number

Confidence score (0.0-1.0)

breakdown

Breakdown of positive/negative segments with counts and average scores

News Sentiment

Request

Sample code

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

Response

{
  "label": "NEGATIVE",
  "score": 0.982357367873192,
  "breakdown": {
    "positive": {
      "count": 231,
      "avgScore": 0.903340172767639
    },
    "negative": {
      "count": 1292,
      "avgScore": 0.982357367873192
    }
  }
}