Skip to main content

​
Overview

HoYoVista supports four HoYoverse games with varying feature availability. All games require linking your HoYoLAB account via /hoyolink.

​
Genshin Impact

Genshin Impact

Game ID: 2API Identifier: hk4e_globalAct ID: e202102251931481

​
Supported Features

FeatureStatusNotes
Daily Check-in✅ Full SupportAutomatic and manual
Real-Time Notes✅ Full SupportResin, commissions, realm currency, transformer
Profile View✅ Full SupportUses Enka Network API
Income/Ledger✅ Full SupportPrimogems and Mora tracking
Code Redemption⚠️ MaintenanceFeature temporarily disabled

​
Real-Time Notes Data

Original Resin
  • Current resin count (max 200)
  • Time until fully replenished
  • Recovery timestamps
Daily Commissions
  • Task completion status (4 commissions)
  • Encounter Points status
  • Long-Term Encounter Points accumulation
  • Daily commission rewards claimed
Enemies of Note
  • Weekly boss discount status
  • Remaining resin cost-halving opportunities
Jar of Riches
  • Current realm currency (Serenitea Pot)
  • Maximum capacity based on trust rank
  • Time until full
  • Requires Serenitea Pot unlocked
Parametric Transformer
  • Availability status
  • Cooldown remaining in days
  • Requires transformer obtained in-game

​
Profile & Stats

  • Adventure Rank (AR)
  • Total achievements
  • Characters with max friendship
  • Spiral Abyss progress (floor-chamber-stars)
  • Imaginarium Theater progress (act and stars)
  • Stygian Onslaught difficulty and clear time
  • Namecard display
  • Profile signature

​
Income Reports

  • Monthly Primogem earnings breakdown
  • Monthly Mora earnings
  • Daily earnings (for current month)
  • Comparison with previous month (percentage change)
  • Sources: Daily Activities, Quests, Spiral Abyss, Events, Mail, etc.
  • Primary source analysis
  • Excludes top-up purchases
Data has approximately 1-hour delay from in-game actions.

​
Honkai: Star Rail

Honkai: Star Rail

Game ID: 6API Identifier: hkrpg_globalAct ID: e202303301540311

​
Supported Features

FeatureStatusNotes
Daily Check-in✅ Full SupportAutomatic and manual
Real-Time Notes✅ Full SupportTrailblazer Power, training, simulated universe
Profile View❌ Not SupportedNot yet implemented
Income/Ledger❌ Not SupportedAPI returns error code -100
Code Redemption⚠️ MaintenanceFeature temporarily disabled

​
Real-Time Notes Data

Trailblazer Power
  • Current stamina count (max 240)
  • Time until fully restored
  • Restoration timestamp
Daily Training
  • Current training score
  • Maximum daily score (500)
Echo of War
  • Weekly boss clears
  • Weekly limit (3 clears)
Simulated Universe Points
  • Current weekly points
  • Maximum points capacity
Currency War Points
  • Current weekly apocalyptic shadow points
  • Weekly maximum
Income/Ledger feature disabled due to HoYoLAB API limitations (retcode -100).

​
Honkai Impact 3rd

Honkai Impact 3rd

Game ID: 1API Identifier: bh3_osAct ID: e202110291205111

​
Supported Features

FeatureStatusNotes
Daily Check-in✅ Full SupportAutomatic and manual
Real-Time Notes✅ Full SupportStamina, abyss, memorial arena
Profile View❌ Not SupportedNot yet implemented
Income/Ledger❌ Not SupportedNot available for this game
Code Redemption❌ Not SupportedNot available for this game

​
Real-Time Notes Data

Stamina
  • Current stamina amount
  • Maximum stamina capacity
  • Time until fully restored
  • Daily Battle Pass (BP) points
Superstring Dimension
  • Current challenge score
  • Current tier (Forbidden, Sinful I-III, Agony I-III, Redlotus, Nirvana)
  • Schedule status (open/closed)
  • Time remaining when active
Q-Manifold (for lower level captains)
  • Current score
  • Maximum reward score
  • Schedule status
  • Time remaining when active
Memorial Arena
  • Challenge reward progress
  • SSS-rank reward progress
  • Schedule status (open/locked)
  • Time remaining when active
