List Oracle Metrics

Lists metric providers across every category, newest first, optionally narrowed to one category or by a text search. A metric provider is the non-price side of an oracle: instead of a price it supplies a token's market-listing figures (term, purchase limits, rental income, listed supply), which the tokenization form reads through Get Oracle Metric Summary.

Every row carries its connection with the auth secret masked: only secret_set says whether one is stored.

Required permission: oracle:view

Request

GET /v2/admin/oracle-metrics

Parameters

Name	Type	In	Description
page	integer	query	Required. Page number, starting at 1
per_page	integer	query	Required. Items per page, 1–100
category_id	string	query	Only metric providers of this category (24-character hex id)
search	string	query	Case-insensitive substring match on name or description

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/oracle-metrics?page=1&per_page=20&search=togg' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "id": "6a5d0206379ebd02e53bf1a1",
      "category_id": "6a5d0206379ebd02e53bf0df",
      "type": "SHEET",
      "name": "Togg Şarj İstasyonu Metric Sheet",
      "description": "Google Sheets üzerinden yönetilen Togg şarj istasyonu token metrikleri",
      "integration": {
        "codes": [
          { "code": "TOGG1", "name": "Togg Şarj İstasyonu 1", "description": "İstanbul Ataşehir hızlı şarj istasyonu" },
          { "code": "TOGG2", "name": "Togg Şarj İstasyonu 2", "description": "Ankara Çankaya hızlı şarj istasyonu" }
        ],
        "fiat_currency": "TRY",
        "connection": {
          "url": "https://docs.google.com/spreadsheets/d/1Q9xWmT4kLp7RzV2sN8bYc3HdF6gJ0aEu5iO/export?format=csv&gid=0",
          "timeout": 30,
          "cache_ttl_seconds": 300,
          "auth": {
            "type": "NONE",
            "name": "",
            "username": "",
            "secret_set": false
          },
          "headers": []
        }
      },
      "created_at": "2026-07-19T16:57:42.876Z",
      "updated_at": "2026-07-19T16:57:42.876Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Response Fields

Field	Type	Description
data	array	Metric providers on this page. Each item has the shape described on Get Oracle Metric
total	integer	Number of metric providers matching the filters
page	integer	Page number sent in the request
per_page	integer	Page size sent in the request

Errors

Status	Code	Description
400	10015	Validation failed (page / per_page missing or out of range) — see details
400	10016	category_id is not a valid 24-character hex id

See Errors for the error format and common codes.