near-intents

Original：🇺🇸 English

Translated

Cross-chain token swap integration using NEAR Intents 1Click API. Use when building swap widgets, bridge interfaces, or multi-chain transfers across EVM, Solana, NEAR, TON, Stellar, and Tron.

1installs

Sourcenear/agent-skills

Added on2026-02-14

NPX Install

npx skill4agent add near/agent-skills near-intents

SKILL.md Content

View Translation Comparison →

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


react-swap-widget.md
api-quote.md
deposit-evm.md
react-hooks.md
intents-balance.md

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

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

Index

Examples (HIGH)
- react-swap-widget - Minimum viable React swap implementation with wagmi
- server-example - Node.js script for server-side swaps
API Reference (CRITICAL)
- api-tokens - Fetch supported tokens, cache result
- api-quote - Get swap quote, dry=true for preview, dry=false for deposit address
- api-deposit-submit - Notify API after deposit to speed up processing
- api-status - Poll until terminal state (SUCCESS, FAILED, REFUNDED)
- api-any-input-withdrawals - Query withdrawals for ANY_INPUT quotes
Chain Deposits (HIGH)
- deposit-evm - Ethereum, Base, Arbitrum, Polygon, BSC transfers
- deposit-solana - Native SOL and SPL token transfers
- deposit-near - NEP-141 token transfers via wallet selector
- deposit-ton - Native TON transfers via TonConnect
- deposit-tron - Native TRX and TRC-20 transfers
- deposit-stellar - Stellar transfers (MEMO REQUIRED)
React Hooks (MEDIUM)
- react-hooks - Reusable hooks for tokens, quotes, status polling
Advanced (LOW)
- intents-balance - Hold balances in intents.near for faster swaps
- passive-deposit - QR code flow for manual transfers
References
- concepts - Swap lifecycle, statuses, CEX warning, authentication