Guides

Начало работы с 0x.org

· 9 мин чтения

Начало работы

Набор API от 0x — это самый простой способ обеспечить более быструю торговлю, лучшие цены и превосходный UX в вашем приложении. Чтобы начать работу, вам потребуется создать аккаунт для доступа к 0x Dashboard, чтобы генерировать API keys для новых проектов, отслеживать и управлять интеграциями, получать доступ к новым API и использовать дополнительные ресурсы для разработчиков.

Выполните следующие шаги, чтобы начать работу менее чем за 5 минут!

1. Создайте аккаунт 0x​

Чтобы создать аккаунт в 0x Dashboard, нажмите Sign Up, введите свое имя, адрес электронной почты и пароль, а затем нажмите Continue

2. Создайте команду​

После верификации вам будет предложено создать команду в 0x. Выберите название команды и укажите тип проекта, который вы создаете. Вы можете поделиться этим аккаунтом со своими коллегами.

3. Обзор Dashboard​

3.1 Тестовый API key​

После создания команды вы попадете в 0x Dashboard, где сможете создавать и управлять рабочими API keys, находить ресурсы для разработки и отправлять запросы в службу поддержки.

Чтобы найти список всех сетей, поддерживаемых 0x, ознакомьтесь с 0x Cheat Sheet.

В вашей панели управления уже есть тестовый API key, который можно использовать для тестовых запросов. Попробуйте вставить его в curl-запрос и запустить его из вашего CLI, чтобы увидеть реальный запрос котировки Swap API:

// 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 Создайте приложение​

Нажмите Create an app, чтобы получить рабочий API key с доступом к нескольким продуктам 0x.

В появившемся окне введите название вашего приложения и выберите, какие продукты 0x (Swap API, Orderbook API) должны быть включены для этого API key, затем нажмите Continue.

Примечание: Вы сможете изменить список продуктов 0x, доступных для этого ключа, даже после создания приложения.

3.3 Добавьте 0x Explorer Tag​

На следующем экране вы можете добавить уникальный тег, который будет использоваться для идентификации данных о транзакциях вашего приложения на 0x Explorer. Вы можете использовать один и тот же тег для всех ваших приложений или создать отдельный для каждого.

0x Explorer предоставляет данные о транзакциях ERC-20, маршрутизируемых через 0x API. Это надежный и прозрачный инструмент, помогающий разработчикам и пользователям проверять транзакции и анализировать on-chain активность простым и удобным способом.

Узнать больше о 0x Explorer Tags.

Вы можете пропустить этот шаг и добавить тег позже.

3.4 Отобразите ваш API key​

На финальном экране скопируйте ваш API key! Этот ключ уникален и привязан к вашему приложению. Не передавайте его никому. Вы также можете создать дополнительные API keys для приложения, если они вам понадобятся.

Ваши API keys позволят вам аутентифицировать запросы к 0x. Не забудьте указать ключ в ваших запросах через параметр заголовка 0x-api-key:

Этот ключ позволит вам аутентифицировать запросы к 0x. Не забудьте указать ключ в ваших запросах через параметр заголовка 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. Управление вашим приложением​

На главном экране панели управления вы можете увидеть все созданные вами приложения:

Нажмите на приложение, чтобы открыть подробную информацию о нем.

Для каждого приложения вы можете увидеть следующее:

  1. Посмотреть, какие продукты 0x включены для вашего API key — Swap API и/или Orderbook API.

  2. В разделе API Key вы можете увидеть все API keys, связанные с этим приложением, а также создавать или удалять ключи. В разделе Settings вы можете изменить продукты 0x, включенные для этого приложения, настроить ваш 0x Explorer Tag и изменить App Name.

  3. Если вы настроили 0x Explorer Tag, вы сможете просматривать ваши on-chain данные и транзакции, связанные с этим приложением.

  4. Просматривать ресурсы для разработки.

5. Управление вашим аккаунтом​

