|
| 1 | +--- |
| 2 | +title: Hermes |
| 3 | +description: Guide to Hermes API endpoints for real-time Pyth price delivery |
| 4 | +slug: /price-feeds/core/api-instances-and-providers/hermes |
| 5 | +--- |
| 6 | + |
| 7 | +import { Callout } from "fumadocs-ui/components/callout"; |
| 8 | + |
| 9 | +Hermes is an open-source service that listens to the Pythnet and the Wormhole Network for Pyth price updates, and |
| 10 | +serves them via a convenient web API. |
| 11 | + |
| 12 | +Hermes allows users to easily [fetch price updates](../fetch-price-updates.mdx) via a REST API, or subscribe to server-side streaming |
| 13 | +updates. |
| 14 | + |
| 15 | +## Public Endpoints |
| 16 | + |
| 17 | +The Pyth Data Association operates a public endpoint for Hermes, which can be used to test integrations with Pyth |
| 18 | +Network: |
| 19 | + |
| 20 | +URL: https://hermes.pyth.network |
| 21 | + |
| 22 | +<Callout type="warning" title="Hermes Beta"> |
| 23 | +For developers building on **Aptos testnet**, **Sui testnet** or **Near testnet**, please use the Hermes Beta endpoint: |
| 24 | +URL: https://hermes-beta.pyth.network |
| 25 | + |
| 26 | +</Callout> |
| 27 | + |
| 28 | +### Rate limits |
| 29 | + |
| 30 | +In order to maximize the reliability of the Public Hermes API, a request rate limit is enforced. |
| 31 | +All endpoints limits are set at 30 requests every 10 seconds per IP address. |
| 32 | +Clients issuing request above the limit will receive a 429 (Too Many Requests) response for the subsequent 60-second period. |
| 33 | + |
| 34 | +For production deployments, developers integrating with Pyth Network are **strongly encouraged** to use Node Providers |
| 35 | +for maximum resilience and decentralization. Moreover, Hermes is designed to be self-hosted, so developers can run their own |
| 36 | +instance of Hermes to fetch Pyth price updates. |
| 37 | + |
| 38 | +## Node Providers |
| 39 | + |
| 40 | +The following node providers offer Hermes: |
| 41 | + |
| 42 | +- [Triton](https://triton.one) |
| 43 | +- [P2P](https://p2p.org) |
| 44 | +- [extrnode](https://extrnode.com/) |
| 45 | +- [Liquify](https://www.liquify.io/) |
| 46 | + |
| 47 | +## Self-Hosting |
| 48 | + |
| 49 | +The Pyth Data Association provides a Helm chart for running Hermes in |
| 50 | +[charts](https://github.com/pyth-network/charts/tree/main/charts/hermes) repository. Please refer to the chart's readme |
| 51 | +for the configuration values. |
| 52 | +You will need a Pythnet RPC to run Hermes; see the [guide for accessing a Pythnet RPC](pythnet-rpc.mdx). |
| 53 | + |
0 commit comments