Endpoints

Reference endpoints

Sources

GET/api/v1/rates/sources

Lists the enabled upstream sources — exchanges and aggregators for crypto, central banks (including NBU) for fiat — with their current health and the time of the last successful fetch.

Example

$ curl "https://pricefeed.online/api/v1/rates/sources"

Response · 200 OK

{
  "success": true,
  "sources": [
    {
      "slug": "binance",
      "name": "Binance",
      "type": "crypto",
      "status": "active",
      "last_success_at": "2026-06-12T10:15:30+00:00"
    },
    {
      "slug": "nbu",
      "name": "National Bank of Ukraine",
      "type": "fiat",
      "status": "active",
      "last_success_at": "2026-06-12T09:00:12+00:00"
    }
  ]
}

Service status

GET/api/v1/rates/status

A single health snapshot for monitoring and status pages. status is one of operational, degraded, partial_outage, outage.

Example

$ curl "https://pricefeed.online/api/v1/rates/status"

Response · 200 OK

{
  "success": true,
  "status": "operational",
  "sources": {
    "binance": "active",
    "coingecko": "active",
    "nbu": "active"
  },
  "cache": {
    "status": "healthy",
    "driver": "redis"
  },
  "updated_at": "2026-06-12T10:16:02+00:00"
}

Assets

GET/api/v1/assets

All active assets with their type and display precision. Browse them on the currencies page.

Example

$ curl "https://pricefeed.online/api/v1/assets"

Response · 200 OK

{
  "success": true,
  "assets": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "type": "crypto",
      "is_stablecoin": false,
      "precision": 8
    },
    {
      "symbol": "UAH",
      "name": "Ukrainian Hryvnia",
      "type": "fiat",
      "is_stablecoin": false,
      "precision": 2
    }
  ]
}

Pairs

GET/api/v1/pairs

All active currency pairs and how often each one is refreshed — useful for sizing your own polling and cache TTLs. Browse them on the pairs page.

Example

$ curl "https://pricefeed.online/api/v1/pairs"

Response · 200 OK

{
  "success": true,
  "pairs": [
    {
      "pair": "BTC/USD",
      "base": "BTC",
      "quote": "USD",
      "update_interval_seconds": 60
    },
    {
      "pair": "USD/UAH",
      "base": "USD",
      "quote": "UAH",
      "update_interval_seconds": 300
    }
  ]
}