TCP Newsfeed v1.1 (Deprecated)
Use Websocket API or Webhook delivery.
If your news integration requires the TCP service, we highly recommend using our Python TCP client or our Go TCP client.
Line Endings
All lines endings will be in the expected format:
=BZEOT\r\n
Commands
All commands that return or send data will include a colon (:) and possible whitespace ( ) between the command and the data.
Note: A single whitespace was required and will now be deprecated.
Connection
All clients are given a username and key to connect with. Only one connection is allowed from a username/key at any given time.
Once connected, the server will reply with READY
on READY, send an AUTH token in the form:
The server will reply CONNECTED
, if the connection is valid, otherwise disconnect.
Example:
No Authentication Received
Clients will receive the following disconnect message if no authentication message is received:
Failed Authentication
Clients failing authentication will receive the following message(s):
Multiple Connections
If multiple connections are needed in your environment, please contact us.
Multiple connections with the same Username/Key will result in a disconnect:
Keep Alive
Client Initiated
After successful connection, a client should send a keep alive by sending PING: along with the pingTime in JSON format. The pingTime will be returned in the response by the server, along with the server time in UTC. The pingTime may be in any string or numeric format and in only used as the response token.
Example
Data
Once connected, article Data will be streamed in JSON format. The following data will be available:
Example
Example (with extended tickers)
Data Field Definitions
Primary Key and Unique ID of the Story
max-length: 255 chars. Title of the Article
max-length: Unlimited / Varying. Body of the Article. The length may be limited, per client setup. Body format may be in HTML or RichText per client setup.
This is the published date of the article. Date will be in GMT. Example: Thu Aug 09 2012 19:41:09 GMT+0000 (UTC)
This the updated timestamp of the article. This may be updated for a number of reasons that may or may not be apparent to the client. Stories will be pushed on all updates. Date will be in GMT.
- example: “Thu Jan 01 1970 00:00:00 GMT+0000 (UTC)”
This is the status of an article. A status of either Published
or Removed
will be included with the article. Article updates would only be indicated through a pushed and a client checking the difference in updated times.
- example:
Published
orRemoved
Link to publicly available story on Benzinga.com. This field will indicate NULL if a link is not available.
The Benzinga Channels or categories an article appears in. This array may be blank if no channels exist.
example: ["News" , "Markets" ]
Array of symbols. This field will be an array of symbol objects if extended tickers is turned on
- items:
- type: string
- description: Ticker symbol
- example: tickers:
["F", "GM"]
Array of symbol objects.
- items:
- type: object
- properties:
- name:
- type: string
- description: Ticker symbol
- primary:
- type: integer
- format: boolean
- description: 1 if primary 0 if not
- sentiment:
- type: integer or boolean
- description: Sentiment for this symbol as a result of this story (if available). -3 to 3 scale. FALSE if not available.
- example: tickers:
[ { "name": "F", "primary": 1, "sentiment": 1 } ]
- name:
Array of author objects. Author has a Name
field which is a string containing the name of that author. This field is optional and is only available if enabled by an admin
- example:
[{"Name": "Tyler Martin"}]
Was this page helpful?