Hermes Aggregator Integration Docs

Hermes Aggregator provides HTTP APIs to:

• Discover supported tokens.
• Discover available quote providers.
• Request best-route swap quotes.
• Execute swaps using provider execution details.

This documentation is written for integrators building wallet, trading, or routing experiences on top of https://api.hermes.ag.

Start Path

1. 5-Minute Quickstart
2. API Endpoint Reference

API Limits

• Hermes API applies rate limits per route.
• Current default IP limits:
  • /v1/tokens: 30 requests per 60 seconds
  • /v1/tokens/:identifier: 60 requests per 60 seconds
  • /v1/providers: 60 requests per 60 seconds
  • /v1/quote: 30 requests per 60 seconds
• If you need higher limits, reach out on Discord.

What You Get From This API

• A token catalog with instrumentId and instrumentAdmin.
• A provider catalog for optional quote filtering.
• Aggregated quote results sorted by best outAmount.
• Execution instructions per route:
  • magicAddress execution (direct deposit style).
  • transfer execution (send with memo).

Integration Model

1. Load /v1/tokens and /v1/providers at startup.
2. Build quote requests from user input.
3. Call /v1/quote.
4. Select the best route (or let users choose).
5. Execute using the returned execution fields.

For implementation details, go to Quote endpoint reference.

Additional Docs

• Quote endpoint reference for request/response details.