Primeros pasos

La suite de APIs de 0x es la forma más sencilla de habilitar un trading más rápido, mejores precios y una UX superior en tu app. Para comenzar, necesitarás configurar una cuenta para acceder al 0x Dashboard para generar API keys para nuevos proyectos, monitorear y gestionar integraciones, obtener acceso a nuevas APIs y aprovechar más recursos para desarrolladores.

¡Sigue estos pasos para comenzar en menos de 5 minutos!

1. Crear una cuenta de 0x​

Para crear una cuenta en el 0x Dashboard, haz clic en Sign Up, ingresa tu nombre, dirección de correo electrónico y contraseña, y haz clic en Continue

2. Crear un equipo​

Una vez verificado, se te pedirá que crees un equipo en 0x. Decide el nombre del equipo y selecciona el tipo de proyecto que estás construyendo. Puedes compartir esta cuenta con tus compañeros de equipo.

3. Recorrido por el Dashboard​

3.1 Test API Key​

Una vez que hayas creado un equipo, se te dirigirá al 0x Dashboard donde podrás crear y gestionar API keys en vivo, encontrar recursos de construcción y abrir solicitudes de soporte.

Para encontrar una lista de todas las redes soportadas por 0x, consulta la 0x Cheat Sheet.

Tu dashboard viene con una Test API key que puedes usar para realizar solicitudes de prueba. Pruébala insertándola en la solicitud curl y ejecutándola desde tu CLI para ver una solicitud de cotización de Swap API en vivo:

// Replace the API key in the header with your sample key
curl —location —request GET ‘https://api.0x.org/swap/v1/quote?buyToken=DAI&sellToken=ETH&sellAmount=100000&excludedSources=Kyber’ —header ‘0x-api-key: [api-key]’

3.2 Crear una App​

Haz clic en Create an app para obtener una API key en vivo que tenga acceso a múltiples productos de 0x.

En la ventana emergente, ingresa el nombre de tu app y qué productos de 0x (Swap API, Orderbook API) deben habilitarse para esta API key, luego haz clic en Continue.

Nota: Aún podrás actualizar los productos de 0x que esta clave puede desbloquear incluso después de que la app haya sido creada.

3.3 Añadir un 0x Explorer Tag​

In la siguiente pantalla, puedes añadir una etiqueta única (tag) que se puede usar para identificar los datos de transacción de tu app en 0x Explorer. Puedes usar la misma etiqueta para todas tus apps o crear una diferente para cada una.

0x Explorer proporciona datos sobre transacciones ERC-20 enrutadas a través de la 0x API. Es una herramienta confiable y transparente para ayudar a los desarrolladores y usuarios a verificar transacciones y analizar la actividad on-chain de forma sencilla y sin fricciones.

Más información sobre los 0x Explorer Tags.

Puedes omitir este paso por ahora y añadir una etiqueta más tarde.

3.4 Revelar tu API Key​

En la pantalla final, ¡copia tu API key! Esta clave es única y está vinculada a tu app. No la compartas. También puedes crear API keys adicionales para la app si las necesitas.

Tus API keys te permitirán autenticar solicitudes en 0x. Recuerda especificar la clave en tus solicitudes a través del parámetro de cabecera 0x-api-key:

Esta clave te permitirá autenticar solicitudes en 0x. Recuerda especificar la clave en tus solicitudes a través del parámetro de cabecera 0x-api-key:

// Replace the API key in the header with your sample key
curl —location —request GET ‘https://api.0x.org/swap/v1/quote?buyToken=DAI&sellToken=ETH&sellAmount=100000&excludedSources=Kyber’ —header ‘0x-api-key: [api-key]’

4. Gestionar tu App​

Desde la pantalla principal del dashboard, puedes ver todas las apps que has creado:

Haz clic en una App para abrir sus detalles.

Para cada App, puedes ver lo siguiente:

1. Ver qué productos de 0x están habilitados para tu API key - Swap API y/o Orderbook API.

2. Desde API Key, ver todas las API keys asociadas con esta app y crear o eliminar claves. Desde Settings, cambiar los productos de 0x habilitados para esta app. Configurar tu 0x Explorer Tag. Cambiar el App Name.

3. Si has configurado un 0x Explorer Tag, puedes ver tus datos on-chain y transacciones relacionadas con esta app.

4. Ver recursos de construcción.

5. Gestionar tu cuenta​

Puedes encontrar configuraciones adicionales para gestionar tu cuenta desde el avatar de tu cuenta en la esquina superior derecha.

