# Docs

- [Introduction](/introduction): Nordstern is a DEX aggregator API that finds and executes optimal swap routes across 100+ EVM-compatible chains.
- [Quick Start](/quick-start): Get your first swap route in under a minute. This example swaps 1 ETH for USDC on Base.
- [How It Works](/how-it-works): Three steps from API call to on-chain execution.
- [Why Nordstern](/why-nordstern): We give builders a faster, deeper, and more reliable way to route trades on every EVM network.
- [Supported Chains](/supported-chains): The Nordstern API is live on 100+ EVM-compatible chains.

- **API Reference**
- [Overview](/overview): The Nordstern API is a REST interface that returns JSON. All requests are made over HTTPS using GET or POST.
- [Get Swap Route](/swap-route): Returns the optimal split-route across all available liquidity sources, with ready-to-use calldata for direct on-chain execution.
- [Simulate Swap](/swap-simulation): Simulates an arbitrary swap transaction via eth_call and returns the received output amount, gas usage and raw return data — without holding funds or sending anything on-chain.
- [Get Token Price](/token-price): Returns current USD prices for one or more tokens on any supported chain.
- [Get Token Liquidity](/token-liquidity): Returns on-chain liquidity depth in USD for one or more tokens.
- [Get Chains](/chains): Returns the full list of supported chains with their chain IDs and metadata.
- [Errors](/errors): Error responses use plain-text bodies, not JSON. Check the HTTP status code first, then read the response body.
- [Rate Limits](/rate-limits): The Nordstern API has no fixed rate limit for normal usage — only automated spam is blocked.

- **Protocol & Security**
- [Architecture](/architecture): Every Nordstern swap flows through a two-contract pipeline — a Guard Contract for security and an interchangeable Executor Contract for routing.
- [Security](/security): Nordstern's security model is enforced entirely on-chain by the Guard Contract — no trusted intermediary, no off-chain settlement.
- [Contracts](/contracts): The Guard Contract (Router Contract / tx.to) address for every supported chain, fetched live.
- [Infrastructure](/infrastructure): Nordstern runs on a purpose-built backend optimised for low-latency routing at scale.

- **Resources**
- [AI & MCP](/ai-mcp): Connect AI agents to the Nordstern docs over MCP, llms.txt, and per-page markdown.
- [Integrations](/integrations): Projects building on the Nordstern API, and how to join them — either as an integrator or as a liquidity source.
- [FAQ](/faq): Common questions about authentication, native tokens, batching, slippage, and more.
- [Support](/support): The Nordstern team is reachable on Telegram for integration support, bug reports, and feature requests.