name: near-intents
description: 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.

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

Integration Flow

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

Rule Categories

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)
2. react-swap-widget - Minimum viable React swap implementation with wagmi

3. server-example - Node.js script for server-side swaps

4. API Reference (CRITICAL)

5. api-tokens - Fetch supported tokens, cache result
6. api-quote - Get swap quote, dry=true for preview, dry=false for deposit address
7. api-deposit-submit - Notify API after deposit to speed up processing
8. api-status - Poll until terminal state (SUCCESS, FAILED, REFUNDED)

9. api-any-input-withdrawals - Query withdrawals for ANY_INPUT quotes

10. Chain Deposits (HIGH)

11. deposit-evm - Ethereum, Base, Arbitrum, Polygon, BSC transfers
12. deposit-solana - Native SOL and SPL token transfers
13. deposit-near - NEP-141 token transfers via wallet selector
14. deposit-ton - Native TON transfers via TonConnect
15. deposit-tron - Native TRX and TRC-20 transfers

16. deposit-stellar - Stellar transfers (MEMO REQUIRED)

17. React Hooks (MEDIUM)

18. react-hooks - Reusable hooks for tokens, quotes, status polling

19. Advanced (LOW)

20. intents-balance - Hold balances in intents.near for faster swaps

21. passive-deposit - QR code flow for manual transfers

22. References

23. concepts - Swap lifecycle, statuses, CEX warning, authentication

Resources

• Docs: https://docs.near-intents.org/near-intents/integration/distribution-channels/1click-api
• API Keys: https://partners.near-intents.org/
• OpenAPI: https://1click.chaindefuser.com/docs/v0/openapi.yaml