• Settings - Puedes ver tu nombre completo, nombre de equipo y correo electrónico de la cuenta, así como cambiar tu contraseña.

• Contact Support - ¿Tienes alguna pregunta? Ponte en contacto con nuestro equipo de soporte para desarrolladores.

• Docs - Ve a nuestra documentación para desarrolladores y comienza a construir

• Help - ¿Necesitas ayuda? Consulta nuestras preguntas frecuentes y centro de ayuda.

• 0x Explorer - Si tienes configurada una etiqueta de 0x Explorer, analiza fácilmente la actividad on-chain y transacciones de tu app. Más información sobre el 0x Explorer Tag.

6. ¿Tienes alguna pregunta?​

Si has iniciado sesión en el 0x Dashboard, tienes una línea directa con nuestro equipo a través del chat de Intercom para soporte de desarrolladores en la esquina inferior derecha del dashboard.

7. Comienza a construir​

Ahora que tienes una API key en vivo, ¡sumérgete en nuestros recursos de construcción y comienza a construir!

Introducción a 0x

TIP

¿Prefieres ver un video? Ve a los 0x Concept Videos.

¿Qué es 0x?​

0x es la solución integral para que los desarrolladores construyan productos financieros sobre infraestructura cripto. 0x empodera a cientos de desarrolladores con herramientas Web3 esenciales para habilitar un trading más rápido, mejores precios y una UX superior. Nuestra suite de APIs ha procesado más de 52 millones de transacciones y $125B en volumen de más de 6 millones de usuarios que operan en apps como Coinbase Wallet, Robinhood Wallet, Metamask, Zerion, Zapper y más.

TIP

ELI5 0x (Explica 0x como si tuviera 5 años)​

0x es como un gran patio de recreo donde la gente puede intercambiar diferentes cosas como juguetes, dulces y calcomanías. Pero en lugar de juguetes y dulces, intercambian cosas digitales como criptomonedas. Hay dos tipos de personas en este patio de recreo: los que traen cosas para intercambiar (los llamamos Makers) y los que quieren intercambiar por esas cosas (los llamamos Takers). 0x ayuda a estas personas a encontrarse y realizar intercambios de manera segura y justa. Es como tener a un adulto vigilando el patio de recreo para asegurarse de que todos jueguen limpio.

El ecosistema de 0x​

0x Tech Stack​

Las APIs de nivel profesional de 0x están construidas sobre el 0x Protocol, un conjunto de smart contracts seguros y auditados. Las aplicaciones que construyen sobre estas herramientas forman parte del ecosistema de 0x.

El diagrama de abajo muestra una descripción general del ecosistema de 0x, que incluye aplicaciones que proveen liquidez (Makers) y aplicaciones que demandan liquidez (Takers).

Makers y Takers​

Dentro del ecosistema de 0x, hay dos partes: Makers y Takers:

Oferta (o Makers)​

Esta es la entidad que crea órdenes de 0x y provee liquidez al sistema para que la consuma la parte de la Demanda (Takers). 0x agrega liquidez de múltiples fuentes, incluyendo:

• Liquidez on-chain: DEXs, AMMs (por ejemplo, Uniswap, Curve, Bancor)

• Liquidez off-chain: Market Makers profesionales, la red Open Orderbook de 0x

• Documentación relevante:

• Market Makers - Market Making profesional con Limit Orders

• Orderbook API - Compartir Limit Orders

• Limit Orders (Advanced Traders) - Ejecución y gestión de Limit Orders

Demanda (o Takers)​

Esta es la entidad que quiere el activo del Maker. Los Takers aceptan intercambiar su activo por el del Maker; en otras palabras, consumen la liquidez de 0x. Algunos ejemplos incluyen proyectos como MetaMask, Coinbase y dydx.

• Documentación relevante:

• Swap API - El agregador de liquidez más eficiente para tokens ERC20 a través de una sola API.

¿Cómo funciona 0x?​

Veamos cómo se ejecuta una orden de 0x.

1. Un Maker crea una orden de 0x, la cual es un objeto JSON que cumple con un formato de mensaje de orden estándar (ver la lista de todos los tipos de órdenes de 0x aquí). Indica qué tipo de activo se compromete a intercambiar el Maker. Los activos pueden incluir tokens fungibles (ERC20), tokens no fungibles (ERC721) o conjuntos de activos (ERC1155).

2. La orden se hashea y el Maker firma la orden para comprometerse criptográficamente con la orden que creó.

