# Senarai Syiling (Peta ID)

**API:** Data API

**Endpoint:** `GET /v1/beta/coingecko/coins/list`

**Tags:** CoinGecko

Peta pengecam CoinGecko penuh: setiap syiling tersenarai sebagai `id`, `symbol` dan `name`. Gunakan sekali untuk menyelesaikan ticker menjadi `id` yang diperlukan oleh setiap alat CoinGecko lain — `bitcoin`, bukan BTC. Tetapkan `include_platform` untuk turut mendapatkan alamat kontrak setiap syiling setiap rantai. Ambil perhatian saiznya: ini memulangkan kira-kira 18,000 entri dan mengambil beberapa saat, jadi cache dan jangan memanggilnya bagi setiap carian. Jika anda sudah tahu id dan hanya mahu nombor, panggil `get_coingecko_simple_price` terus; untuk mengenal pasti syiling daripada alamat kontrak, gunakan `get_coingecko_token_data`.

### Rujukan harga

- Pemeteran: Unit sumber pelan.
- Anggaran rujukan setiap permintaan: USD 0.008.
- Asas kos unit: USD 0.0.
- Unit sumber: `provider_credit`.
- Asas kos tidak menentukan harga pelanggan akhir, termasuk apabila sifar.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan 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 |
| --- | --- | --- | --- | --- |
| `include_platform` | query | no | boolean | Sertakan alamat kontrak platform dan token. Lalai: false |
| `status` | query | no | string, enum: "active", "inactive" | Tapis mengikut status syiling. Lalai: active |

## Responses

### 200 — Senarai syiling

Headers:
- `X-Request-Id` (string) — Pengecam permintaan untuk disertakan semasa menghubungi sokongan Felo.

**application/json**

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

Example:

```json
[
  {
    "id": "official-trump",
    "symbol": "trump",
    "name": "Official Trump",
    "platforms": {
      "solana": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
    }
  },
  {
    "id": "ondo-finance",
    "symbol": "ondo",
    "name": "Ondo",
    "platforms": {
      "ethereum": "0xfaba6f8e4a5e8ab82f62fe7c39859fa577269be3"
    }
  }
]
```

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

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

### 402 — Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.

### 403 — Akaun tidak dibenarkan melakukan operasi ini.

### 429 — Had permintaan atau had perbelanjaan telah dicapai.

### 502 — Perkhidmatan tidak dapat menyelesaikan permintaan.

### 503 — API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.

### 504 — Perkhidmatan tamat masa semasa memproses permintaan.

### default — Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response860C3Ae68Ea5_CoinsList

`#/components/schemas/Response860C3Ae68Ea5_CoinsList`

```json
{
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "id",
      "symbol",
      "name"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "ID syiling"
      },
      "symbol": {
        "type": "string",
        "description": "Simbol syiling"
      },
      "name": {
        "type": "string",
        "description": "Nama syiling"
      },
      "platforms": {
        "type": "object",
        "description": "Platform aset dan alamat kontrak",
        "additionalProperties": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    }
  }
}
```