Дополнительные настройки для управления аккаунтом можно найти, нажав на аватар вашего аккаунта в правом верхнем углу.

  • Settings — вы можете увидеть ваше полное имя, название команды и адрес электронной почты аккаунта, а также изменить пароль.

  • Contact Support — есть вопросы? Свяжитесь с нашей службой поддержки разработчиков.

  • Docs — перейдите в нашу документацию для разработчиков и начните создавать проекты.

  • Help — нужна помощь? Ознакомьтесь с часто задаваемыми вопросами и справочным центром.

  • 0x Explorer — если вы настроили тег 0x Explorer, вы можете легко анализировать on-chain активность и транзакции вашего приложения. Узнать больше о 0x Explorer Tag.

6. Есть вопросы?​

Если вы вошли в 0x Dashboard, у вас есть прямая связь с нашей командой через Intercom Messenger для поддержки разработчиков в правом нижнем углу панели управления.

7. Начните разработку​

Теперь, когда у вас есть рабочий API key, погрузитесь в наши ресурсы для разработки и начинайте создавать!

Введение в 0x

ПОДСКАЗКА

Предпочитаете посмотреть видео? Перейдите к 0x Concept Videos.

Что такое 0x?​

0x — это универсальный инструмент для разработчиков, предназначенный для создания финансовых продуктов на криптовалютной инфраструктуре. 0x предоставляет сотням разработчиков ключевые web3-инструменты для обеспечения более быстрой торговли, лучших цен и превосходного UX. Наш набор API обработал более 52 миллионов транзакций с объемом торгов свыше $125B от более чем 6 миллионов пользователей, торгующих в таких приложениях, как Coinbase Wallet, Robinhood Wallet, MetaMask, Zerion, Zapper и др.

ПОДСКАЗКА

ELI5 0x (Объясните 0x, как будто мне 5 лет)​

0x похож на большую детскую площадку, где люди могут обмениваться различными вещами, например игрушками, конфетами и наклейками. Но вместо игрушек и конфет они обмениваются цифровыми активами, такими как криптовалюты. На этой площадке есть два типа людей: те, кто приносит вещи для обмена (мы называем их Makers), и те, кто хочет обменять свои вещи на них (мы называем их Takers). 0x помогает этим людям находить друг друга и совершать сделки безопасным и честным путем. Это как взрослый, который присматривает за площадкой, чтобы все играли по правилам.

Экосистема 0x​

Технологический стек 0x​

Профессиональные API от 0x построены на базе 0x Protocol — набора безопасных, прошедших аудит смарт-контрактов. Приложения, созданные с использованием этих инструментов, являются частью экосистемы 0x.

На диаграмме ниже показан обзор экосистемы 0x, которая включает приложения, поставляющие ликвидность (Makers), и приложения, потребляющие ликвидность (Takers).

Makers и Takers​

В экосистеме 0x есть две стороны — Makers и Takers:

Предложение (или Makers)​

Это сторона, которая создает 0x ордера и предоставляет ликвидность в систему для потребления стороной спроса (Takers). 0x агрегирует ликвидность из множества источников, включая:

  • On-chain ликвидность — DEX, AMM (например, Uniswap, Curve, Bancor)

  • Off-chain ликвидность — профессиональные маркет-мейкеры, сеть Open Orderbook от 0x

  • Соответствующая документация:

  • Market Makers — профессиональный маркет-мейкинг с лимитными ордерами

  • Orderbook API — совместное использование лимитных ордеров

  • Limit Orders (Advanced Traders)() — исполнение и управление лимитными ордерами

Спрос (или Takers)​

Это сторона, которая хочет получить актив Maker. Takers соглашаются обменять свой актив на актив Maker; другими словами, они потребляют ликвидность 0x. Примерами являются такие проекты, как MetaMask, Coinbase и dydx.

  • Соответствующая документация:

  • Swap API — наиболее эффективный агрегатор ликвидности для токенов ERC20 через единый API.

Как работает 0x?​