3. La orden se comparte con las contrapartes.

4. Si el Maker de la orden de 0x ya conoce a su contraparte deseada, puede enviar la orden directamente (a través de correo electrónico, chat o una plataforma over-the-counter)

5. Si el Maker no conoce a una contraparte dispuesta a aceptar el intercambio, puede enviar la orden al orderbook.

6. La 0x API agrega liquidez de todas las fuentes de oferta (supply) para ofrecer el mejor precio de la orden al Taker. 0x ayuda a los traders a crear, encontrar y ejecutar las órdenes de 0x a través del paradigma de off-chain relay y on-chain settlement. Esto significa que 0x no almacena las órdenes en la blockchain; en su lugar, las órdenes se almacenan off-chain, y la liquidación de la operación solo ocurre on-chain. Esta característica única hace de 0x un protocolo DEX flexible y eficiente en el uso de gas (gas-efficient) para que los desarrolladores construyan sobre él.

7. El Taker ejecuta la orden de 0x enviando la orden y la cantidad con la que la completará a la blockchain.

8. La lógica de liquidación de 0x Protocol verifica la firma digital del Maker y que se cumplan todas las condiciones del intercambio. Si es así, los activos involucrados se intercambian de forma atómica (atomically swapped) entre el Maker y el Taker. De lo contrario, la transacción se revierte.

¿Qué puedo construir en 0x?​

A continuación se presenta una lista no exhaustiva de proyectos que se han construido sobre 0x. Ten en cuenta que 0x también se puede integrar en cualquier aplicación existente donde el intercambio no sea el propósito principal de la aplicación. Para ver más ejemplos, consulta esta publicación de blog.

Demanda (Takers)​

• Exchanges

• Un exchange descentralizado para el activo X en el mercado Y

• Un mercado estilo eBay para bienes digitales

• Una mesa de negociación over-the-counter (OTC)

• Wallets

• Wallets digitales cuyos usuarios desean intercambiar tokens

• Plataformas de opciones y derivados

• Un protocolo DeFi que necesita liquidez e intercambio para funcionar (por ejemplo, un protocolo de derivados, préstamos u opciones)

• Gestores de portafolio

• Mercados de predicción

• Exchange de tokens no fungibles (NFT)

• Mercado de NFTs (NFT marketplace)

• Juegos con monedas o ítems dentro del juego

• Estrategias de inversión (por ejemplo, fondos de índice DeFi, apps de DCA)

• Datos

• Portal de analítica multichain de 0x

• Panel de operaciones en tiempo real con wrappers de GraphQL

Oferta (Makers)​

• Modelos de orderbook

• Modelos de Automatic Market Makers (AMM)

• Market Makers

• Un bot de market making o de trading de arbitraje

Guías

Esta página enumera las guías más populares para comenzar a construir con 0x según tu caso de uso

Swap API​

Añade fácilmente agregación de liquidez a tu app con una sola API. Accede a más de 100 exchanges y miles de tokens con la Swap API.

Ejemplos de código​

• (Next.js) 0x Demo App - Ejemplo de aplicación de swap de ERC20 creada con 0x Swap API, Next.js y ConnectKit

• (HTML, CSS, Javascript) 0x Demo App

• https://github.com/0xProject/0x-starter-project - Un proyecto que muestra el protocolo 0x v4 a través de una colección de ejemplos ejecutables.

Tutoriales​

• Cómo usar la Swap API - Esta guía te enseñará cómo ejecutar programáticamente un intercambio de tokens ERC20.

• Construir una dApp de swap de tokens con Next.js, 0x y ConnectKit - Un recorrido en video que cubre conceptos clave para desarrolladores al construir cualquier dApp de swap de tokens.

• Cómo construir una dApp de swap de tokens con la 0x API - Contenido escrito y en video sobre cómo construir una dApp de swap de tokens (un Matcha.xyz simple) usando la Swap API. Esta dApp agrega liquidez a través del ecosistema DEX más amplio para ofrecer el mejor precio al usuario.

• Usar la liquidez de 0x API en tus Smart Contracts - Esta guía te enseñará cómo consumir cotizaciones de swap de 0x API desde un smart contract.

• Trabajar en la Testnet - Aprende dos formas de probar el swap de tokens ERC20 con la 0x API, ya sea usando la testnet Goerli o haciendo un fork de la mainnet de Ethereum en tu propia testnet. Incluye un ejemplo ejecutable.