# Precio de la moneda por dirección del token

**API:** Data API

**Endpoint:** `GET /v1/beta/coingecko/simple/token_price/{id}`

**Tags:** CoinGecko

Consulta de precios por dirección de contrato on-chain en lugar de por id de CoinGecko. `id` es la plataforma de activos, `contract_addresses` una lista de direcciones de token separada por comas y `vs_currencies` la moneda de cotización. Devuelve un mapa con clave en la dirección de contrato en minúsculas cuyos nombres de campo se construyen a partir de la moneda de cotización: `usd`, más `usd_market_cap`, `usd_24h_vol`, `usd_24h_change` y `last_updated_at` cuando los flags correspondientes `include_market_cap`, `include_24hr_vol`, `include_24hr_change` e `include_last_updated_at` están definidos. Úsalo cuando tengas una dirección y ningún id. Para el perfil completo del token usa `get_coingecko_token_data`; si ya tienes el id de CoinGecko usa `get_coingecko_simple_price`.

### Pricing reference

- Medición: unidades de recursos del plan.
- Estimación de referencia por solicitud: USD 0.008.
- Base de costo unitario: USD 0.0.
- Unidad de recurso: `provider_credit`.
- Las bases de costo no determinan el precio final del cliente, incluso cuando son cero.

Solo metadatos de referencia; no son una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de 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 |
| --- | --- | --- | --- | --- |
| `id` | path | yes | string, default: "ethereum" | ID de la plataforma de activos. *consulta [`/asset_platforms`](/reference/asset-platforms-list) |
| `contract_addresses` | query | yes | string, default: "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599" | Direcciones de contrato del token, separadas por comas si consultas más de 1 token |
| `include_24hr_change` | query | no | boolean | Incluye el porcentaje de variación en 24 horas. Predeterminado: false |
| `include_24hr_vol` | query | no | boolean | Incluye el volumen de negociación en 24 horas. Predeterminado: false |
| `include_last_updated_at` | query | no | boolean | Incluye la hora de la última actualización del precio como marca temporal UNIX. Predeterminado: false |
| `include_market_cap` | query | no | boolean | Incluye la capitalización de mercado. Predeterminado: false |
| `precision` | query | no | string, enum: "full", "0", "1", "2", "3", "4", … | Posiciones decimales para el valor del precio en la moneda |
| `vs_currencies` | query | yes | string, default: "usd" | Moneda de referencia de las monedas, separada por comas si consultas más de 1 moneda. *consulta [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies) |

## Responses

### 200 — Precios de tokens

Headers:
- `X-Request-Id` (string) — Identificador de la solicitud que se debe incluir al contactar con el soporte de Felo.

**application/json**

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

Example:

```json
{
  "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599": {
    "usd": 76721,
    "usd_market_cap": 9008047197.715635,
    "usd_24h_vol": 181232010.10689816,
    "usd_24h_change": -1.6069562341774564,
    "last_updated_at": 1779094527
  }
}
```

### 400 — No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.

### 401 — Se requiere una clave de API de Felo válida.

### 402 — La solicitud no puede continuar porque no se cumple un requisito de facturación.

### 403 — La cuenta no tiene permiso para realizar esta operación.

### 429 — Se ha alcanzado un límite de solicitudes o de gasto.

### 502 — El servicio no pudo completar la solicitud.

### 503 — La API o el servicio de facturación no están disponibles temporalmente.

### 504 — El servicio agotó el tiempo de espera al procesar la solicitud.

### default — Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response860C3Ae68Ea5_SimplePrice

`#/components/schemas/Response860C3Ae68Ea5_SimplePrice`

```json
{
  "type": "object",
  "additionalProperties": {
    "type": "object",
    "properties": {
      "usd": {
        "type": "number",
        "description": "Precio en la moneda de destino"
      },
      "usd_market_cap": {
        "type": "number",
        "description": "Capitalización de mercado en la moneda de destino"
      },
      "usd_24h_vol": {
        "type": "number",
        "description": "Volumen de negociación en 24 horas en la moneda de destino"
      },
      "usd_24h_change": {
        "type": "number",
        "description": "Porcentaje de variación de precio en 24 horas en la moneda de destino"
      },
      "last_updated_at": {
        "type": "number",
        "description": "Marca temporal de la última actualización en segundos UNIX"
      }
    }
  }
}
```
