HayInsights — Frequently Asked Questions
Last updated: 21 October 2026
HayInsights is an AI-powered financial data hub for the US, Japan and Vietnam markets, available in your browser, through a REST API, or inside AI assistants via MCP. Below are answers to the questions we hear most about plans and pricing, using the dashboards, exporting data, the API and MCP. Can't find your answer? Email us at hayinsights@finhay.com.vn.
Getting started
What is HayInsights?
HayInsights is a one-stop financial data platform that puts US, Japan and Vietnam data side by side, in clean English-language form. It covers the full top-down view, from macroeconomics down to individual tickers. HayInsights is a product of Finhay, a Vietnamese fintech founded in 2017, with offices in Hanoi and Tokyo.
Who is HayInsights for?
- Analysts and investors use the dashboards to screen, chart and compare data, then download what they need. No code required.
- AI builders connect Claude, ChatGPT or other AI agents via MCP and ask questions in plain language.
- Developers call clean REST endpoints with JSON responses from an app, notebook or data pipeline.
Which markets and data does HayInsights cover?
Three markets: the US, Japan and Vietnam. Data spans:
- Macroeconomics: GDP, CPI and PCE, interest rates and bond yields, unemployment, government debt, FDI, trade, PMI
- Equities and indices: Japanese stock detail, major global indices such as the S&P 500, Nikkei and VN-Index
- Funds and ETFs: Japanese ETFs and Vietnamese fund certificates, with holdings, NAV growth and comparison tools
- FX, bonds, crypto, commodities, real estate and derivatives
- News with sentiment, and an economic event calendar (rate decisions, CPI and GDP releases, holidays, dividends)
How do I sign up?
Click Get Started on hayinsights.com, then Login. You can sign in with your Google account, or create an account with your name, email and a password. Many dashboards can be browsed before you sign in.
Do I need to install anything?
No. HayInsights runs in your web browser, with no installation or setup. The API and MCP connection also need nothing more than an API key or a one-time sign-in.
Pricing & plans
How much does HayInsights cost?
There are two plans: Free at $0/month and Pro at $18.99/month. See the Pricing page for the latest details.
Limited-time promotion: right now, all features are open to every account for free, including the Pro features listed below.
What is included in each plan?
| Feature | Free | Pro |
|---|---|---|
| Overview dashboard and widgets | Yes | Yes |
| Macroeconomics and equities data | Yes | Yes |
| Crypto and real estate data | Yes | Yes |
| News and market sentiment | Yes | Yes |
| Data sources and methodology | Yes | Yes |
| All asset classes: FX, bonds, ETFs, derivatives and more | No | Yes |
| Full analytics and intelligence suite | No | Yes |
| Signal screener and smart money flow | No | Yes |
| Data export (CSV, PNG) and API access with credits | No | Yes |
| Custom watchlists and alerts | No | Yes |
| Complimentary intel (sector, satellite, transport and more) | No | Yes |
How do I upgrade to Pro?
Click Subscribe Now on the Pricing page, or open User & Settings → Billing & Subscriptions in the app to see your current plan. Your new features apply right away. For the API, your plan is checked on every request, so you don't need a new API key after upgrading.
Can I cancel my subscription? Will I get a refund?
Yes, you can cancel your Pro subscription at any time. Refunds are not available: all subscription payments are final. See the Privacy Policy and Terms of Use for our full terms, or email hayinsights@finhay.com.vn.
How are payments processed?
Payments go through authorized third-party payment gateways. HayInsights does not store your credit card details or bank credentials.
Using the dashboards
How is the app organized?
Everything is in the left sidebar:
- Dashboard: a market overview with the News Centre, upcoming events, global markets and macro health for Japan, the US and Vietnam
- Markets: Macros & Economics, Forex / FX, Equities, Funds, ETFs, Fixed Income / Bonds, Cryptocurrencies, Commodities, Real Estate and Derivatives (coming soon)
- News & Events: News & Sentiment and Event Calendars
- Data Management: API docs, your API keys, and data sources and methodology
- User & Settings: your account, billing and team
To jump straight to a page or dataset, use the What are you looking for? search box at the top.
How do I find data for a specific country?
- Open Markets → Macros & Economics.
- Browse By Region or By Indicator, then pick the United States, Japan or Vietnam.
- Choose a chart from the menu, for example GDP Growth Rates, Core CPI, Interbank Call Rates or FDI.
Each chart comes with a data table underneath. Click a label in the chart legend to hide or show that line.
What is HayInsights AI?
HayInsights AI is the assistant built into the app. Ask it about the US, Japan and Vietnam markets in plain language and it answers from HayInsights data. Suggested prompts such as “Gold vs S&P”, “VN-Index trend” or “Fear & Greed history” help you get started.
Can I compare funds and ETFs?
Yes. The Funds and ETFs pages include comparison tools. For example, you can compare the asset allocation and sector mix of several Vietnamese funds, or chart their NAV growth against the VN-Index.
Can I switch between dark and light mode?
Yes. Use the Change Theme toggle at the bottom of the sidebar.
Exporting data
How do I export data from a chart or table?
- Open the chart or table you need.
- Click Export in its top-right corner.
- Choose CSV for the underlying data, or Image for a PNG of the chart.
CSV files open in Excel, Google Sheets or any analysis tool. PNG images paste straight into reports and slides.
Do I need a paid plan to export?
Yes. Data export is part of the Pro plan ($18.99/month), which unlocks every export option for charts and tables. On the Free plan, charts and tables are view-only. Right now, though, export is open to all accounts for free as part of a limited-time promotion.
What does the API button next to Export do?
It opens the API documentation for the endpoint behind that chart. Use it when you want the same data delivered to your code automatically instead of downloading it by hand.
Can I export large amounts of data or automate downloads?
For regular or bulk pulls, use the HayInsights API rather than manual exports. It returns the same data as JSON, ready for your app, notebook or pipeline. See API access below.
API access
Which plan includes API access?
API access with credits is included in the Pro plan. Your plan decides which data domains you can call and your per-minute quota.
How do I get an API key?
- Sign in at app.hayinsights.com.
- Go to Data Management → API Key.
- Create a key. It starts with
apk_and is shown only once, so copy it to a safe place right away.
You can rotate or revoke a key on the same page. Treat it like a password: never commit it to source control or put it in client-side code.
How do I make my first API call?
Send your key in the X-API-Key header to the base URL https://api-v2.hayinsights.com. For example:
curl -H "X-API-Key: $HAYINSIGHTS_API_KEY" \
"https://api-v2.hayinsights.com/openapi/v1/crypto/dominance"Every response is JSON in the same envelope: success, statusCode, data and meta. The Quickstart walks you through it in under 5 minutes.
What data can I get through the API?
Ten data domains across 81 endpoints: Commodities, Crypto, ETF, FX, Macro, Real Estate, News, Calendar, Market indices and Japanese Equities. Browse them all in the API docs.
How do rate limits work?
Each call uses a “weight” from your plan’s per-minute budget, and heavier endpoints cost more. For example, on a 1,000-weight budget you can make about 333 Macro calls (weight 2) or 125 ETF calls (weight 8) per minute. Every response includes X-RateLimit-Remaining and X-RateLimit-Reset headers so you can slow down before you hit the limit. See Rate limits.
Why am I getting an error from the API?
| HTTP status | Error code | What to do |
|---|---|---|
| 401 | API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_DISABLED, API_KEY_EXPIRED | Check the X-API-Key header, or create a new key |
| 403 | FEATURE_NOT_IN_PLAN | Your plan doesn't include this data domain. Upgrade to unlock it |
| 429 | RATE_LIMIT_EXCEEDED | Wait for the seconds in the Retry-After header, then retry |
| 400 / 404 | — | Fix the missing or invalid parameter, or the unknown code |
| 500 | — | Retry with backoff. If it persists, contact support |
When you report an issue, include the error code, the request path and the meta.timestamp. Full list: Error codes.
MCP & AI assistants
What is HayInsights MCP?
It is the HayInsights server for the Model Context Protocol (MCP). It connects HayInsights data directly to Claude, ChatGPT or another AI agent. You ask a question in plain language and the agent answers with real numbers instead of guessing, without you opening the app.
How do I connect HayInsights to Claude?
- In Claude.ai or the Claude desktop app, open Customize → Connectors.
- Click Add New, then Add custom connector.
- Name it HayInsights and enter the server URL
https://mcp.hayinsights.com/mcp, then click Add. - Click Connect, log in to your HayInsights account and grant permissions.
- Start a new chat, turn on the HayInsights connector and ask for the data you need.
Steps for ChatGPT are on the MCP page.
Which AI clients are supported?
Any MCP-compatible client, including Claude, ChatGPT and other AI agents that support the Model Context Protocol.
Is it safe to connect my account?
Yes. You sign in once through secure OAuth with your own HayInsights account, so the AI never sees your password. Access is read-only. You can disable or disconnect it at any time, in your AI client or in HayInsights.
Does MCP cost extra?
No. Connecting the MCP server is included with your HayInsights account. The data you can reach follows your plan, so Pro unlocks more datasets than Free.
Data, accuracy & disclaimer
Where does HayInsights data come from?
We collect data from official and established publishers, such as the Bank of Japan, Japan’s Ministry of Finance, JETRO, MLIT, the State Bank of Vietnam, the US Census Bureau and S&P Global. The full list, with methodology notes, is under Data Management → Data Sources & Methodology in the app.
How often is the data updated?
It depends on the dataset. Market prices, indices and FX refresh throughout the day, and Japanese stock data is end-of-day. Macro indicators update when the official source publishes, usually monthly or quarterly, and some arrive with a lag. Each dashboard widget shows its last update time.
Why is a value missing or blank?
If a source has not published a figure, we leave it blank rather than show a zero. Some indicators are also only published for certain countries, for example only for Japan and the US.
Is HayInsights financial advice?
No. HayInsights is a data provider, and all content is for informational purposes only. Nothing on the platform is investment, financial, tax or legal advice, or a recommendation to buy, sell or hold any asset. You are responsible for your own investment decisions.
Account, privacy & security
How do I update my account details?
Go to User & Settings → Account & Settings in the app to view, update or correct your personal information.
What personal data does HayInsights collect?
Only what we need to run your account: your name, email and contact details; your subscription and billing history; and technical data such as IP address, browser type and access times, which we use to keep the site fast and secure. We never store your card details or bank credentials.
Do you sell or share my data?
No. HayInsights does not sell, rent or trade your personal data. We share it only with essential service providers, such as payment processors, who are contractually bound to protect it, or when the law requires it. Your data is protected with industry-standard SSL/TLS encryption. Details are in our Privacy Policy and Terms of Use.
How do I delete my account?
Email hayinsights@finhay.com.vn and ask us to suspend your account temporarily or delete it permanently.
Still need help? Contact us
Our support team is happy to help with billing, data, API or MCP questions. Email us at hayinsights@finhay.com.vn.
To help us answer faster, include your account email, the page or endpoint you were using, and a screenshot or the error code if you saw one.
You can also follow HayInsights on X and LinkedIn.
Tokyo office: Sakura Deeptech Shibuya (SDS), 12F, 1-1 Sakuragaokacho, Shibuya, Tokyo 150-0031, Japan