IVYFI // PUBLIC INFRASTRUCTURE // HEDERA
[ IVYFI NODE // PUBLIC GATEWAY ] --:--:--
IvyFi Public Infrastructure // Hedera

IVYFI

API SERVICE
*** ACCESS GRANTED // PUBLIC INTERFACE ***
root@ivyfi:~# ./connect --public --network=mainnet
Establishing encrypted route to api.ivyfi.io...
Mounting /staking-api [READY]
JSON API + cache-backed WEBP CDN [ONLINE]
ivyfi@api:~$ explore --public

Public JSON APIs, pricing diagnostics, staking statistics and cache-backed CDN assets. Base endpoint: https://api.ivyfi.io/staking-api

API CHECKING
NETWORK MAINNET
FORMAT JSON + WEBP
BASE /staking-api
> READ-ONLY FIRSTMost routes are safe GET requests. Manual refresh endpoints are explicitly marked.
> CDN READYPool art, NFT thumbnails, display images and metadata are exposed through cache-backed URLs.
> SOURCE TRANSPARENCYCheck SilkSuite, SaucerSwap and CoinGecko pricing sources independently where supported.

01 // CORE API

General service, staking, vault and platform data

GET/health
Service health and runtime configuration summary.
curl -s https://api.ivyfi.io/staking-api/health | jq
GET/pools/stats
Current pool statistics for the configured network.
curl -s https://api.ivyfi.io/staking-api/pools/stats | jq
GET/terminalstats
Compact terminal statistics and platform volume summary.
curl -s https://api.ivyfi.io/staking-api/terminalstats | jq
GET/dashboard-stats
Dashboard bundle containing normalized prices, pool reports, totals and diagnostics.
curl -s https://api.ivyfi.io/staking-api/dashboard-stats | jq
GET/platform-volume
Platform-wide staking volume totals calculated from pool statistics.
curl -s https://api.ivyfi.io/staking-api/platform-volume | jq
GET/holders/ivyfi
IvyFi token holder statistics.
curl -s https://api.ivyfi.io/staking-api/holders/ivyfi | jq
GET/boosterpacks
Booster Pack data used by IvyFi staking and boost-aware interfaces.
curl -s https://api.ivyfi.io/staking-api/boosterpacks | jq
GET/vaults/tokens
Cached IvyFi Vault token scanner output.
curl -s https://api.ivyfi.io/staking-api/vaults/tokens | jq

02 // PRICING & SOURCE CHECKS

Composite prices plus individual provider diagnostics

GET/token-prices
Cached normalized token prices used by the API.
curl -s https://api.ivyfi.io/staking-api/token-prices | jq
GET/dex-price-test/:tokenId
Live DEX composite diagnostic for a Hedera token ID.
curl -s 'https://api.ivyfi.io/staking-api/dex-price-test/0.0.786931?refresh=1' | jq
HSUITE EXAMPLE
GET/price-source/HBAR/all
Checks all supported HBAR price sources independently.
curl -s https://api.ivyfi.io/staking-api/price-source/HBAR/all | jq
SILKSAUCERSWAPCOINGECKO
GET/price-source/HBAR/silk
SilkSuite HBAR/USD market-price source only.
curl -s https://api.ivyfi.io/staking-api/price-source/HBAR/silk | jq
GET/price-source/HBAR/saucerswap
SaucerSwap HBAR/USD source only.
curl -s https://api.ivyfi.io/staking-api/price-source/HBAR/saucerswap | jq
GET/price-source/HBAR/coingecko
CoinGecko HBAR/USD source only.
curl -s https://api.ivyfi.io/staking-api/price-source/HBAR/coingecko | jq
GET/price-source/HSUITE/all
Checks SilkSuite and SaucerSwap HSUITE pricing independently.
curl -s https://api.ivyfi.io/staking-api/price-source/HSUITE/all | jq
GET/price-source/HSUITE/silk
SilkSuite-only HSUITE executable quote-derived price.
curl -s https://api.ivyfi.io/staking-api/price-source/HSUITE/silk | jq
GET/price-source/HSUITE/saucerswap
SaucerSwap-only HSUITE market price.
curl -s https://api.ivyfi.io/staking-api/price-source/HSUITE/saucerswap | jq
GET/price-source/IVYFI/all
Checks IvyFi across SilkSuite and SaucerSwap. Before listing, unavailable responses are expected.
curl -s https://api.ivyfi.io/staking-api/price-source/IVYFI/all | jq
SILKSAUCERSWAP
GET/price-source/IVYFI/silk
SilkSuite-only IVYFI source diagnostic.
curl -s https://api.ivyfi.io/staking-api/price-source/IVYFI/silk | jq
GET/price-source/IVYFI/saucerswap
SaucerSwap-only IVYFI source diagnostic.
curl -s https://api.ivyfi.io/staking-api/price-source/IVYFI/saucerswap | jq
Source-check routes accept the aliases HBAR, HSUITE and IVYFI, and the supported Hedera token IDs. CoinGecko is intentionally HBAR-only.

03 // NETWORK-SCOPED DATA

Explicit mainnet and testnet reads

GET/mainnet/pools/stats
Pool statistics explicitly scoped to Hedera mainnet.
curl -s https://api.ivyfi.io/staking-api/mainnet/pools/stats | jq
GET/testnet/pools/stats
Pool statistics explicitly scoped to Hedera testnet.
curl -s https://api.ivyfi.io/staking-api/testnet/pools/stats | jq
GET/mainnet/terminalstats
Mainnet terminal statistics.
curl -s https://api.ivyfi.io/staking-api/mainnet/terminalstats | jq
GET/testnet/terminalstats
Testnet terminal statistics.
curl -s https://api.ivyfi.io/staking-api/testnet/terminalstats | jq

04 // POOL IMAGE CDN

WebP pool artwork and icon cache

GET/mainnet/pool-images
Mainnet pool image manifest containing cached image URLs.
curl -s https://api.ivyfi.io/staking-api/mainnet/pool-images | jq
CDN
GET/testnet/pool-images
Testnet pool image manifest.
curl -s https://api.ivyfi.io/staking-api/testnet/pool-images | jq
CDN
GET/mainnet/pool-images/:poolId.webp
Full cached WebP artwork for a pool ID.
https://api.ivyfi.io/staking-api/mainnet/pool-images/<poolId>.webp
WEBP
GET/mainnet/pool-images/:poolId/icon.webp
Smaller cached pool icon variant.
https://api.ivyfi.io/staking-api/mainnet/pool-images/<poolId>/icon.webp
WEBP

05 // NFT CDN

Collection manifests, thumbnails, metadata and display images

GET/mainnet/nft-thumbnails
Manifest of cached mainnet NFT thumbnail collections.
curl -s https://api.ivyfi.io/staking-api/mainnet/nft-thumbnails | jq
CDN
GET/mainnet/nft-thumbnails/:collectionId/manifest.json
Thumbnail manifest for one NFT collection.
curl -s https://api.ivyfi.io/staking-api/mainnet/nft-thumbnails/<collectionId>/manifest.json | jq
GET/mainnet/nft-thumbnails/:collectionId/:serial.webp
Cached thumbnail for a specific NFT serial.
https://api.ivyfi.io/staking-api/mainnet/nft-thumbnails/<collectionId>/<serial>.webp
WEBP
GET/mainnet/nft-assets
Manifest of cached NFT metadata and display assets.
curl -s https://api.ivyfi.io/staking-api/mainnet/nft-assets | jq
GET/mainnet/nft-assets/:collectionId/manifest.json
Asset manifest for a specific NFT collection.
curl -s https://api.ivyfi.io/staking-api/mainnet/nft-assets/<collectionId>/manifest.json | jq
GET/mainnet/nft-assets/:collectionId/:serial/metadata.json
Normalized cached metadata JSON for an NFT serial.
curl -s https://api.ivyfi.io/staking-api/mainnet/nft-assets/<collectionId>/<serial>/metadata.json | jq
GET/mainnet/nft-assets/:collectionId/:serial/thumbnail.webp
Thumbnail-sized cached NFT asset.
https://api.ivyfi.io/staking-api/mainnet/nft-assets/<collectionId>/<serial>/thumbnail.webp
WEBP
GET/mainnet/nft-assets/:collectionId/:serial/image.webp
Larger display-ready cached NFT asset.
https://api.ivyfi.io/staking-api/mainnet/nft-assets/<collectionId>/<serial>/image.webp
WEBP
Replace <collectionId>, <serial> and <poolId> with values returned by the relevant manifest endpoint. Equivalent NFT and pool CDN routes are also registered for testnet.

06 // PRICE HISTORY & SNAPSHOTS

Historical records and daily statistics

GET/ivyfi-price/status
Current state of the dedicated IVYFI price-history tracker.
curl -s https://api.ivyfi.io/staking-api/ivyfi-price/status | jq
GET/ivyfi-price-history/:date
IVYFI historical price records for a YYYY-MM-DD date.
curl -s https://api.ivyfi.io/staking-api/ivyfi-price-history/2026-09-20 | jq
GET/snapshots/index.json
Index of available daily stats snapshots.
curl -s https://api.ivyfi.io/staking-api/snapshots/index.json | jq
GET/snapshots/:date
Daily stats snapshot for a YYYY-MM-DD date.
curl -s https://api.ivyfi.io/staking-api/snapshots/2026-09-20 | jq

07 // OPERATIONAL ROUTES

Manual refresh and prefetch diagnostics — use intentionally

GET/token-prices/refresh
Manually requests a token-price cache refresh.
curl -s https://api.ivyfi.io/staking-api/token-prices/refresh | jq
MANUAL ACTION
GET/vaults/tokens/refresh
Starts a manual Vault token scan refresh and normally responds 202.
curl -s https://api.ivyfi.io/staking-api/vaults/tokens/refresh | jq
MANUAL ACTION
GET/mainnet/nft-thumbnails/prefetch/status
Mainnet NFT thumbnail/background-prefetch service status.
curl -s https://api.ivyfi.io/staking-api/mainnet/nft-thumbnails/prefetch/status | jq
GET/testnet/nft-thumbnails/prefetch/status
Testnet NFT thumbnail/background-prefetch service status.
curl -s https://api.ivyfi.io/staking-api/testnet/nft-thumbnails/prefetch/status | jq
The refresh routes are GET routes in the current API for backwards compatibility, but they initiate work. Public integrations should normally consume the cached read endpoints instead.