1inch Swap API

openapi: 3.1.0
info:
  title: 1inch Developer Portal APIs Balance Swap API
  description: '1inch exposes a suite of REST APIs through its Developer / Business

    portal (https://business.1inch.com/portal/documentation/overview).

    This OpenAPI document covers the most commonly used products surfaced

    in the 1inch apis.yml profile: Swap (classic aggregation), Orderbook

    (limit orders), Balance, Spot Price, Token, Portfolio, and Gas Price.

    All endpoints are versioned under their own subpath on

    `https://api.1inch.dev` and authenticate with a Bearer token issued

    from the developer portal.

    '
  version: 1.0.0
  contact:
    name: 1inch
    url: https://business.1inch.com/portal/documentation/overview
servers:
- url: https://api.1inch.dev
  description: 1inch Developer API gateway
security:
- BearerAuth: []
tags:
- name: Swap
paths:
  /swap/v6.0/{chain}/healthcheck:
    get:
      tags:
      - Swap
      summary: Swap API health check
      parameters:
      - $ref: '#/components/parameters/Chain'
      responses:
        '200':
          description: API healthy
  /swap/v6.0/{chain}/quote:
    get:
      tags:
      - Swap
      summary: Get a swap quote
      description: Returns the best aggregated quote for a token swap on the given EVM chain.
      parameters:
      - $ref: '#/components/parameters/Chain'
      - in: query
        name: src
        required: true
        schema:
          type: string
        description: Source token address
      - in: query
        name: dst
        required: true
        schema:
          type: string
        description: Destination token address
      - in: query
        name: amount
        required: true
        schema:
          type: string
        description: Source amount in minor units (wei)
      - in: query
        name: includeTokensInfo
        schema:
          type: boolean
      - in: query
        name: includeProtocols
        schema:
          type: boolean
      - in: query
        name: includeGas
        schema:
          type: boolean
      responses:
        '200':
          description: Quote
  /swap/v6.0/{chain}/swap:
    get:
      tags:
      - Swap
      summary: Build a swap transaction
      parameters:
      - $ref: '#/components/parameters/Chain'
      - in: query
        name: src
        required: true
        schema:
          type: string
      - in: query
        name: dst
        required: true
        schema:
          type: string
      - in: query
        name: amount
        required: true
        schema:
          type: string
      - in: query
        name: from
        required: true
        schema:
          type: string
        description: Wallet address that will execute the swap
      - in: query
        name: slippage
        required: true
        schema:
          type: number
        description: Slippage tolerance in percent (e.g. 1 = 1%)
      - in: query
        name: disableEstimate
        schema:
          type: boolean
      - in: query
        name: allowPartialFill
        schema:
          type: boolean
      responses:
        '200':
          description: Swap transaction calldata
  /swap/v6.0/{chain}/approve/spender:
    get:
      tags:
      - Swap
      summary: Get aggregator spender address
      parameters:
      - $ref: '#/components/parameters/Chain'
      responses:
        '200':
          description: Spender address
  /swap/v6.0/{chain}/approve/transaction:
    get:
      tags:
      - Swap
      summary: Build an approve transaction
      parameters:
      - $ref: '#/components/parameters/Chain'
      - in: query
        name: tokenAddress
        required: true
        schema:
          type: string
      - in: query
        name: amount
        schema:
          type: string
      responses:
        '200':
          description: Approve transaction calldata
  /swap/v6.0/{chain}/approve/allowance:
    get:
      tags:
      - Swap
      summary: Get current token allowance
      parameters:
      - $ref: '#/components/parameters/Chain'
      - in: query
        name: tokenAddress
        required: true
        schema:
          type: string
      - in: query
        name: walletAddress
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Allowance amount
  /swap/v6.0/{chain}/liquidity-sources:
    get:
      tags:
      - Swap
      summary: List supported liquidity sources (protocols)
      parameters:
      - $ref: '#/components/parameters/Chain'
      responses:
        '200':
          description: Liquidity sources
  /swap/v6.0/{chain}/tokens:
    get:
      tags:
      - Swap
      summary: List supported tokens for swapping
      parameters:
      - $ref: '#/components/parameters/Chain'
      responses:
        '200':
          description: Tokens
components:
  parameters:
    Chain:
      in: path
      name: chain
      required: true
      schema:
        type: integer
      description: EVM chain ID (e.g. 1 for Ethereum, 137 for Polygon)
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'API key issued from https://portal.1inch.dev passed as

        `Authorization: Bearer <token>`.

        '