Export tonal sentiment to csv. Each fetch returns max 1000 rows, so to fetch all of the data paging is required. Use the size and from_index parameters to iterate through the result set.

GET /events-v2/tonal/export/csv

Parameter	Type	DataType	Description
size	query	integer	How many lines of the csv to return - max 1000
bloomberg_ticker	query	string	Filter events to 1+ bloomberg tickers (comma-separated)
isin	query	string	Filter events to 1+ ISINs (comma-separated)
permid	query	string	Filter events to 1+ PermIDs (comma-separated)
ric	query	string	Filter events to 1+ Reuters/Refinitiv RICs (comma-separated)
ticker	query	string	Filter events to 1+ tickers (comma-separated)
from_index	query	integer	The index to start from, for paging
watchlist_id	query	integer	Filter results by a specific watchlist

Response Format

Event Level Data

Name	Type	Description
isin	string	ISIN identifier
gics_sub_sector	string	Equity subsector
gics_sector	string	Equity sector
event_type	string	Type of event (e.g. earnings)
event_topic_ids	list[int]	Topic ids
title	string	Event title
ticker	string	Bloomberg ticker
event_date	date	Date of event
event_topics	list[string]	Topics
event_id	int	Event identifier
created_time	date	Date of analysis

Statement Level Data

Name	Type	Description
statement	string	Statement text (representative - may not include full text)
tonal_sentiment	float	Value of tonal sentiment for this statement
topic_ids	list[number]	Topic ids
statement_id	int	Identifier for the specific statement in the event
topics	list[string]	Topics
speaker_id	int	Speaker ID
timestamp	int	Timestamp of the statement in the event
speaker_name	string	Speaker name
text_sentiment	float	Value of textual sentiment for the statement

Response

event_id,title,call_date,call_type,local_ticker,isin,gics_sector,gics_sub_sector,created_time,event_topic_ids,event_topics,statement_id,speaker_name,statement,start_ms,topic_ids,topics,tonal_sentiment_score,text_sentiment_score
1957675,Q4 2021 Golub Capital BDC Inc Earnings Call,2021-11-30T13:00:00-05:00,earnings,GBDC,US38173M1027,Financials,Asset Management & Custody Banks,2021-11-30T18:03:01-05:00,"['914', '11', '233111', '167749', '61', '53171897', '12824', '17861561', '191165']","['NII', 'COVID', 'Events Presentations', 'Merger', 'Supply Chain', 'SBIC VI', '85X', 'Prequin', 'Barley']",1518034,David B. Golub,"Honestly, we don't really think about those 2 as related. And I think it's premature to be looking at the spreads from calendar Q3 and thinking that, that represents a meaningful change from prior periods. My sense is that spreads are reasonably stable, and this is more a mix issue than a spread issue. So I do think it makes sense. And we talked about it in our prepared remarks. I do think it makes sense for GBDC to take on some more assets. We're now running at a 1:1 debt-to-equity ratio. I think that's lighter than optimal. And I think when we do that, we'll be very much in the catch-up, which I like to be in because it provides a lot of safety around dividend coverage of the -- of NII per share. So I think we're in very good shape on where we're headed from a leverage standpoint, a bit higher than the 1:1 that we're at right now, but not too much higher. And I think that puts us in a very good position from an ROE and a return on net investment income standpoint.",2273849,['914'],['NII'],-1.0844,0.2842

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/events/tonal/export/csv' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.get("https://premium.aiera.com/api/events/tonal/export/csv", headers={"X-API-Key": "xxx"})