Vibe Coding Help
Introduction
Vibe coding can be a very efficient way to create and manage applications. This guide will help you set up and use the FinTech Studios API to integrate the rich set of information that FinTech Studios can make available.
Note
I tried to use the experience I have had in implementing the API into a Vibe coding environment and the instructions will reflect the best way to do that. In addition, the help pages that will be made available as part of this guide can be used to instruct the agent in the Vibe coding environment directly. Just copy and paste them into the agent's chat input box.
Authentication
The first step to getting access to the FinTech Studios API is to get authenticated. As you think about the application you want to create, consider whether you want to use the API in the background for all users or if you want each user to manage their own FinTech Studios API credentials. The main difference is that if you manage the API in the background all activity will be tracked to your FTS API Key while if you allow each user to have their own API Key, each user will be responsible for their own activity.
In your setup, you will need to create three settings fields to manage the API authentication.
- Global API Authentication and Management - For this type of access, tell the agent to set up Global Settings for the FinTech Studios API that can only be managed by an Admin user. Make sure you set yourself up as the initial Admin User so that you can manage the credentials.
- Individual API Authentication and Management - For this type of access, tell the agent to set up User Settings that can be updated by each individual user and should be use for authentication for that user.
Note
If you are using the Global API Authentication and Management option, use secrets for the UserID, Password, and API Key information discussed below. Otherwise, for Individual API Authentication and Management the API Key should be treated as if it were a second Password.
Settings Fields
Implement these fields using the language above depending on how you want to use the API.
- Email Address
- Password
- FTS API Key
Authentication Instructions
Trending Entities
The first data endpoint I like to use is the Trending Entities endpoint because it is pretty simple and gives back immediately useful information about what is currently trending in the news.
Trending Endpoint
The beauty of the Trending Entities Endpoint is that you will get a set of entities that are currently trending based on the current news coverage. This is immediately useful if you want to display a list of Hot Topics, Hot Companies, Hot Regions, or any of the categories of news we cover.
Retrieve Channel Definitions
The second endpoint to consider is the Channel Definition Endpoint. This endpoint will return the definition for a channel which you can then use to read articles using that definition. Also, the stages component of the channel is the basis for understanding how to create and/or use a sophisticated search.
Channel Definition Endpoint
Read Articles
Once you have captured a channel definition and/or have put together the stages you want to use for a search, you then use the Read Articles Endpoint to actually read the articles associated with that channel/search.
Read Articles Endpoint
Entity Lookup
Now that you have the Article JSON, you will need to convert the Entity ID's that are present for each article into Names. To do that you will need to use the Entity Lookup Endpoint.