NEAR Intents
  • Overview
  • Verifier
    • Account Abstraction
    • Example Transactions
  • Solver Bus
    • API
    • Solvers
  • PoA bridge
  • Examples
  • FAQs
  • Architecture
    • Intent flow
    • Deposits & Withdrawals
  • SDK
    • Deposit
    • Withdraw
  • 1Click API
Powered by GitBook

1Click API

Last updated 2 days ago

The purpose of 1Click is to make it easy to use NEAR Intents by temporarily transferring assets to the custody of a trusted swapping agent:

  • Request a quote using Get Quote endpoint: The response will contain a deposit address, unique for each quote

  • Transfer tokens to the deposit address: Once transferred, 1Click will start the swapping process automatically.

  • Submit Deposit Tx using deposit transaction hash: This step is optional, but it can help speeding up the process.

  • Get Execution Status at any time to see the progress.

The swap will either succeed or fail; in case of a failure, the funds will end up on the refund address and a new attempt to swap would need to be triggered by repeating this flow.

API Specification (v0)

The OpenAPI spec is made available to auto-generate clients. Client SDKs for TypeScript, Go and Rust are already available on GitHub.

Get supported tokens

get

Retrieves a list of tokens currently supported by the 1Click API for asset swaps.

Each token entry includes its blockchain, contract address (if available), price in USD, and other metadata such as symbol and decimals.

Responses
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --url 'https://1click.chaindefuser.com/v0/tokens'
200
[
  {
    "assetId": "nep141:wrap.near",
    "decimals": 24,
    "blockchain": "near",
    "symbol": "wNEAR",
    "price": "2.79",
    "priceUpdatedAt": "2025-03-28T12:23:00.070Z",
    "contractAddress": "wrap.near"
  }
]

Check swap execution status

get

Retrieves the current status of a swap using the unique deposit address from the quote.

The response includes the state of the swap (e.g., pending, processing, success, refunded) and any associated swap and transaction details.

Query parameters
depositAddressstringrequired
Responses
application/json
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --url 'https://1click.chaindefuser.com/v0/status?depositAddress=text'
200
404
{
  "quoteResponse": {
    "timestamp": "2019-08-24T14:15:22Z",
    "signature": "text",
    "quoteRequest": {
      "dry": true,
      "swapType": "EXACT_INPUT",
      "slippageTolerance": 100,
      "originAsset": "nep141:arb-0xaf88d065e77c8cc2239327c5edb3a432268e5831.omft.near",
      "depositType": "ORIGIN_CHAIN",
      "destinationAsset": "nep141:sol-5ce3bf3a31af18be40ba30f721101b4341690186.omft.near",
      "amount": "1000",
      "refundTo": "0x2527D02599Ba641c19FEa793cD0F167589a0f10D",
      "refundType": "ORIGIN_CHAIN",
      "recipient": "13QkxhNMrTPxoCkRdYdJ65tFuwXPhL5gLS2Z5Nr6gjRK",
      "recipientType": "DESTINATION_CHAIN",
      "deadline": "2019-08-24T14:15:22Z",
      "referral": "referral",
      "quoteWaitingTimeMs": 3000
    },
    "quote": {
      "depositAddress": "0x76b4c56085ED136a8744D52bE956396624a730E8",
      "amountIn": "1000000",
      "amountInFormatted": "1",
      "amountInUsd": "1",
      "minAmountIn": "995000",
      "amountOut": "9950000",
      "amountOutFormatted": "9.95",
      "amountOutUsd": "9.95",
      "minAmountOut": "9900000",
      "deadline": "2025-03-04T15:00:00Z",
      "timeWhenInactive": "2025-03-04T15:00:00Z",
      "timeEstimate": 120
    }
  },
  "status": "KNOWN_DEPOSIT_TX",
  "updatedAt": "2025-04-03T05:50:18.906Z",
  "swapDetails": {
    "intentHashes": [
      "text"
    ],
    "nearTxHashes": [
      "text"
    ],
    "amountIn": "1000",
    "amountInFormatted": "0.1",
    "amountInUsd": "0.1",
    "amountOut": "9950000",
    "amountOutFormatted": "9.95",
    "amountOutUsd": "9.95",
    "slippage": 50,
    "originChainTxHashes": [
      {
        "hash": "0x123abc456def789",
        "explorerUrl": "text"
      }
    ],
    "destinationChainTxHashes": [
      {
        "hash": "0x123abc456def789",
        "explorerUrl": "text"
      }
    ],
    "refundedAmount": "1000",
    "refundedAmountFormatted": "0.1",
    "refundedAmountUsd": "0.1"
  }
}

