Get Oracle

Returns one price oracle with its connection. The auth secret is never returned: integration.connection.auth.secret_set only says whether one is stored. A deleted oracle is not found.

Required permission: oracle:view

Request

GET /v2/admin/oracles/{oracle_id}

Parameters

Name	Type	In	Description
oracle_id	string	path	Required. Oracle id (24-character hex)

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/oracles/677ed6e3cc111aea14a3dfc3' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "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", "description": "Silver fund, second share class" }
    ],
    "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"
}

Response Fields

Field	Type	Description
id	string	Oracle id
category_id	string	Category the oracle belongs to
type	string	Source type: TEFAS, TOGG or SHEET (a published spreadsheet)
name	string	Oracle name
description	string	Description
integration	object	Source configuration
integration.codes	array	The series this oracle can price, each addressed by its code
integration.codes[].code	string	Code the source knows the series by (e.g. a fund code)
integration.codes[].name	string	Display name of the series
integration.codes[].description	string	Description of the series. Omitted when not set
integration.fiat_currency	string	ISO 4217 code of the currency the source prices in (e.g. TRY)
integration.connection	object	Where the oracle reads from
integration.connection.url	string	Base URL of the source
integration.connection.timeout	integer	Request timeout in seconds. 0 means the default (30)
integration.connection.cache_ttl_seconds	integer	How long a fetched source document is reused within one server process. 0 disables this cache
integration.connection.auth.type	string	NONE, BEARER, API_KEY, BASIC or QUERY_PARAM
integration.connection.auth.name	string	Header (API_KEY) or query parameter (QUERY_PARAM) the secret travels in
integration.connection.auth.username	string	Username (BASIC only)
integration.connection.auth.secret_set	boolean	Whether a secret is stored. The secret itself is never returned
integration.connection.headers	array	Static headers sent with every request, returned in clear text
integration.connection.headers[].name	string	Header name
integration.connection.headers[].value	string	Header value
integration.summary_cache_ttl_seconds	integer	How long a computed summary is cached, in seconds. 0 means the platform default
integration.default_summary_cache_ttl_seconds	integer	The platform default summary cache window (43200, 12 hours)
created_at	string	Creation time (ISO 8601)
updated_at	string	Last update time (ISO 8601)

Errors

Status	Code	Description
400	10000	oracle_id is not a valid 24-character hex id (this endpoint reports a malformed id with the generic code, not 10016)
400	10001	Oracle not found or deleted (domain 5)

See Errors for the error format and common codes.