List Oracles

Lists price oracles across every category, newest first, optionally narrowed to one category or by a text search. A price oracle is a configured external source (a fund-price API, a published spreadsheet) that the tokenization form reads an asset's name and price from; see Get Oracle 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/oracles

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 oracles 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/oracles?page=1&per_page=20&category_id=677ed6e3cc111aea14a3dfb4' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "id": "677ed6e3cc111aea14a3dfc3",
      "category_id": "677ed6e3cc111aea14a3dfb4",
      "type": "TEFAS",
      "name": "Gümüş Fonu",
      "description": "TEFAS Gümüş Fonu",
      "integration": {
        "codes": [
          { "code": "IOG", "name": "Gümüş Fonu" },
          { "code": "GTZ", "name": "Gümüş Fonu" }
        ],
        "fiat_currency": "TRY",
        "connection": {
          "url": "https://tefas-api.p.rapidapi.com",
          "timeout": 30,
          "cache_ttl_seconds": 0,
          "auth": {
            "type": "API_KEY",
            "name": "x-rapidapi-key",
            "username": "",
            "secret_set": true
          },
          "headers": [
            { "name": "x-rapidapi-host", "value": "tefas-api.p.rapidapi.com" }
          ]
        },
        "summary_cache_ttl_seconds": 0,
        "default_summary_cache_ttl_seconds": 43200
      },
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2026-10-27T09:12:31.004Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Response Fields

Field	Type	Description
data	array	Oracles on this page. Each item has the shape described on Get Oracle
total	integer	Number of oracles 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.