# Swaps API Documentation

## Docs

- [Cross-Chain Calls](https://docs.swaps.xyz/guides/calldata-call.md): Execute cross-chain transactions.
- [Gasless Transactions](https://docs.swaps.xyz/guides/preview/gasless.md): Execute sponsored meta-transactions without requiring users to hold native tokens for gas.
- [Swap](https://docs.swaps.xyz/guides/swap.md): Generate and broadcast a swap or bridge transaction.
- [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.
- [Track Transactions](https://docs.swaps.xyz/guides/track-transactions.md): Monitor the status of transactions and trigger indexing for alt VM transactions.
- [Introduction](https://docs.swaps.xyz/index.md): Swaps offers flexible APIs for lightning-fast swaps, bridging, and cross-chain calls.
- [Get Activity](https://docs.swaps.xyz/prediction-market-data-reference/get-activity.md): Retrieve comprehensive activity history for a specific user, including orders, trades, and other actions.
- [Get Closed Positions](https://docs.swaps.xyz/prediction-market-data-reference/get-closed-positions.md): Retrieve closed positions (resolved markets) for a specific user.
- [Get Current Positions](https://docs.swaps.xyz/prediction-market-data-reference/get-current-positions.md): Retrieve all current open positions for a specific user.
- [Get Event](https://docs.swaps.xyz/prediction-market-data-reference/get-event.md): Retrieve detailed information about a specific event, including all associated markets.
- [Get Market Price](https://docs.swaps.xyz/prediction-market-data-reference/get-market-price.md): Retrieve the current best price for a specific token and side (BUY or SELL).
- [Get Markets](https://docs.swaps.xyz/prediction-market-data-reference/get-markets.md): Retrieve market information by CLOB token IDs, slugs, or tag ID.
- [Get Price History](https://docs.swaps.xyz/prediction-market-data-reference/get-price-history.md): Retrieve historical price data for a specific token over a given time interval.
- [Get Profit and Loss](https://docs.swaps.xyz/prediction-market-data-reference/get-profit-and-loss.md): Retrieve aggregate profit and loss information across all positions for a specific user.
- [Get Tags](https://docs.swaps.xyz/prediction-market-data-reference/get-tags.md): Retrieve all available tags for filtering markets.
- [Get Trades](https://docs.swaps.xyz/prediction-market-data-reference/get-trades.md): Retrieve trade history for a specific user.
- [Get Trending Markets](https://docs.swaps.xyz/prediction-market-data-reference/get-trending-markets.md): Retrieve trending markets sorted by 24-hour volume. Markets must have minimum $150K of 24h volume.
- [Overview](https://docs.swaps.xyz/prediction-market-data-reference/overview.md): Comprehensive API for querying prediction market data, user positions, and trading activity.
- [Search Markets](https://docs.swaps.xyz/prediction-market-data-reference/search-markets.md): Search for markets and events by query string or tags.
- [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
- [Create or Fetch User](https://docs.swaps.xyz/swap-api-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.
- [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 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).
- [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 Status](https://docs.swaps.xyz/swap-api-reference/get-status.md): Retrieve the status and details of a transaction by transaction ID.
- [Get Transactions](https://docs.swaps.xyz/swap-api-reference/get-transactions.md): Retrieve paginated transaction history with optional filtering.
- [Get Workflow Status](https://docs.swaps.xyz/swap-api-reference/get-workflow-status.md): Retrieves the status of a workflow transaction by transaction ID.
- [Overview](https://docs.swaps.xyz/swap-api-reference/overview.md): Flexible APIs for lightning-fast cross-chain transactions.
- [Merge Position](https://docs.swaps.xyz/swap-api-reference/polymarket/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.
- [Redeem Position](https://docs.swaps.xyz/swap-api-reference/polymarket/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…
- [Sell Position](https://docs.swaps.xyz/swap-api-reference/polymarket/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).
- [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.

## OpenAPI Specs

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