# Harga Sederhana

**API:** Data API

**Endpoint:** `GET /v1/beta/coingecko/simple/price`

**Tags:** CoinGecko

Nama field dibangun dari mata uang kutipan — dengan `vs_currencies` disetel ke usd Anda mendapatkan `usd`, plus `usd_market_cap`, `usd_24h_vol`, `usd_24h_change`, dan `last_updated_at` saat flag `include_market_cap`, `include_24hr_vol`, `include_24hr_change`, dan `include_last_updated_at` yang sesuai disetel. Gunakan setiap kali id sudah diketahui dan hanya angka saat ini yang dibutuhkan. Untuk data peringkat, pasokan, atau tertinggi sepanjang masa gunakan `get_coingecko_coins_markets`; jika Anda memegang alamat kontrak alih-alih id gunakan `get_coingecko_simple_token_price_id`.

### Referensi harga

- Metering: Unit sumber daya paket.
- Estimasi referensi per permintaan: USD 0.008.
- Dasar biaya unit: USD 0.0.
- Unit sumber daya: `provider_credit`.
- Dasar biaya tidak menentukan harga pelanggan akhir, termasuk saat bernilai nol.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `ids` | query | no | string, default: "bitcoin" | ID koin, dipisahkan koma jika menanyakan lebih dari 1 koin. *merujuk ke [`/coins/list`](/reference/coins-list) |
| `include_24hr_change` | query | no | boolean | Sertakan persentase perubahan 24 jam. Default: false |
| `include_24hr_vol` | query | no | boolean | Sertakan volume perdagangan 24 jam. Default: false |
| `include_last_updated_at` | query | no | boolean | Sertakan waktu pembaruan harga terakhir sebagai timestamp UNIX. Default: false |
| `include_market_cap` | query | no | boolean | Sertakan kapitalisasi pasar. Default: false |
| `include_tokens` | query | no | string, enum: "top", "all" | Untuk pencarian `symbols`, tentukan `all` untuk menyertakan semua token yang cocok. Default `top` mengembalikan token berperingkat teratas berdasarkan kapitalisasi pasar atau volume. |
| `names` | query | no | string, default: "Bitcoin" | Nama koin, dipisahkan koma jika menanyakan lebih dari 1 koin. |
| `precision` | query | no | string, enum: "full", "0", "1", "2", "3", "4", … | Jumlah tempat desimal untuk nilai harga mata uang |
| `symbols` | query | no | string, default: "btc" | Simbol koin, dipisahkan koma jika menanyakan lebih dari 1 koin. |
| `vs_currencies` | query | yes | string, default: "usd" | Mata uang target koin, dipisahkan koma jika melakukan kueri untuk lebih dari 1 mata uang. *lihat [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies) |

## Responses

### 200 — Harga koin

Headers:
- `X-Request-Id` (string) — Pengenal permintaan yang harus disertakan saat menghubungi dukungan Felo.

**application/json**

Schema: `Response860C3Ae68Ea5_SimplePrice` (`#/components/schemas/Response860C3Ae68Ea5_SimplePrice`)

Example:

```json
{
  "bitcoin": {
    "usd": 76975,
    "usd_market_cap": 1542226908349.8406,
    "usd_24h_vol": 29096603418.89408,
    "usd_24h_change": -1.4093297098441402,
    "last_updated_at": 1779092258
  }
}
```

### 400 — Permintaan tidak dapat diproses. Periksa parameter permintaan.

### 401 — Kunci API Felo yang valid diperlukan.

### 402 — Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

### 403 — Akun tidak diizinkan melakukan operasi ini.

### 429 — Batas permintaan atau batas pengeluaran telah tercapai.

### 502 — Layanan tidak dapat menyelesaikan permintaan.

### 503 — API atau layanan penagihan untuk sementara tidak tersedia.

### 504 — Layanan kehabisan waktu saat memproses permintaan.

### default — Respons error; respons passthrough upstream dapat menggunakan format penyedia

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response860C3Ae68Ea5_SimplePrice

`#/components/schemas/Response860C3Ae68Ea5_SimplePrice`

```json
{
  "type": "object",
  "additionalProperties": {
    "type": "object",
    "properties": {
      "usd": {
        "type": "number",
        "description": "Harga dalam mata uang target"
      },
      "usd_market_cap": {
        "type": "number",
        "description": "Kapitalisasi pasar dalam mata uang target"
      },
      "usd_24h_vol": {
        "type": "number",
        "description": "Volume perdagangan 24 jam dalam mata uang target"
      },
      "usd_24h_change": {
        "type": "number",
        "description": "Persentase perubahan harga 24 jam dalam mata uang target"
      },
      "last_updated_at": {
        "type": "number",
        "description": "Stempel waktu pembaruan terakhir dalam detik UNIX"
      }
    }
  }
}
```
