# URL RPC de Base: acceso sin clave y ejemplos de curl y viem

> Source: https://docs.blockvectra.com/es/guides/base/

Empiece con la URL RPC pública de la red principal de Base que aparece a continuación para leer el chain ID sin API key. Consulte los métodos admitidos y los límites por IP en la [página de la cadena Base](https://blockvectra.com/es/chains/base_mainnet/); use una clave para los métodos permitidos por la cadena que no figuren en `public.methods`.

```bash
curl -sS "https://api.blockvectra.com/v1/base_mainnet/public" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'
```

## Información de la red y endpoints

Cada solicitud a Base identifica explícitamente la red de destino en la ruta de la URL mediante el slug `base_mainnet`. JSON-RPC admite tanto la autenticación con clave en la ruta como la autenticación mediante encabezado de solicitud (`x-api-key`).

| Parámetro / Endpoint | Valor / Plantilla | Autenticación |
|---|---|---|
| Chain ID (EIP-155) | `8453` | — |
| JSON-RPC (clave en la ruta) | `POST https://api.blockvectra.com/v1/base_mainnet/{api_key}` | API key en la ruta de la URL |
| JSON-RPC (clave en el encabezado) | `POST https://api.blockvectra.com/v1/base_mainnet` | Encabezado x-api-key: {api_key} |
| Base de Data API | `GET https://api.blockvectra.com/v1/data/base_mainnet/…` | Encabezado x-api-key: {api_key} |
| Estado público | `GET https://api.blockvectra.com/v1/status` | Sin autenticación (público) |

## Ejemplos directos de curl y viem

Puede realizar llamadas JSON-RPC directamente con curl o bibliotecas cliente web3 como viem. Defina su API key en la variable de entorno `BLOCKVECTRA_API_KEY`:

**curl (Header)**

Consulte el chain ID de EIP-155 mediante el encabezado de solicitud `x-api-key`:

```bash
curl -s "https://api.blockvectra.com/v1/base_mainnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'
```


  **curl (Path)**

Consulte el número del último bloque pasando su API key en la ruta de la URL:

```bash
curl -s "https://api.blockvectra.com/v1/base_mainnet/$BLOCKVECTRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'
```


  **TypeScript (viem)**

Conéctese mediante `createPublicClient` de viem y la definición oficial de la cadena `base`:

```ts
import { createPublicClient, http } from "viem";
import { base } from "viem/chains";

const client = createPublicClient({
  chain: base,
  transport: http("https://api.blockvectra.com/v1/base_mainnet", {
    fetchOptions: {
      headers: {
        "x-api-key": process.env.BLOCKVECTRA_API_KEY!,
      },
    },
  }),
});

const blockNumber = await client.getBlockNumber();
console.log("Current block number on Base:", blockNumber);
```

También puede pasar la clave en la ruta de la URL del transporte:

```ts
const client = createPublicClient({
  chain: base,
  transport: http(`https://api.blockvectra.com/v1/base_mainnet/${process.env.BLOCKVECTRA_API_KEY}`),
});
```

Plantilla inicial completa: [blockvectra/multichain-viem](https://github.com/blockvectra/multichain-viem)


### Estructura de la respuesta

Las respuestas siguen la especificación JSON-RPC 2.0:

* **Éxito**: Devuelve un objeto que contiene `jsonrpc: "2.0"`, un entero `id` coincidente y `result` codificado en hexadecimal (`eth_chainId` devuelve el chain ID codificado en hexadecimal; `eth_blockNumber` devuelve la altura del último bloque).
* **Métodos no permitidos**: Solicitar un método que no figure entre los permitidos por la red devuelve el código de error JSON-RPC `-32601` (`method not available`, no facturado).
* **Consultas fuera de la ventana**: Las solicitudes de estado histórico anteriores a la ventana de retención del estado devuelven el código de error JSON-RPC `-32011` (no facturado).
* **API key ausente**: Omitir la clave devuelve HTTP 401 con el código de error JSON-RPC `-32024` (`missing_api_key`, no facturado).
* **Parámetros no válidos**: Los parámetros de solicitud mal formados devuelven el código de error JSON-RPC `-32602` (no facturado).

## Capacidades y política de métodos

Valores en tiempo real: `GET /v1/chains` (`methods`, `max_logs_block_range`, `state_window_blocks`).

### Parámetros y límites de la red

- **Rango de bloques para eth_getLogs**: Máx. 1000 bloques por solicitud
- **Ventana de estado histórico**: Últimos 10000 bloques (consultas posteriores devuelven -32011)
- **Rastreo de ejecución (debug_trace*)**: No disponible

Métodos permitidos por cadena: [Cadenas compatibles](https://docs.blockvectra.com/en/chains/)

## Data API de blockchain

Valores en tiempo real: `GET /v1/chains` (`data`).

### Estado de Blockchain Data API

- **Disponible**: La Blockchain Data API está disponible en Base. Explora los conjuntos de datos compatibles en el directorio de conjuntos de datos. [Explorar directorio de conjuntos de datos](https://blockvectra.com/es/data/)

## Primeros pasos y API keys

Las cuentas nuevas reciben 30,000,000 CU al registrarse — sin tarjeta de crédito.

* **Consola web**: Regístrese mediante una firma de billetera Ethereum y genere una API key en la [Consola](https://console.blockvectra.com/login/?next=%2Fkeys%2F). Consulte la [guía de inicio rápido](https://docs.blockvectra.com/es/quickstart/) para obtener detalles de configuración.
* **Registro programático**: Los agentes autónomos de IA, los scripts automatizados y los pipelines de CI pueden iniciar sesión y aprovisionar API keys mediante firmas de billetera Ethereum (EIP-191) sin navegador. Siga la [guía de registro programático](https://docs.blockvectra.com/en/guides/programmatic-signup/).
* **Agentes de IA**: Los agentes autónomos de IA pueden descubrir las capacidades de Base mediante el servidor oficial del Model Context Protocol (MCP). Consulte [Conectar agentes de IA a BlockVectra](https://docs.blockvectra.com/es/guides/ai-agents/).
* **Ampliación de límites**: Tras una recarga, se elimina el límite de llamadas por segundo a nivel de cuenta; cada clave sigue sujeta a los límites de frecuencia y ráfaga de unidades de cómputo (CU). Para conocer las tarifas y unidades de facturación actuales, consulte la [página de Precios](https://blockvectra.com/es/pricing/).

## Guías y recursos relacionados

* **Documentación para desarrolladores de Base**: Para conocer las especificaciones de la red, la mecánica del gas y los contratos en Base, consulte la [documentación oficial de Base](https://docs.base.org).
* **RPC personalizado en billeteras**: Configure endpoints RPC personalizados para Base en MetaMask y Rabby mediante la [guía de RPC personalizado en billeteras](https://docs.blockvectra.com/es/guides/wallet-custom-rpc/).
* **Simulación de transacciones**: Pruebe la ejecución de transacciones y evalúe los cambios de estado antes de transmitirlas mediante `eth_simulateV1` en la [guía de simulación de transacciones](https://docs.blockvectra.com/en/guides/simulate-transactions/).

## Próximos pasos

* [Explore el catálogo de conjuntos de datos](https://blockvectra.com/es/data/) para ver todos los conjuntos de datos que indexa BlockVectra.
* [Consulte el plan gratuito y los precios](https://blockvectra.com/es/pricing/#free) para comprobar qué incluye su cuenta.
* [Inicie sesión en la consola](https://console.blockvectra.com/login/?next=%2Fkeys%2F) para crear una API key.