# Swaps API Documentation

> Swaps is the execution layer for moving value across chains: swaps, bridges, cross-chain contract calls, prediction market trading, and dedicated stableswap liquidity — behind one API. Users transact with any token on any chain; Swaps handles routing, transaction construction, and end-to-end tracking.

## Docs

- [Introduction](https://docs.swaps.xyz/index.md): Swaps offers flexible APIs for lightning-fast swaps, bridging, and cross-chain calls.
- [Swap](https://docs.swaps.xyz/guides/swap.md): Generate and broadcast a swap or bridge transaction.
- [Cross-Chain Calls](https://docs.swaps.xyz/guides/calldata-call.md): Execute cross-chain transactions.
- [Track Transactions](https://docs.swaps.xyz/guides/track-transactions.md): Monitor the status of transactions and trigger indexing for alt VM transactions.
- [EVM Token Approvals](https://docs.swaps.xyz/guides/token-approvals.md): Check for approvals and broadcast both the approval and Swaps transaction in a single call.
- [Stableswaps](https://docs.swaps.xyz/guides/stableswaps.md): Tighter pricing on stablecoin pairs through a dedicated stable-pair router — no new parameters or endpoints.
- [Gasless Transactions](https://docs.swaps.xyz/guides/preview/gasless.md): Execute sponsored meta-transactions without requiring users to hold native tokens for gas.
- [Best Practices](https://docs.swaps.xyz/resources/best-practices.md): Get the most out of Swaps with our multi-chain development best practices.
- [Supported Chains](https://docs.swaps.xyz/resources/chain-list.md): Swaps currently supports the following chains.
- [Terms of Service](https://docs.swaps.xyz/resources/terms-of-service.md): Last updated: November 3, 2025
- [Overview](https://docs.swaps.xyz/swap-api-reference/overview.md): Flexible APIs for lightning-fast cross-chain transactions.
- [Get Action](https://docs.swaps.xyz/swap-api-reference/get-action.md): Generates a transaction for cross-chain swaps, bridges, and calls. The action includes transaction data, routing information, and fee calculations for executing the requested operation.
- [Get Status](https://docs.swaps.xyz/swap-api-reference/get-status.md): Retrieve the status and details of a transaction by transaction ID.
- [Register Transaction](https://docs.swaps.xyz/swap-api-reference/register-transaction.md): Register transactions for indexing. Mandatory for non EVM transactions.
- [Submit Gasless Transaction](https://docs.swaps.xyz/swap-api-reference/submit-gasless-transaction.md): Submits signed executions obtained from a gasless `GET /getAction` response for relay broadcast. The backend validates each signature, simulates the transactions, then broadcasts them via the configured relay provider.
- [Get Transactions](https://docs.swaps.xyz/swap-api-reference/get-transactions.md): Retrieve paginated transaction history with optional filtering.
- [Get Paths](https://docs.swaps.xyz/swap-api-reference/get-paths.md): Retrieves all available token paths across supported chains with configurable filtering options. It’s recommended to call this endpoint after selecting the source and destination tokens to validate route eligibility.
- [Get Chain List](https://docs.swaps.xyz/swap-api-reference/get-chain-list.md): Retrieve a list of supported chains, their names, and virtual machine identifiers. Raw data for the [supported chains list](/resources/chain-list).
- [Overview](https://docs.swaps.xyz/prediction-market-reference/overview.md): Trade on prediction markets and query market data, user positions, and trading activity.
- [Integration Patterns](https://docs.swaps.xyz/prediction-market-reference/integration-patterns.md): Two ways to integrate Polymarket trading: one chain-abstracted getAction call, or the direct three-step flow.
- [Transaction Lifecycle](https://docs.swaps.xyz/prediction-market-reference/transaction-lifecycle.md): End-to-end walkthrough: discover a market, place an order, track it, manage the position, and withdraw.
- [Polymarket Signing Guide](https://docs.swaps.xyz/prediction-market-reference/polymarket-signing.md): How to produce the `signatureByEvmEoa` EIP-712 signature for Polymarket workflow endpoints.
- [Place Order (Chain Abstracted)](https://docs.swaps.xyz/prediction-market-reference/place-order-chain-abstracted.md): Place a Polymarket order with a single getAction call — any token, any chain, straight from the user's existing wallet.
- [Create or Fetch User](https://docs.swaps.xyz/prediction-market-reference/create-or-fetch-user.md): Creates a new Swaps account for a user or fetches an existing one based on the provided EVM address.
- [Place Order](https://docs.swaps.xyz/prediction-market-reference/place-order.md): Places a market order (BUY or SELL) directly against the Polymarket CLOB on behalf of the user, using their pre-funded proxy wallet.
- [Sell Position](https://docs.swaps.xyz/prediction-market-reference/sell-position.md): Sells an existing position in a Polymarket market. This endpoint allows users to exit their positions by selling their outcome tokens using market orders (FOK/FAK).
- [Redeem Position](https://docs.swaps.xyz/prediction-market-reference/redeem-position.md): Redeems position from a resolved Polymarket market. For positions with a current value > 0, this endpoint allows users to claim their winnings from a specific market condition. For losing positions with a current value = 0, this endpoint allows users to burn their position tokens to clean up their a…
- [Merge Position](https://docs.swaps.xyz/prediction-market-reference/merge-position.md): Merges a full set of position tokens back into collateral by burning them. Can be used to claim winnings from resolved markets or clean up positions. Endpoint awaits successful execution of the merge transaction before returning the transaction hash.
- [Withdraw](https://docs.swaps.xyz/prediction-market-reference/withdraw.md): Withdraws the user's Polymarket proxy-wallet collateral to an arbitrary `dstWalletAddress`. Optional `dstToken` swaps the proxy collateral into a different token (and/or chain) before delivery.
- [Get Workflow Status](https://docs.swaps.xyz/prediction-market-reference/get-workflow-status.md): Retrieves the status of a workflow transaction by transaction ID.
- [Search Markets](https://docs.swaps.xyz/prediction-market-reference/search-markets.md): Search for markets and events by query string or tags.
- [Get Trending Markets](https://docs.swaps.xyz/prediction-market-reference/get-trending-markets.md): Retrieve trending markets sorted by 24-hour volume. Markets must have minimum $150K of 24h volume.
- [Get Tags](https://docs.swaps.xyz/prediction-market-reference/get-tags.md): Retrieve all available tags for filtering markets.
- [Get Event](https://docs.swaps.xyz/prediction-market-reference/get-event.md): Retrieve detailed information about a specific event, including all associated markets.
- [Get Markets](https://docs.swaps.xyz/prediction-market-reference/get-markets.md): Retrieve market information by CLOB token IDs, slugs, or tag ID.
- [Get Market Price](https://docs.swaps.xyz/prediction-market-reference/get-market-price.md): Retrieve the current best price for a specific token and side (BUY or SELL).
- [Get Price History](https://docs.swaps.xyz/prediction-market-reference/get-price-history.md): Retrieve historical price data for a specific token over a given time interval.
- [Get Current Positions](https://docs.swaps.xyz/prediction-market-reference/get-current-positions.md): Retrieve all current open positions for a specific user.
- [Get Closed Positions](https://docs.swaps.xyz/prediction-market-reference/get-closed-positions.md): Retrieve closed positions (resolved markets) for a specific user.
- [Get Trades](https://docs.swaps.xyz/prediction-market-reference/get-trades.md): Retrieve trade history for a specific user.
- [Get Activity](https://docs.swaps.xyz/prediction-market-reference/get-activity.md): Retrieve comprehensive activity history for a specific user, including orders, trades, and other actions.
- [Get Profit and Loss](https://docs.swaps.xyz/prediction-market-reference/get-profit-and-loss.md): Retrieve aggregate profit and loss information across all positions for a specific user.
- [Overview](https://docs.swaps.xyz/protocol-reference/overview.md): Integrate Swaps' stableswap protocol at the contract level — route over on-chain liquidity directly, without the API.
- [Stableswap on Solana](https://docs.swaps.xyz/protocol-reference/stableswap-solana.md): Integrate the Solana stableswap program directly — swap instruction, pair-state fees, and router proofs for custom pricing.
- [Stableswap on EVM](https://docs.swaps.xyz/protocol-reference/stableswap-evm.md): Integrate the GhostExchange contract directly — quoting, swapping, and pool discovery over cross-collateral stable liquidity.

## OpenAPI Specs

- [openapi](https://docs.swaps.xyz/swap-api-reference/openapi.json)