Hermes Aggregator Docs

Appearance

GET /v1/providers ​

Purpose ​

Returns configured quote providers.

When to Call ​

  • On app startup.
  • Before rendering provider filters in your UI.

Request ​

  • Method: GET
  • Path: /v1/providers
  • Query params: none

Response ​

200 OK returns provider metadata:

json
[
  {
    "id": "nightly",
    "name": "Nightly"
  },
  {
    "id": "tradecraft",
    "name": "Tradecraft"
  }
]

Errors ​

  • 429 Too Many Requests when rate limit is exceeded.

Integration Notes ​

  • Use id values in /v1/quote via whitelistedProviders.
  • Cache provider list at startup and refresh periodically.
  • If no provider filter is sent to /v1/quote, all providers are used.
  • Default IP policy for /v1/providers is 60 requests per 60 seconds.
  • Need higher limits? Reach out on Discord.

Examples ​

bash
curl "https://api.hermes.ag/v1/providers"
ts
const response = await fetch('https://api.hermes.ag/v1/providers');
const payload = await response.json();

if (!response.ok) {
  throw new Error(JSON.stringify(payload));
}

const providers = Array.isArray(payload) ? payload : [];