API Documentation

___________________________________________________________________

Getting Started Updated 2022, Feb

We are the most accurate financial news data API out there.

We provide real time financial news from Twitter, Crawler & RedboxGlobal.

Attribution is required for all users. It is as simple putting “News Data provided by RedboxGlobal” somewhere on
your site or app and linking that text to https://redboxglobal.com.

As a warranty in RedboxGlobal Publishing Agreement you make with us, you must obtain the necessary permission
to include material in your application, software or website.

RedboxGlobal will be responsible for any patent infringement and copyright infringement raised by any third party.
RedboxGlobal will be solely responsible for any legal disputes; neither vendors nor client will be responsible for the
same.

Important Points!

Base URL

https://apidata.redboxglobal.com/api/<region>/<token>

Headers

It is required to set Header for each request. It helps us to determine your personal environment. No
headless request will be accepted and it will be blocked by server after certain rate limits.

Polling

RedboxGlobal Feeds Polling Frequency: 5 Seconds | Crawler Feeds: 5 Minutes | Twitter Feeds: 20
Seconds | All News: 10 Seconds | Stock Tickers: 10 Seconds.

Data Consume

Your client will poll to your servers. Your client should not poll directly or indirectly to our servers.
Token will be blacklisted for violating regulations.
REDBOXGLOBAL FEEDS
RedboxGlobal News by our analysts JSON

https://apidata.redboxglobal.com/api/global/redboglobal/YOUR_API_KEY

RESPONSE

https://apidata.redboxglobal.com/api/global/redboglobal/YOUR_API_KEY

[{"_id":"62035beded35de4862a8f20b",

"type":"RedboxGlobal",

"category":"Global",

"description":"BELLWAY PLC: CITIGROUP RAISES PRICE TARGET TO 4176P FROM 4153P",

"company":[{"_id":"620140108969c7fddea5bc28",

"symbol":"C",

"name":"Citigroup Inc. Common Stock",

"exchangeShortName":0}],

"createdAt":"2022-02-09T06:15:09.290Z"}

Reference:-

type: This field indicates source of news

1) RedboxGlobal
2) Crawler
3) Twitter

category: This field indicates categories

1) Global
2) Commodities
3) Fixed Income
4) Block Details (Rename to Analysis from your end)
5) Default
description: This field shows headlines

company: This field stores company name (max 3 companies)

symbol: This field stores companies stock exchanges symbol

exchangeShortName: Please ignore this field.

createdAt: This field stores data arrival date with time

Note:-

Equities news will be in “Global” and ‘Default’ categories.

Geopolitical news will be in “Global” categories.

Metals, Gold, Grains, Oil, Energy News will be in “commodities” categories.

Currencies, Crypto, Bonds, Central Banks, Finance Ministry, Live Press Conference from Ministry of
Finance, Central Banks will be in “Fixed Income” categories.

STREAMING

const io = require(“socket.io-client”);

var socket =io (“https://apidata.redboxglobal.com/api/socket”, {

query: {

token:

“Your_Token_Here”,

},

});

Socket Listener

socket.on ("newGlobalRedboxFeed", (data) => {

console.log (data);

});
 socket.on ("disconnect", () => {

console.log ("listening stopped...");

});

Same response will be printed.

Note:- You will get JavaScript Software development Kit for the streaming APIs.

Prerequiresite for the streaming APIs

1) LTS Nodejs with latest LTS NPM

2) Socket.io client

Steps to run Streaming APIs

Navigate “RedboxGlobal” folder on your console terminal

1) npm install
2) Now edit app.js file paste your token at “paste_token_here_” save the file.
3) Now run in your cmd or terminal window following command
4) node app
5) There would be no handshake or connection establish message due to security reasons.
6) As soon as the data will arrive it will get started to print on your console terminal.
7) All response will be similar to the “REST”.

CRAWLER FEEDS

Crawler Feeds from Multiple Sources Clickable News JSON

https://apidata.redboxglobal.com/api/global/crawler/YOUR_API_KEY

