Search
⌘K
Orderbook API
API version: All versions
Introduction
Quickstart
Methods
Include a limit order to the 1inch limit orders database POST
Get order by the specified order hash GET
Get orders count by specified filters GET
Get fill/cancel events related to the specified order GET
Get limit orders history by address (Cursor Pagination) GET
Get all limit orders with cursor pagination GET
Get orders by address with cursor pagination GET
Get all orders fill/cancel events with cursor pagination GET
Get all active orders which have permit for the specified wallet address and token GET
Get calculated making amount on trading pair by provided amount GET
Get unique active token pairs with cursor pagination GET
Get market price for a token pair GET
Migration
Migration V3 - V4
SDK
Introduction
Querying the Orderbook
Advanced usage
Docs·APIs·Orderbook API·Quickstart

Quickstart

Introduction

This guide shows how to create and submit a Limit Order v4 using the @1inch/limit-order-sdk on Ethereum.

Before You Start

  • You must have a valid 1inch API Key. You can get one from the 1inch Business.
  • Your wallet must have:
    • USDC on Ethereum (for the maker asset)
    • ETH for the token approval transaction

Integration Pattern

  1. Approve Tokens - Grant the Limit Order Protocol contract permission to spend your tokens
  2. Initialize SDK - Create an SDK instance with your API key and network
  3. Configure Traits - Set expiration and nonce via MakerTraits
  4. Create Order - Build a properly formatted order with the SDK
  5. Sign Order - Sign with EIP-712 typed data (no gas required)
  6. Submit Order - Send the signed order to the 1inch Orderbook API

Interactive Code Example

Explore the minimal quick-start implementation (~90 lines):

For a more comprehensive example with provider-agnostic design and balance checks, see src/create-limit-order.ts in the same project.

Did you find what you need?