Integrating News Into Your Product

Looking to introduce a real-time news feed for coins on your own platform? Here's how to go about a successful and easy integration.

Step 1: Sync the directory of entities

When you fetch news back from a feed, each article will contain an array of collections, sources, and tags that it is associated with. You'll want to have the full directories synced in order to properly match them up to your own database, specifically coins.

Links to endpoints for syncing:
Collections
Sources
Tags
Coins

Step 2: Create desired feeds on terminal.thetie.io

To start receiving news through the API, you first need to create your desired feeds on the frontend Terminal. Navigate to your Dashboard, and then click "+ Create" in the Firehose sidebar next to My Feeds section header. Here you can create a new feed.

You should create as few feeds as possible that encompass all the news you are interested in. For example, if you support 20 coins on your platform, you should create one feed that selects all 20 coins as filters, as opposed to 20 separate feeds each tagged one coin. Even better, you can create a Watchlist of those 20 coins and then select that watchlist as a filter for the news feed.

Step 3: Fetch and store news

Once you have your feed(s) created, you can find their unique ID through the News Feeds endpoint.

When you have your set of news feed IDs, then you can fetch news with the News endpoint.

When you pull news from the API, you should save it in your central database as a middle layer before serving it to your customers. This helps efficiently scale on both of our ends and lets you layer on additional filtering or functionality.

The way you can ensure uniqueness of articles is by using the link_hash attribute.

Want help or guidance?

If you would like any help or guidance on which feeds to set up, ideas on how to best display the information on your product, or any other questions/issues regarding the integration, please reach out to Ben Latz via email [email protected] and he'll be happy to chat.

If you are interested in integrating this data to your product but haven't yet talked with us about an arrangement, please reach out to [email protected].