Request a swap quote

post

Generates a swap quote based on input parameters such as the assets, amount, slippage tolerance, and recipient/refund information.

Returns pricing details, estimated time, and a unique deposit address to which tokens must be transferred to initiate the swap.

You can set the dry parameter to true to simulate the quote request without generating a deposit address or initiating the swap process. This is useful for previewing swap parameters or validating input data without committing to an actual swap.

This endpoint is the first required step in the swap process.

Body
drybooleanrequired

Flag indicating whether this is a dry run request. If true, the response will NOT contain the following fields:

  • depositAddress
  • timeWhenInactive
  • timeEstimate
  • deadline
Example: true
swapTypestring · enumrequired

Whether to use the amount as the output or the input for the basis of the swap:

  • EXACT_INPUT - request output amount for exact input.
  • EXACT_OUTPUT - request output amount for exact output. The refundTo address will always receive excess tokens back even after the swap is complete.
Available options:
slippageTolerancenumberrequired

Slippage tolerance for the swap. This value is in basis points (1/100th of a percent), e.g. 100 for 1% slippage.

Example: 100
originAssetstringrequired

ID of the origin asset.

Example: nep141:arb-0xaf88d065e77c8cc2239327c5edb3a432268e5831.omft.near
depositTypestring · enumrequired

Type of the deposit address:

  • ORIGIN_CHAIN - deposit address on the origin chain
  • INTENTS - account ID inside near intents to which you should transfer assets inside intents.
Available options:
destinationAssetstringrequired

ID of the destination asset.

Example: nep141:sol-5ce3bf3a31af18be40ba30f721101b4341690186.omft.near
amountstringrequired

Amount to swap as the base amount (can be switched to exact input/output using the dedicated flag), denoted in the smallest unit of the specified currency (e.g., wei for ETH).

Example: 1000
refundTostringrequired

Address for user refund.

Example: 0x2527D02599Ba641c19FEa793cD0F167589a0f10D
refundTypestring · enumrequired

Type of refund address:

  • ORIGIN_CHAIN - assets will be refunded to refundTo address on the origin chain
  • INTENTS - assets will be refunded to refundTo intents account
Available options:
recipientstringrequired

Recipient address. The format should match recipientType.

Example: 13QkxhNMrTPxoCkRdYdJ65tFuwXPhL5gLS2Z5Nr6gjRK
recipientTypestring · enumrequired

Type of recipient address:

  • DESTINATION_CHAIN - assets will be transferred to chain of destinationAsset
  • INTENTS - assets will be transferred to account inside intents
Available options:
deadlinestring · date-timerequired

Timestamp in ISO format, that identifies when user refund will begin if the swap isn't completed by then.

Example: 2019-08-24T14:15:22Z
referralstringoptional

Referral identifier

Example: referral
quoteWaitingTimeMsnumber · default: 3000optional

Time in milliseconds user is willing to wait for quote from relay.

Example: 3000
Responses
application/json
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --request POST \
  --url 'https://1click.chaindefuser.com/v0/quote' \
  --header 'Content-Type: application/json' \
  --data '{
    "dry": true,
    "swapType": "EXACT_INPUT",
    "slippageTolerance": 100,
    "originAsset": "nep141:arb-0xaf88d065e77c8cc2239327c5edb3a432268e5831.omft.near",
    "depositType": "ORIGIN_CHAIN",
    "destinationAsset": "nep141:sol-5ce3bf3a31af18be40ba30f721101b4341690186.omft.near",
    "amount": "1000",
    "refundTo": "0x2527D02599Ba641c19FEa793cD0F167589a0f10D",
    "refundType": "ORIGIN_CHAIN",
    "recipient": "13QkxhNMrTPxoCkRdYdJ65tFuwXPhL5gLS2Z5Nr6gjRK",
    "recipientType": "DESTINATION_CHAIN",
    "deadline": "2019-08-24T14:15:22Z",
    "referral": "referral",
    "quoteWaitingTimeMs": 3000
  }'