{"_id":"62038743ed35de4862a8f7c9",

"type":"Crawler",

"category":"Default",

"article":{"title":"Toyota Motor's third-quarter net profit falls 5.6% as parts shortage hurts sales - Fox
Business",
"link":"https://www.foxbusiness.com/markets/toyota-motors-third-quarter-net-profit-falls-5-6-as-parts-
shortage-hurts-sales"},

"sentiment":{"score":-2},

"company":[{"_id":"620140108969c7fddea5c1f2",

"symbol":"TM",

"name":"Toyota Motor Corporation Common Stock",

"exchangeShortName":0}],

"createdAt":"2022-02-09T09:19:59.747Z"},

Reference:-

type: This field indicates source of news

1) RedboxGlobal
2) Crawler
3) Twitter

category: This field indicates categories

1) Global
2) Commodities
3) Fixed Income
4) Block Details (Rename to Analysis from your end)
5) Default

article: This field shows headlines

link: This field stores article links

sentiment: This field shows News sentiment if integer in “–“ news is negative, 1, 2, 3 shows news is
positive if 0 news is neutral.

company: This field stores company name with stock symbol (max 3 companies)

symbol: This field stores companies stock exchanges symbol

exchangeShortName: Please ignore this field.

createdAt: This field stores data arrival date with time

Note:-

Equities news will be in “Global” and ‘Default’ categories.

Geopolitical news will be in “Global” categories.

Metals, Gold, Grains, Oil, Energy News will be in “commodities” categories.

Currencies, Crypto, Bonds, Central Banks, Finance Ministry, Live Press Conference from Ministry of
Finance, Central Banks will be in “Fixed Income” categories.

STREAMING

const io = require(“socket.io-client”);

var socket =io (“https://apidata.redboxglbal.com/api/socket”, {

query: {

token:

“Your_Token_Here”,

},

});

Socket Listener

socket.on ("newGlobalCrawlerFeed", (data) => {

console.log (data);

});

socket.on ("disconnect", () => {

console.log ("listening stopped...");

});

Same response will be printed.

Note:- You will get JavaScript Software development Kit for the streaming APIs.

Prerequiresite for the streaming APIs

 1) LTS Nodejs with latest LTS NPM
2) Socket.io client

Steps to run Streaming APIs

Navigate “RedboxGlobal” folder on your console terminal

1) npm install
2) Now edit app.js file paste your token at “paste_token_here_” save the file.
3) Now run in your cmd or terminal window following command
4) node app
5) There would be no handshake or connection establish message due to security reasons.
6) As soon as the data will arrive it will get started to print on your console terminal.
7) All response will be similar to the “REST”.

TWITTER FEEDS
Twitter Feeds from Multiple Business Channels

https://apidata.redboxglobal.com/api/global/twitter/YOUR_API_KEY JSON

{"_id":"62038751ed35de4862a8f7df",

"type":"Twitter",

"category":"Default",

"topic":"Reuters:",

"description":"From @Breakingviews: Frontier and Spirit Airlines say their merger would help
passengers by creating cut-price alternatives to pricier carriers. @johnsfoley explains why the market’s
muted response suggests their logic is running on fumes https://t.co/0evdNx6jdn
https://t.co/x11DzUTfYz",

"links":

["https://t.co/0evdNx6jdn",

"https://t.co/x11DzUTfYz"],
"company":

[{"_id":"620140108969c7fddea5c12f",

"symbol":"SAVE",

"name":"Spirit Airlines Inc. Common Stock",

"exchangeShortName":0}],

"createdAt":"2022-02-09T09:20:16.866Z"},

Reference:-

type: This field indicates source of news

1) RedboxGlobal
2) Crawler
3) Twitter

category: This field indicates categories

1) Global
2) Commodities
3) Fixed Income
4) Block Details (Rename to Analysis from your end)
5) Default

topic: This field shows Twitter handle

description: This field shows tweet from Twitter handle

link: This field stores article links

company: This field stores company name with stock symbol (max 3 companies)

symbol: This field stores companies stock exchanges symbol

exchangeShortName: Please ignore this field.

createdAt: This field stores data arrival date with time

Note:-

Equities news will be in “Global” and ‘Default’ categories.

Geopolitical news will be in “Global” categories.

Metals, Gold, Grains, Oil, Energy News will be in “commodities” categories.

