---
title: "Get Paths"
method: GET
path: "/getPaths"
---

# Get Paths

`GET /getPaths`

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.

## Query parameters

- `srcChainId` integer, required — Chain ID. Find in the list of supported networks.
- `srcToken` string, required
- `dstChainId` integer — Chain ID. Find in the list of supported networks.
- `dstToken` string
- `excludeBridgeIds` BridgeId[]
- `excludeDexIds` DexId[]

## Response `200`

Paths response

- GetPathsOutput
  - `srcChainId` integer, required — Chain ID. Find in the list of supported networks.
  - `srcToken` TokenInfoWithAmounts, required
    - `chainId` integer, required — Chain ID. Find in the list of supported networks.
    - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
    - `name` string, required — Token name
    - `symbol` string, required — Token symbol
    - `decimals` integer, required — Token decimals
    - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
    - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
    - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
    - `minAmount` string, nullable, required — Minimum amount of source token for exact-out swaps. `null` if no min.
    - `maxAmount` string, nullable, required — Maximum amount of source token for exact-out swaps. `null` if no max.
  - `paths` ChainPath[], required
    - `chainId` integer, required — Chain ID. Find in the list of supported networks.
    - `tokens` union, required — Available destination tokens for given source token `all` indicates all tokens on destination chain are eligible
      - 'all'
      - TokenInfoWithAmounts[]
        - `chainId` integer, required — Chain ID. Find in the list of supported networks.
        - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
        - `name` string, required — Token name
        - `symbol` string, required — Token symbol
        - `decimals` integer, required — Token decimals
        - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
        - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
        - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
        - `minAmount` string, nullable, required — Minimum amount of source token for exact-out swaps. `null` if no min.
        - `maxAmount` string, nullable, required — Maximum amount of source token for exact-out swaps. `null` if no max.
    - `supportsExactAmountIn` boolean, required
    - `supportsExactAmountOut` boolean, required
    - `amountLimits` object — ⚠️ This field is maintained for backwards compatibility. Use `srcToken.minAmount` and `srcToken.maxAmount` at the top level of the response instead.
      - `minAmount` string, nullable, required — Minimum amount of source token required for exact-in swaps. `null` if no min.
      - `maxAmount` string, nullable, required — Maximum amount of source token for exact-in swaps. `null` if no max.
  - `timestamp` string, required — Response timestamp (ISO string) for cache validation

## Other responses

- `400` — Bad request due to missing or invalid parameters
- `500` — Internal server error

---

[API](https://skmtc.dev/swaps/apis/prediction-market-data-api.md) · [All operations](https://skmtc.dev/swaps/apis/prediction-market-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/swaps/prediction-market-data-api/revisions/03e917d60cb7/schema)
