# Lista de exchanges

**API:** Data API

**Endpoint:** `GET /v1/beta/coingecko/exchanges`

**Tags:** CoinGecko

Um diretório paginado de exchanges ativas com `id`, `name`, `year_established`, `country`, `description`, `url`, `image`, `trust_score`, `trust_score_rank`, `trade_volume_24h_btc` e `has_trading_incentive`. Pagine com `per_page` e `page`. Use para classificar ou filtrar exchanges por confiança e volume. Se precisar apenas do mapeamento de identificadores, `get_coingecko_exchanges_list` retorna todas sem dados de mercado e sem paginação; para uma exchange completa, use `get_coingecko_exchanges_id`.

### Pricing reference

- Medição: unidades de recursos do plano.
- Estimativa de referência por requisição: USD 0.008.
- Base de custo unitário: USD 0.0.
- Unidade de recurso: `provider_credit`.
- As bases de custo não definem o preço final do cliente, inclusive quando forem zero.

Apenas metadados de referência, não uma cotação da conta, um preço garantido nem um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da 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 |
| --- | --- | --- | --- | --- |
| `page` | query | no | number | Percorre os resultados por página. Padrão: 1 |
| `per_page` | query | no | number | Total de resultados por página. Padrão: 100. Valores válidos: 1...250 |

## Responses

### 200 — Lista de exchanges com dados

Headers:
- `X-Request-Id` (string) — Identificador da requisição a incluir ao contatar o suporte da Felo.

**application/json**

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

Example:

```json
[
  {
    "id": "gdax",
    "name": "Coinbase Exchange",
    "year_established": 2012,
    "country": "United States",
    "description": "Uma exchange líder sediada nos EUA, conhecida por sua conformidade regulatória, interface amigável e suporte a transações de moeda fiduciária para criptomoedas.",
    "url": "https://www.coinbase.com/",
    "image": "https://coin-images.coingecko.com/markets/images/23/small/Coinbase_Coin_Primary.png?1706864258",
    "has_trading_incentive": false,
    "trust_score": 10,
    "trust_score_rank": 1,
    "trade_volume_24h_btc": 13692.36253111657
  },
  {
    "id": "binance",
    "name": "Binance",
    "year_established": 2017,
    "country": "Cayman Islands",
    "description": "Uma das maiores exchanges de criptomoedas do mundo em volume de negociação.",
    "url": "https://www.binance.com/",
    "image": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274",
    "has_trading_incentive": false,
    "trust_score": 10,
    "trust_score_rank": 2,
    "trade_volume_24h_btc": 95140.00808634966
  }
]
```

### 400 — Não foi possível processar a requisição. Verifique os parâmetros da requisição.

### 401 — É necessária uma chave de API da Felo válida.

### 402 — A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.

### 403 — A conta não tem permissão para realizar esta operação.

### 429 — Um limite de requisições ou de gastos foi atingido.

### 502 — O serviço não pôde concluir a requisição.

### 503 — A API ou o serviço de cobrança está temporariamente indisponível.

### 504 — O serviço atingiu o tempo limite ao processar a requisição.

### default — Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response860C3Ae68Ea5_Exchanges

`#/components/schemas/Response860C3Ae68Ea5_Exchanges`

```json
{
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "id",
      "name",
      "year_established",
      "country",
      "description",
      "url",
      "image",
      "has_trading_incentive",
      "trust_score",
      "trust_score_rank",
      "trade_volume_24h_btc"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "ID da exchange"
      },
      "name": {
        "type": "string",
        "description": "Nome da exchange"
      },
      "year_established": {
        "type": [
          "number",
          "null"
        ],
        "description": "Ano de fundação da exchange"
      },
      "country": {
        "type": [
          "string",
          "null"
        ],
        "description": "País onde a exchange está sediada"
      },
      "description": {
        "type": "string",
        "description": "Descrição da exchange"
      },
      "url": {
        "type": "string",
        "description": "URL do site da exchange"
      },
      "image": {
        "type": "string",
        "description": "URL do logo da exchange"
      },
      "has_trading_incentive": {
        "type": "boolean",
        "description": "Indica se a exchange tem incentivo de negociação"
      },
      "trust_score": {
        "type": [
          "number",
          "null"
        ],
        "description": "Pontuação de confiança da exchange"
      },
      "trust_score_rank": {
        "type": [
          "number",
          "null"
        ],
        "description": "Classificação da pontuação de confiança da exchange"
      },
      "trade_volume_24h_btc": {
        "type": "number",
        "description": "Volume de negociação da exchange em 24h em BTC"
      }
    }
  }
}
```