200
400
{
  "timestamp": "2019-08-24T14:15:22Z",
  "signature": "text",
  "quoteRequest": {
    "dry": true,
    "swapType": "EXACT_INPUT",
    "slippageTolerance": 100,
    "originAsset": "nep141:arb-0xaf88d065e77c8cc2239327c5edb3a432268e5831.omft.near",
    "depositType": "ORIGIN_CHAIN",
    "destinationAsset": "nep141:sol-5ce3bf3a31af18be40ba30f721101b4341690186.omft.near",
    "amount": "1000",
    "refundTo": "0x2527D02599Ba641c19FEa793cD0F167589a0f10D",
    "refundType": "ORIGIN_CHAIN",
    "recipient": "13QkxhNMrTPxoCkRdYdJ65tFuwXPhL5gLS2Z5Nr6gjRK",
    "recipientType": "DESTINATION_CHAIN",
    "deadline": "2019-08-24T14:15:22Z",
    "referral": "referral",
    "quoteWaitingTimeMs": 3000
  },
  "quote": {
    "depositAddress": "0x76b4c56085ED136a8744D52bE956396624a730E8",
    "amountIn": "1000000",
    "amountInFormatted": "1",
    "amountInUsd": "1",
    "minAmountIn": "995000",
    "amountOut": "9950000",
    "amountOutFormatted": "9.95",
    "amountOutUsd": "9.95",
    "minAmountOut": "9900000",
    "deadline": "2025-03-04T15:00:00Z",
    "timeWhenInactive": "2025-03-04T15:00:00Z",
    "timeEstimate": 120
  }
}

Submit deposit transaction hash

post

Optionally notifies the 1Click service that a deposit has been sent to the specified address, using the blockchain transaction hash.

This step can speed up swap processing by allowing the system to preemptively verify the deposit.

Body
txHashstringrequired

Transaction hash of your deposit

Example: 0x123abc456def789
depositAddressstringrequired

Deposit address for the quote

Example: 0x2527D02599Ba641c19FEa793cD0F167589a0f10D
Responses
application/json
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --request POST \
  --url 'https://1click.chaindefuser.com/v0/deposit/submit' \
  --header 'Content-Type: application/json' \
  --data '{
    "txHash": "0x123abc456def789",
    "depositAddress": "0x2527D02599Ba641c19FEa793cD0F167589a0f10D"
  }'
200
400
{
  "quoteResponse": {
    "timestamp": "2019-08-24T14:15:22Z",
    "signature": "text",
    "quoteRequest": {
      "dry": true,
      "swapType": "EXACT_INPUT",
      "slippageTolerance": 100,
      "originAsset": "nep141:arb-0xaf88d065e77c8cc2239327c5edb3a432268e5831.omft.near",
      "depositType": "ORIGIN_CHAIN",
      "destinationAsset": "nep141:sol-5ce3bf3a31af18be40ba30f721101b4341690186.omft.near",
      "amount": "1000",
      "refundTo": "0x2527D02599Ba641c19FEa793cD0F167589a0f10D",
      "refundType": "ORIGIN_CHAIN",
      "recipient": "13QkxhNMrTPxoCkRdYdJ65tFuwXPhL5gLS2Z5Nr6gjRK",
      "recipientType": "DESTINATION_CHAIN",
      "deadline": "2019-08-24T14:15:22Z",
      "referral": "referral",
      "quoteWaitingTimeMs": 3000
    },
    "quote": {
      "depositAddress": "0x76b4c56085ED136a8744D52bE956396624a730E8",
      "amountIn": "1000000",
      "amountInFormatted": "1",
      "amountInUsd": "1",
      "minAmountIn": "995000",
      "amountOut": "9950000",
      "amountOutFormatted": "9.95",
      "amountOutUsd": "9.95",
      "minAmountOut": "9900000",
      "deadline": "2025-03-04T15:00:00Z",
      "timeWhenInactive": "2025-03-04T15:00:00Z",
      "timeEstimate": 120
    }
  },
  "status": "KNOWN_DEPOSIT_TX",
  "updatedAt": "2025-04-03T05:50:18.906Z",
  "swapDetails": {
    "intentHashes": [
      "text"
    ],
    "nearTxHashes": [
      "text"
    ],
    "amountIn": "1000",
    "amountInFormatted": "0.1",
    "amountInUsd": "0.1",
    "amountOut": "9950000",
    "amountOutFormatted": "9.95",
    "amountOutUsd": "9.95",
    "slippage": 50,
    "originChainTxHashes": [
      {
        "hash": "0x123abc456def789",
        "explorerUrl": "text"
      }
    ],
    "destinationChainTxHashes": [
      {
        "hash": "0x123abc456def789",
        "explorerUrl": "text"
      }
    ],
    "refundedAmount": "1000",
    "refundedAmountFormatted": "0.1",
    "refundedAmountUsd": "0.1"
  }
}