> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentwallex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido

> Integre AgentWallex en menos de 5 minutos — cree una billetera de agente y envíe su primer pago.

## Requisitos previos

* Node.js 18+ o Python 3.9+
* Una clave API de AgentWallex (`awx_...`) — [regístrese para acceso anticipado](https://agentwallex.com)
* Conocimiento básico de transacciones blockchain

## Instalación

<CodeGroup>
  ```bash npm theme={null}
  npm install @agentwallex/sdk
  ```

  ```bash yarn theme={null}
  yarn add @agentwallex/sdk
  ```

  ```bash pnpm theme={null}
  pnpm add @agentwallex/sdk
  ```

  ```bash pip theme={null}
  pip install agentwallex
  ```
</CodeGroup>

## Integración paso a paso

<Steps>
  <Step title="Inicializar el cliente">
    Cree un cliente AgentWallex con su clave API. Use `sandbox` para pruebas y `production` para mainnet.

    <CodeGroup>
      ```typescript TypeScript theme={null}
      import { AgentWallex } from "@agentwallex/sdk";

      const aw = new AgentWallex({
        apiKey: process.env.AGENTWALLEX_API_KEY!,
        environment: "sandbox", // use "production" for mainnet
      });
      ```

      ```python Python theme={null}
      from agentwallex import AgentWallex

      aw = AgentWallex(
          api_key=os.environ["AGENTWALLEX_API_KEY"],
          environment="sandbox",  # use "production" for mainnet
      )
      ```
    </CodeGroup>
  </Step>

  <Step title="Crear una billetera de agente">
    Cada agente obtiene su propia billetera con seguridad MPC y políticas configurables.

    <CodeGroup>
      ```typescript TypeScript theme={null}
      const agent = await aw.agents.create({
        name: "my-trading-agent",
        chain: "eip155:84532",
        policies: {
          maxTransactionAmount: "100",   // USDC
          dailyLimit: "1000",
          allowedAddresses: ["0x..."],
        },
      });

      console.log(`Agent ID: ${agent.id}`);
      console.log(`Wallet: ${agent.wallet.address}`);
      ```

      ```python Python theme={null}
      agent = await aw.agents.create(
          name="my-trading-agent",
          chain="eip155:84532",
          policies={
              "max_transaction_amount": "100",
              "daily_limit": "1000",
              "allowed_addresses": ["0x..."],
          },
      )

      print(f"Agent ID: {agent.id}")
      print(f"Wallet: {agent.wallet.address}")
      ```
    </CodeGroup>
  </Step>

  <Step title="Fondear la billetera">
    Envíe tokens de testnet a la dirección de billetera de su agente. En Base Sepolia, puede usar un [faucet](https://www.coinbase.com/faucets/base-ethereum-goerli-faucet) para obtener USDC de prueba.

    <Note>
      En modo sandbox, la billetera de su agente está en una testnet. No hay fondos reales en riesgo.
    </Note>
  </Step>

  <Step title="Enviar un pago">
    Ejecute un pago on-chain a través del agente.

    <CodeGroup>
      ```typescript TypeScript theme={null}
      const tx = await aw.payments.send({
        agentId: agent.id,
        to: "0xRecipientAddress",
        amount: "10.00",
        token: "USDC",
      });

      console.log(`Transaction hash: ${tx.hash}`);
      console.log(`Status: ${tx.status}`); // "confirmed"
      ```

      ```python Python theme={null}
      tx = await aw.payments.send(
          agent_id=agent.id,
          to="0xRecipientAddress",
          amount="10.00",
          token="USDC",
      )

      print(f"Transaction hash: {tx.hash}")
      print(f"Status: {tx.status}")  # "confirmed"
      ```
    </CodeGroup>
  </Step>
</Steps>

## Qué sucede internamente

1. **Verificación de políticas** — El motor de políticas valida la transacción contra las reglas de su agente (límites de gasto, lista blanca de direcciones, controles de velocidad).
2. **Firma MPC** — La transacción se firma mediante MPC de umbral 2-de-3. Ninguna parte individual posee jamás la clave completa.
3. **Difusión** — La transacción firmada se envía a la red.
4. **Confirmación** — AgentWallex monitorea y confirma la transacción, luego entrega un evento webhook.

## Próximos pasos

<CardGroup cols={2}>
  <Card title="SDK de TypeScript" icon="js" href="/es/sdks/typescript">
    Referencia completa del SDK con todos los métodos y tipos.
  </Card>

  <Card title="API REST" icon="code" href="/es/api-reference/overview">
    Endpoints HTTP para integraciones personalizadas.
  </Card>

  <Card title="Micropagos x402" icon="credit-card" href="/es/features/x402-micropayments">
    Habilite el pago por llamada a API para sus agentes.
  </Card>

  <Card title="Motor de políticas" icon="shield-check" href="/es/features/policy-engine">
    Configure controles de gasto y reglas de seguridad.
  </Card>
</CardGroup>