NEAR Intents Integration

Cross-chain token swaps via 1Click REST API. Get a quote, API provides deposit addresses, you build the deposit transaction and receive the resulting token automatically.

Quick Start - Pick Your Path

Use Case	Start Here
React App	react-swap-widget.md - Example showing the pattern
Node.js / Script	server-example.md - Example showing the pattern
API Reference	api-quote.md → api-tokens.md → api-status.md
Chain-specific Deposits	deposit-{chain}.md

Integration Flow

GET /v0/tokens → POST /v0/quote (dry) → POST /v0/quote (wet) → Deposit TX → POST /v0/deposit/submit → GET /v0/status

Rule Categories

Priority	Category	Files
1	Examples	react-swap-widget.md, server-example.md
2	API	api-quote.md, api-tokens.md, api-status.md, api-deposit-submit.md
3	Deposits	deposit-evm.md, deposit-solana.md, deposit-near.md, deposit-ton.md, deposit-tron.md, deposit-stellar.md
4	React Hooks	react-hooks.md
5	Advanced	intents-balance.md, passive-deposit.md

Critical Knowledge

1. Use assetId from /v0/tokens - never construct manually
2. dry: true = preview only, dry: false = get deposit address (valid ~10 min)
3. Poll status until terminal: SUCCESS, FAILED, REFUNDED, INCOMPLETE_DEPOSIT
4. Chain-to-chain is default - depositType and recipientType default to chain endpoints

Index

1. Examples (HIGH)
   • react-swap-widget - Minimum viable React swap implementation with wagmi
   • server-example - Node.js script for server-side swaps