# Analizador de BestChange

**BestChange Parser** — es una herramienta que rastrea automáticamente las posiciones de tu cambiador en el monitoreo de BestChange y ajusta la tasa de cambio para mantener la posición de ranking deseada.

Después de la configuración el sistema:

* obtiene las tasas actuales de BestChange a través de la API
* encuentra la posición de tu cambiador entre los competidores
* ajusta automáticamente la tasa para mantener la posición especificada

Por ejemplo:

Si especificaste **Posición objetivo = 6**, el sistema hará que la tasa **sea 0,0001% mejor**que la del cambiador que actualmente está en **6.º lugar**.

Así usted **mantendrá automáticamente la posición deseada en la lista de BestChange** sin cambiar las tasas manualmente.

## Pestaña General

En esta pestaña se realizan **las configuraciones globales del parser**.

### Habilitar Parser

**Habilitar Parser** — el interruptor global para el funcionamiento del parser.

Valores posibles:

* **Sí** — el parser está habilitado y en funcionamiento
* **No** — el parser está deshabilitado

Si el interruptor está apagado — el parser **no procesará ninguna dirección**, incluso si están activas.

### Clave API de BestChange

**Clave API de BestChange** — la clave de acceso para la API de BestChange.

A través de esta clave el sistema recibe:

* la lista de monedas
* la lista de cambiadores
* tasas actuales
* posiciones de los cambiadores

#### Dónde obtener la clave API

La clave API se emite en la cuenta personal y está descrita en la documentación de la API de BestChange.

<figure><img src="https://1953675968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0ow3kIXHQDcl9DBdYiM%2Fuploads%2FBNknY2SOu0ZGp2fkYDBQ%2F%D0%97%D0%BD%D1%96%D0%BC%D0%BE%D0%BA%20%D0%B5%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-03-10%20%D0%BE%2011.04.38.png?alt=media&#x26;token=48fddbd0-e865-4dd1-ac65-7cd78b1dc3b3" alt=""><figcaption></figcaption></figure>

Ejemplo de una clave de prueba:

```
20cfsnaf25501bscjdsadodsowe255es
```

Ejemplo de solicitud:

```
https://www.bestchange.app/v2/20cfsnaf25501bscjdsadodsowe255es/currencies/
```

Documentación de la API:\
<https://www.bestchange.app/>

### Tu ID de cambiador en BestChange

**ID de cambiador** — es el identificador único de tu cambiador en el sistema BestChange.

Es necesario para que el parser:

* determine **tu cambiador en la lista**
* determine **tu posición actual**
* comparar correctamente las tasas con los competidores

#### Dónde encontrar tu ID de cambiador

Puedes obtener el ID a través de la API de BestChange.

Abre el enlace:

```
https://www.bestchange.app/v2/YOUR_API_KEY/changers/
```

Ejemplo:

```
https://www.bestchange.app/v2/20cfsnaf25501bscjdsadodsowe255es/changers/
```

La respuesta de la API contendrá una lista de cambiadores, por ejemplo:

```
{
 "id": 1234,
 "name": "YourExchange"
}
```

El número **id** es tu **ID de cambiador**, que debe especificarse en el panel de administración.

## Pestaña Direcciones

En la **pestaña Direcciones** configuras las direcciones de cambio para las cuales el parser operará.

Puedes añadir **un número ilimitado de direcciones**.

### Dirección

**Dirección** — la dirección de cambio para la cual el parser operará.

Ejemplo:

```
USDCERC20 -> BTC
```

Esto significa:

* entregamos **USDC ERC-20**
* recibimos **BTC**

El parser analizará **a los competidores específicamente para esta dirección** en BestChange.

### Posición objetivo (1–40)

**Posición objetivo** — la posición en el ranking de BestChange que debe mantenerse.

Rango permitido:

```
1 — 40
```

Ejemplo:

```
2
```

Esto significa:

el sistema cambiará automáticamente la tasa para que tu cambiador esté **en segundo lugar**.

Algoritmo de funcionamiento:

1. el parser obtiene la lista de cambiadores para la dirección
2. determina la tasa del cambiador en la posición requerida
3. establece la tasa **0,0001% más favorable**
4. actualiza la tasa una vez por minuto

### Activo

**Activo** — enciende o apaga el parser para una dirección específica.

Valores posibles:

* **Sí** — el parser está en funcionamiento
* **No** — la dirección se ignora

Importante:

Incluso si la dirección está activa, el parser **no funcionará**, si el interruptor global **Habilitar Parser = No**.

## Cómo funciona el parser

Algoritmo de funcionamiento:

1. Se inicia una tarea cron.
2. El sistema envía una solicitud a la API de BestChange.
3. Recibe la lista de tasas para la dirección.
4. Determina la posición de tu cambiador.
5. Si la posición es peor (más baja) que la especificada — el sistema ajusta la tasa.

Todas las acciones se registran en la tabla:

```
HistoryExecution
```

Almacena:

* hora de ejecución
* dirección
* tasas obtenidas
* nueva posición
* cambios de tasa

Esto permite **hacer un seguimiento del funcionamiento del parser y del historial de cambios**.

## Costo del plugin

El plugin **BestChange Parser** es de pago.

Costo:

```
$40 / mes
```

También disponible **un periodo de prueba gratuito de 14 días**.