Давайте посмотрим, как исполняется ордер 0x.

  1. Maker создает ордер 0x, который представляет собой объект json, соответствующий стандартному формату сообщений ордеров (см. список всех типов ордеров 0x здесь). Он указывает, каким активом Maker готов торговать. Активы могут включать взаимозаменяемые токены (ERC20), невзаимозаменяемые токены (ERC721) или наборы активов (ERC1155).

  2. Ордер хэшируется, и Maker подписывает его, чтобы криптографически подтвердить созданный им ордер.

  3. Ордер передается контрагентам.

  4. Если Maker ордера 0x уже знает своего контрагента, он может отправить ордер напрямую (по электронной почте, в чате или через внебиржевую (OTC) платформу)

  5. Если Maker не знает контрагента, готового совершить сделку, он может отправить ордер в книгу ордеров (orderbook).

  6. 0x API агрегирует ликвидность изо всех источников предложения, чтобы предложить Taker лучшую цену для ордера. 0x помогает трейдерам создавать, находить и исполнять ордера 0x с помощью парадигмы off-chain ретрансляции и on-chain расчетов. Это означает, что 0x не хранит ордера в блокчейне; вместо этого ордера хранятся off-chain, а расчет по сделкам происходит on-chain. Эта уникальная особенность делает 0x гибким и экономичным по газу (gas-efficient) DEX-протоколом для разработки приложений.

  7. Taker исполняет ордер 0x, отправляя сам ордер и сумму, на которую он будет исполнен, в блокчейн.

  8. Логика расчетов 0x Protocol проверяет цифровую подпись Maker и выполнение всех условий сделки. Если все условия соблюдены, участвующие активы автоматически обмениваются (atomically swapped) между Maker и Taker. В противном случае транзакция отменяется (reverted).

Что я могу создать на базе 0x?​

Ниже приведен неполный список проектов, созданных на базе 0x. Обратите внимание, что 0x также можно интегрировать в любое существующее приложение, где обмен не является основной функцией. Дополнительные примеры можно найти в этой статье в блоге.

Спрос (Takers)​

  • Биржи

  • Децентрализованная биржа для актива X на рынке Y

  • Маркетплейс для цифровых товаров в стиле Ebay

  • Платформа для внебиржевой торговли (OTC)

  • Кошельки

  • Цифровые кошельки, пользователи которых хотят обменивать токены

  • Платформа опционов и деривативов

  • DeFi-протокол, которому для работы требуются ликвидность и обмен (например, протокол деривативов, кредитования или опционов)

  • Управление портфелем

  • Рынки предсказаний

  • Биржи невзаимозаменяемых токенов (NFT)

  • NFT-маркетплейс

  • Игры с внутриигровой валютой или предметами

  • Инвестиционные стратегии (например, индексные DeFi-фонды, приложения для DCA)

  • Данные

  • Мультичейн аналитический портал 0x

  • Панель сделок в реальном времени с обертками GraphQL

Предложение (Makers)​

  • Модели книги ордеров (orderbook)

  • Модели автоматических маркет-мейкеров (AMM)

  • Маркет-мейкеры

  • Бот для маркет-мейкинга или арбитражной торговли

Руководства

На этой странице собраны наиболее популярные руководства по началу работы с 0x в зависимости от ваших задач.

Swap API​

Легко добавляйте агрегацию ликвидности в свое приложение с помощью единого API. Получите доступ к более чем 100 биржам и тысячам токенов с помощью Swap API.

Примеры кода​

Обучающие руководства​

Содержание, представленное на этом сайте, предназначено исключительно для образовательных и информационных целей. Оно не является финансовым советом, и все инвестиции сопряжены со значительным риском, включая потенциальную потерю основной суммы. Настоятельно рекомендуем вам провести собственное тщательное исследование и проконсультироваться с квалифицированным финансовым специалистом перед принятием любых инвестиционных решений.

Отказ от ответственности

Disclaimer: Инвестиционный контент предназначен только для информационных целей и не является финансовой консультацией. Инвестирование сопряжено со значительным риском потерь. Всегда проводите собственное исследование.

Disclaimer: Контент об азартных играх предназначен для развлечения (18+). Убедитесь, что это законно в вашем регионе. Использование сайта означает согласие с нашими условиями.

Disclaimer: Партнёрские ссылки могут присутствовать, но они не влияют на наши независимые обзоры и рекомендации.