Currencies, Crypto, Bonds, Central Banks, Finance Ministry, Live Press Conference from Ministry of
Finance, Central Banks will be in “Fixed Income” categories.

STREAMING

const io = require(“socket.io-client”);

var socket =io (“https://apidata.redboxglbal.com/api/socket”, {

query: {

token:

“Your_Token_Here”,

},

});

Socket Listener

socket.on ("newGlobalTwitterFeed", (data) => {

console.log (data);

});

socket.on ("disconnect", () => {

console.log ("listening stopped...");

});

Same response will be printed.

 Note:- You will get JavaScript Software development Kit for the streaming APIs.

Prerequiresite for the streaming APIs

1) LTS Nodejs with latest LTS NPM

2) Socket.io client

Steps to run Streaming APIs

Navigate “RedboxGlobal” folder on your console terminal

1) npm install
2) Now edit app.js file paste your token at “paste_token_here_” save the file.
3) Now run in your cmd or terminal window following command
4) node app
5) There would be no handshake or connection establish message due to security reasons.
6) As soon as the data will arrive it will get started to print on your console terminal.
7) All response will be similar to the “REST”.

ALL FEEDS (CONSOLIDATED)

All Feeds (Consolidated)

https://apidata.redboxglobal.com/api/global/YOUR_API_KEY JSON

{"_id":"62038751ed35de4862a8f7df",

"type":"Twitter",

"category":"Default",

"topic":"Reuters:",

"description":"From @Breakingviews: Frontier and Spirit Airlines say their merger would help
passengers by creating cut-price alternatives to pricier carriers. @johnsfoley explains why the market’s
muted response suggests their logic is running on fumes https://t.co/0evdNx6jdn
https://t.co/x11DzUTfYz",

"links":

["https://t.co/0evdNx6jdn",
"https://t.co/x11DzUTfYz"],

"company":

[{"_id":"620140108969c7fddea5c12f",

"symbol":"SAVE",

"name":"Spirit Airlines Inc. Common Stock",

"exchangeShortName":0}],

"createdAt":"2022-02-09T09:20:16.866Z"},

Reference:-

type: This field indicates source of news

1) RedboxGlobal
2) Crawler
3) Twitter

category: This field indicates categories

1) Global
2) Commodities
3) Fixed Income
4) Block Details (Rename to Analysis from your end)
5) Default

topic: This field shows Twitter handle

description: This field shows tweet from Twitter handle

link: This field stores article links

company: This field stores company name with stock symbol (max 3 companies)

symbol: This field stores companies stock exchanges symbol

exchangeShortName: Please ignore this field.

createdAt: This field stores data arrival date with time

Note:-

Equities news will be in “Global” and ‘Default’ categories.

Geopolitical news will be in “Global” categories.

Metals, Gold, Grains, Oil, Energy News will be in “commodities” categories.

Currencies, Crypto, Bonds, Central Banks, Finance Ministry, Live Press Conference from Ministry of
Finance, Central Banks will be in “Fixed Income” categories.

STREAMING

const io = require(“socket.io-client”);

var socket =io (“https://apidata.redboxglbal.com/api/socket”, {

query: {

token:

“Your_Token_Here”,

},

});

Socket Listener

socket.on("newGlobalRedboxFeed", (data) => {

console.log(data);

});

socket.on("newGlobalTwitterFeed", (data) => {

console.log (data);

});

socket.on("newGlobalCrawlerFeed", (data) => {

console.log(data);

});
socket.on("disconnect", () => {

console.log ("listening stopped...");

});

Same response will be printed.

Note:- You will get JavaScript Software development Kit for the streaming APIs.

Prerequiresite for the streaming APIs

1) LTS Nodejs with latest LTS NPM

2) Socket.io client

Steps to run Streaming APIs

Navigate “RedboxGlobal” folder on your console terminal

1) npm install
2) Now edit app.js file paste your token at “paste_token_here_” save the file.
3) Now run in your cmd or terminal window following command
4) node app
5) There would be no handshake or connection establish message due to security reasons.
6) As soon as the data will arrive it will get started to print on your console terminal.
7) All response will be similar to the “REST”.

Regards,