Making a Request

This covers the standard ORIGIN_CHAIN swap flow end-to-end: find a token, request a quote, send your deposit, and poll status until it settles.

Query supported tokens

Fetch available tokens to find the assetId values you will need.

curl https://1click.chaindefuser.com/v0/tokens

const response = await fetch('https://1click.chaindefuser.com/v0/tokens');
const tokens = await response.json();

The response includes tokens with their assetId in this format:

NEAR tokens: nep141:wrap.near
Bridged tokens: nep141:eth-0xdac17f958d2ee523a2206206994597c13d831ec7.omft.near

Example response

[
  {
    "assetId": "nep141:wrap.near",
    "decimals": 24,
    "blockchain": "near",
    "symbol": "wNEAR",
    "price": 1.1,
    "priceUpdatedAt": "2026-02-27T15:18:30.437Z",
    "contractAddress": "wrap.near"
  },
  {
    "assetId": "nep141:eth.omft.near",
    "decimals": 18,
    "blockchain": "eth",
    "symbol": "ETH",
    "price": 1947.28,
    "priceUpdatedAt": "2026-02-27T15:25:30.527Z",
    "contractAddress": null
  },
  {
    "assetId": "nep141:btc.omft.near",
    "decimals": 8,
    "blockchain": "btc",
    "symbol": "BTC",
    "price": 66093,
    "priceUpdatedAt": "2026-02-27T15:25:30.527Z",
    "contractAddress": null
  }
]

Request a quote

Request a quote with your swap parameters. Include your JWT token to avoid the 0.2% fee.

curl -X POST https://1click.chaindefuser.com/v0/quote \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "dry": false,
    "swapType": "EXACT_INPUT",
    "slippageTolerance": 100,
    "originAsset": "nep141:wrap.near",
    "depositType": "ORIGIN_CHAIN",
    "destinationAsset": "nep141:arb-0x912ce59144191c1204e64559fe8253a0e49e6548.omft.near",
    "amount": "100000000000000000000000",
    "recipient": "0xYourArbitrumAddress",
    "recipientType": "DESTINATION_CHAIN",
    "refundTo": "your-account.near",
    "refundType": "ORIGIN_CHAIN",
    "deadline": "2025-01-01T00:00:00.000Z"
  }'

const quote = await fetch('https://1click.chaindefuser.com/v0/quote', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_JWT_TOKEN'
  },
  body: JSON.stringify({
    dry: false,
    swapType: 'EXACT_INPUT',
    slippageTolerance: 100,
    originAsset: 'nep141:wrap.near',
    depositType: 'ORIGIN_CHAIN',
    destinationAsset: 'nep141:arb-0x912ce59144191c1204e64559fe8253a0e49e6548.omft.near',
    amount: '100000000000000000000000',
    recipient: '0xYourArbitrumAddress',
    recipientType: 'DESTINATION_CHAIN',
    refundTo: 'your-account.near',
    refundType: 'ORIGIN_CHAIN',
    deadline: new Date(Date.now() + 3 * 60 * 1000).toISOString()
  })
});
const result = await quote.json();

Key parameters

Parameter	Description
`dry`	`true` to validate parameters and get a quote without executing the swap
`swapType`	`EXACT_INPUT` (specify input amount) or `EXACT_OUTPUT` (specify output amount)
`slippageTolerance`	Maximum acceptable slippage in basis points (100 = 1%)
`originAsset`	Source token `assetId` from the tokens endpoint
`depositType`	`ORIGIN_CHAIN` for origin-chain deposits, `INTENTS` for public Intents balances, or `CONFIDENTIAL_INTENTS`
`destinationAsset`	Target token `assetId` from the tokens endpoint
`amount`	Amount in smallest unit (wei, yoctoNEAR, etc.)
`recipient`	Address to receive swapped tokens
`recipientType`	`DESTINATION_CHAIN`, `INTENTS`, or `CONFIDENTIAL_INTENTS`
`refundTo`	Address for refunds if swap fails
`refundType`	`ORIGIN_CHAIN`, `INTENTS`, or `CONFIDENTIAL_INTENTS`
`confidentiality`	`public` (default), `basic`, or `advanced`. Enables a confidential swap on an otherwise normal quote, see Confidential Swaps
`deadline`	Quote expiration timestamp in ISO format

This guide uses EXACT_INPUT, but 1Click also supports EXACT_OUTPUT, FLEX_INPUT, and ANY_INPUT. Check out Swap Types to see what each one does and when to use it.

Send tokens

For ORIGIN_CHAIN quotes, transfer tokens to the depositAddress from the quote response. The swap begins automatically upon receipt.Save the deposit address and your transaction hash for tracking.If your quote uses depositType: INTENTS or depositType: CONFIDENTIAL_INTENTS, skip the on-chain transfer and use Signed Intent Execution instead.

Submit transaction hash (optional)

Speed up processing by notifying 1Click of your deposit.

curl -X POST https://1click.chaindefuser.com/v0/deposit/submit \
  -H "Content-Type: application/json" \
  -d '{
    "depositAddress": "address-from-quote-response",
    "txHash": "0xYourTransactionHash"
  }'

await fetch('https://1click.chaindefuser.com/v0/deposit/submit', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    depositAddress: 'address-from-quote-response',
    txHash: '0xYourTransactionHash'
  })
});

Monitor status

Check swap progress using the deposit address.

curl "https://1click.chaindefuser.com/v0/status?depositAddress=your-deposit-address"

const status = await fetch(
  'https://1click.chaindefuser.com/v0/status?depositAddress=your-deposit-address'
);
const result = await status.json();

Status response

Status	Description
`PENDING_DEPOSIT`	Awaiting your token deposit
`KNOWN_DEPOSIT_TX`	Deposit transaction detected
`PROCESSING`	Swap being executed
`SUCCESS`	Tokens delivered to destination address
`INCOMPLETE_DEPOSIT`	Deposit below required amount
`REFUNDED`	Swap failed, funds returned to refund address
`FAILED`	Swap encountered an error

View detailed transaction info on the NEAR Intents Explorer by searching for your deposit address.

Celebrate! 🎉

You just completed your first intent-based cross-chain swap!

Intents

Swap API

Developer ToolKit

Resources