# Superbridge Documentation

> Complete documentation for the Superbridge swap, cross-chain swap and bridging API, SDK, and Widget.

## Quick Reference

- Base URL: `https://api.superbridge.app`
- Auth: `x-api-key` header on every request
- OpenAPI spec: https://docs.superbridge.app/openapi.yaml
- Full docs: https://docs.superbridge.app
- Full documentation for LLMs: https://docs.superbridge.app/llms-full.txt

## Overview

- [Welcome to Superbridge](https://docs.superbridge.app/overview): At cost value transfer
- [Supported Chains](https://docs.superbridge.app/overview/supported-chains): Browse all supported chains and their protocols
- [Supported Protocols](https://docs.superbridge.app/overview/supported-protocols): Browse all protocols supported by Superbridge
- [Chains](https://docs.superbridge.app/overview/chains): A production-ready bridging experience for chain operators — no frontend to build or maintain
- [Rollups](https://docs.superbridge.app/overview/rollups): A production-ready bridging experience for rollup teams, with native bridge and fast-withdrawal support
- [Tokens](https://docs.superbridge.app/overview/tokens): A production-ready bridging experience for token issuers
- [Interoperability Protocols](https://docs.superbridge.app/overview/interoperability-protocols): A production-ready bridging experience powered by your infrastructure
- [Centralised Exchanges](https://docs.superbridge.app/overview/centralised-exchanges): A battle-tested, fee-free API for rebalancing funds across chains
- [Solvers](https://docs.superbridge.app/overview/solvers): A battle-tested, fee-free API for moving funds across chains
- [Arbitrage](https://docs.superbridge.app/overview/arbitrage): A battle-tested, fee-free API for positioning capital across chains
- [Ecosystems](https://docs.superbridge.app/overview/ecosystems): A production-ready bridging experience for your network of chains
- [Agents & LLMs](https://docs.superbridge.app/overview/agents-llms): Programmatic cross-chain bridging for AI agents and automated systems
- [Apps](https://docs.superbridge.app/overview/apps): At-cost, zero-slippage onboarding for your users via Widget or API
- [Wallets](https://docs.superbridge.app/overview/wallets): Value transfer flows for wallet providers and their users
- [Bridge & Swap Aggregators](https://docs.superbridge.app/overview/bridge-swap-aggregators): Native and canonical cross-chain bridging for bridge and swap aggregators
- [Onboarding](https://docs.superbridge.app/overview/onboarding): Help users get started on new chains with a frictionless experience
- [Bridging](https://docs.superbridge.app/overview/bridging): Move tokens between chains seamlessly
- [Swapping](https://docs.superbridge.app/overview/swapping): Swap tokens across chains without needing to bridge first
- [Compliance](https://docs.superbridge.app/overview/compliance): Industry-leading wallet screening and compliance standards
- [Disclosures](https://docs.superbridge.app/overview/disclosures): Report a vulnerability or anything else affecting the safety of Superbridge

## API Reference

- [Introduction](https://docs.superbridge.app/api-reference): Programmatic access to cross-chain bridging routes, tokens, chains, and transaction activity
- [Authentication](https://docs.superbridge.app/api-reference/authentication): Authenticate your API requests with an API key
- [Testing](https://docs.superbridge.app/api-reference/testing): Get a testing API key and understand its limits
- [OpenAPI Spec](https://docs.superbridge.app/api-reference/openapi): Machine-readable API specification following OpenAPI 3.0
- [Agents & LLMs](https://docs.superbridge.app/api-reference/agents-llms): Full documentation available as a single markdown file for LLMs and AI agents
- [Health](https://docs.superbridge.app/api-reference/health): Check API availability
- [Chains](https://docs.superbridge.app/api-reference/chains): Retrieve the list of supported chains
- [Tokens](https://docs.superbridge.app/api-reference/tokens): Retrieve the list of supported tokens
- [Token](https://docs.superbridge.app/api-reference/token): Retrieve a single supported token
- [Routes](https://docs.superbridge.app/api-reference/routes): Get available routes for a swap, cross-chain swap or bridge
- [Activity](https://docs.superbridge.app/api-reference/activity): Returns detailed information for swap, cross-chain swap and bridge operations
- [Step Transaction](https://docs.superbridge.app/api-reference/step-transaction): Get the transaction data required to execute a specific step of a bridge transaction
- [Index Transaction](https://docs.superbridge.app/api-reference/index-transaction): Notify the indexer about a submitted transaction
- [Submit Gasless](https://docs.superbridge.app/api-reference/submit-gasless): Submit a signed gasless transaction for relay
- [Chain Identifiers](https://docs.superbridge.app/api-reference/chain-identifiers): How chains are identified in the Superbridge API
- [Transaction Lifecycle](https://docs.superbridge.app/api-reference/transaction-lifecycle): How cross-chain transactions progress through multiple steps
- [Routes vs. Quotes](https://docs.superbridge.app/api-reference/routes-vs-quotes): Understanding the difference between routes and quotes
- [Errors](https://docs.superbridge.app/api-reference/errors): How to handle route errors and per-provider quote errors
- [Approvals](https://docs.superbridge.app/api-reference/approvals): Handle token approval transactions before bridging
- [Signing](https://docs.superbridge.app/api-reference/signing): Sign and submit pre-built transaction objects on-chain
- [Indexing](https://docs.superbridge.app/api-reference/indexing): Ensure submitted transactions are tracked by the Superbridge Indexer
- [Troubleshooting](https://docs.superbridge.app/api-reference/troubleshooting): Common issues you may encounter when integrating with the Superbridge API
- [Examples](https://docs.superbridge.app/api-reference/examples): End-to-end examples of common bridging flows
- [Types](https://docs.superbridge.app/api-reference/types): All types returned by the Superbridge API

## SDK

- [Introduction](https://docs.superbridge.app/sdk): A type-safe TypeScript wrapper around the Superbridge API
- [Examples](https://docs.superbridge.app/sdk/examples): End-to-end examples of common bridging flows using the SDK
- [Type Guards](https://docs.superbridge.app/sdk/type-guards): Type guard helpers for working with discriminated unions

## CLI

- [Introduction](https://docs.superbridge.app/cli): A command-line interface for the Superbridge API
- [Authentication](https://docs.superbridge.app/cli/authentication): API keys and private keys for signing transactions
- [Commands](https://docs.superbridge.app/cli/commands): Full reference for every superbridge subcommand
- [Examples](https://docs.superbridge.app/cli/examples): End-to-end CLI workflows including executing a route

## Widget

- [Introduction](https://docs.superbridge.app/widget): A drop-in React component that adds cross-chain bridging and swapping to your application
- [Local Development](https://docs.superbridge.app/widget/local-development): Set up the Superbridge Widget for local development
- [Theming](https://docs.superbridge.app/widget/theming): Customise the widget appearance with CSS variables, fonts, and images
- [Wallet Management](https://docs.superbridge.app/widget/wallet-management): Configure wallet connections or bring your own wallet UI