Elysian Realm (if available)
  • Current score
  • Maximum reward score
  • Schedule status
  • Time remaining when active
Superstring Dimension and Q-Manifold are mutually exclusive based on captain level.

​
Zenless Zone Zero

Zenless Zone Zero

Game ID: 8API Identifier: nap_globalAct ID: e202406031448091

​
Supported Features

FeatureStatusNotes
Daily Check-in✅ Full SupportAutomatic and manual
Real-Time Notes✅ Full SupportBattery, dailies, season missions
Profile View✅ Full SupportUses Enka Network API
Income/Ledger✅ Full SupportPolychromes, Master Tapes, Boopons
Code Redemption⚠️ MaintenanceFeature temporarily disabled

​
Real-Time Notes Data

Battery Charge
  • Current battery/energy level (max 240)
  • Time until fully recovered
  • Exact recovery time (hour:minute, today/tomorrow)
Daily Missions
  • Engagement Today progress
  • Scratch Card Mania completion status
  • Video Store Management status (revenue available/currently open)
Season Missions
  • Bounty Commission progress and total
  • Bounty refresh countdown
  • Ridu Weekly Points progress
  • Weekly points refresh countdown

​
Profile & Stats

  • Inter-Knot Level
  • Active days played
  • Total achievements
  • Simulated Battle Trial progress (floor)
  • Battle Trial: The Last Stand progress
  • Personal title display
  • Profile description
  • Custom namecard

​
Income Reports

Resources tracked:
  • Polychromes (premium currency)
  • Master Tapes (gacha pulls)
  • Boopons (gacha tickets)
Revenue Sources:
  • Mail Rewards
  • Shiyu Defense & Deadly Assault Rewards
  • Daily Activity Rewards
  • Development Rewards
  • Event Rewards
  • Hollow Zero Rewards
  • Other Rewards
Analysis includes:
  • Monthly totals for each resource
  • Primary source identification
  • Percentage breakdown by source
  • Polychromes from Monochromes excluded
Data has approximately 2-hour delay from in-game actions.

​
API Endpoints

HoYoVista uses the following HoYoLAB API endpoints:
EndpointPurpose
https://bbs-api-os.hoyolab.comMain API for game records and user data
https://api-account-os.hoyolab.comAccount authentication
https://sg-hk4e-api.hoyolab.comGenshin Impact specific APIs
https://sg-public-api.hoyolab.comPublic game data
https://sg-act-nap-api.hoyolab.comZenless Zone Zero check-ins
https://act.hoyolab.comEvent and check-in actions

​
Feature Comparison

FeatureGenshinStar RailHonkai 3rdZZZ
Check-in✅✅✅✅
Real-Time Notes✅✅✅✅
Profile✅❌❌✅
Income✅❌❌✅
Redeem Codes⚠️⚠️❌⚠️
Auto Check-in✅✅✅✅
Auto Redeem⚠️⚠️❌⚠️
Legend:
  • ✅ Fully Supported
  • ⚠️ Under Maintenance/Limited
  • ❌ Not Supported

​
Coming Soon

Check /roadmap in Discord for the latest planned features and improvements:
  • Code redemption restoration
  • Star Rail income tracking (pending API fix)
  • Star Rail and Honkai 3rd profile views
  • Additional real-time note features
  • Enhanced statistics and analytics

​
Technical Details

​
Game Abbreviations

Used internally by the bot:
  • Genshin Impact: genshin
  • Honkai: Star Rail: hkrpg
  • Honkai Impact 3rd: honkai3rd
  • Zenless Zone Zero: zzz

​
Event Paths

Used for check-in API calls:
  • Genshin Impact: sol
  • Honkai: Star Rail: luna/hkrpg/os
  • Honkai Impact 3rd: mani
  • Zenless Zone Zero: luna/zzz/os

​
Region Codes

Supported server regions:
  • North America: os_usa
  • Europe: os_euro
  • Asia: os_asia
  • TW/HK/MO: os_cht
Chinese (CN) servers are not supported. Only global/overseas servers work with HoYoVista.

Build docs developers (and LLMs) love

Get started for freeTalk to us