> ## Documentation Index > Fetch the complete documentation index at: https://docs.portalhq.io/llms.txt > Use this file to discover all available pages before exploring further. # Get cross-chain swap quotes > Retrieves quotes for a cross-chain swap across EVM chains. Returns multiple quotes with different bridge providers and routing options. **Experimental:** This endpoint requires explicit enablement by the Portal and 0x teams before it can be used. The `sellToken` and `buyToken` parameters accept contract addresses, native token keywords (`NATIVE`, `ETH`, `AVAX`, `SOL`, etc.), or supported token symbols (`USDC`, `USDT`). Each quote includes a Portal-formatted `transaction` object ready to sign and broadcast. If token approval is needed, an `approvalTransaction` is also included — sign and submit it before the main transaction. For more details on the underlying 0x cross-chain API, see the [0x Cross-Chain API docs](https://0x-docs.gitbook.io/0x-cross-chain-api-beta/api-reference/cross-chain). ## OpenAPI ````yaml /openapi/client-api.yaml post /clients/me/integrations/0x/cross-chain/quotes openapi: 3.1.0 info: title: Portal Client API version: '3.0' description: > The Portal Client API provides endpoints for managing wallets, building transactions, and interacting with blockchain networks. All endpoints require authentication via a Client API Key or Client Session Token (CST) passed as a Bearer token. ## Base URL `https://api.portalhq.io/api/v3` ## Authentication Include your Client API Key or Client Session Token as a Bearer token in the `Authorization` header of every request. ## Chain ID Format Chain parameters use either friendly names (e.g. `ethereum`, `solana`) or CAIP-2 format (e.g. `eip155:1`, `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`). When using CAIP-2 format in URLs, ensure the colon is URI-encoded (`%3A`). servers: - url: https://api.portalhq.io/api/v3 description: Production security: - bearerAuth: [] tags: - name: Clients description: Core client management endpoints - name: Wallet description: >- Read wallet state — balances, NFTs, transaction history, capabilities, and transaction details - name: Transactions description: Build, broadcast, and evaluate blockchain transactions - name: Funding description: Fund wallets with testnet tokens - name: Wallet Shares description: Manage signing and backup share pairs - name: Delegations description: Manage token approvals, revocations, and delegated transfers - name: Session Keys description: Manage EIP-7702 session keys for smart accounts - name: 0x description: Token swap endpoints powered by the 0x protocol - name: Yield.xyz description: Yield opportunities and staking actions powered by Yield.xyz - name: Li.Fi description: Cross-chain swaps and bridging powered by Li.Fi - name: Blockaid description: Transaction and address security scanning powered by Blockaid - name: Hypernative description: >- Transaction, address, token, and NFT security scanning powered by Hypernative - name: Noah description: KYC onboarding, payins, and payouts powered by Noah - name: EIP-7702 description: EIP-7702 account type detection and authorization management - name: Deprecated description: >- Legacy endpoints scheduled for removal. Use the newer equivalents listed in each endpoint's description. paths: /clients/me/integrations/0x/cross-chain/quotes: post: tags: - 0x summary: Get cross-chain swap quotes description: > Retrieves quotes for a cross-chain swap across EVM chains. Returns multiple quotes with different bridge providers and routing options. **Experimental:** This endpoint requires explicit enablement by the Portal and 0x teams before it can be used. The `sellToken` and `buyToken` parameters accept contract addresses, native token keywords (`NATIVE`, `ETH`, `AVAX`, `SOL`, etc.), or supported token symbols (`USDC`, `USDT`). Each quote includes a Portal-formatted `transaction` object ready to sign and broadcast. If token approval is needed, an `approvalTransaction` is also included — sign and submit it before the main transaction. For more details on the underlying 0x cross-chain API, see the [0x Cross-Chain API docs](https://0x-docs.gitbook.io/0x-cross-chain-api-beta/api-reference/cross-chain). operationId: getCrossChainQuotes requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ZeroXCrossChainQuotesRequest' responses: '200': description: Cross-chain quotes retrieved successfully content: application/json: schema: $ref: '#/components/schemas/ZeroXCrossChainQuotesResponse' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: ZeroXCrossChainQuotesRequest: type: object required: - originChain - destinationChain - sellToken - buyToken - sellAmount - sortQuotesBy properties: originChain: type: string description: Origin chain in CAIP-2 format (e.g. `eip155:8453`). destinationChain: type: string description: Destination chain in CAIP-2 format (e.g. `eip155:42161`). sellToken: type: string description: | Token to sell on the origin chain. Accepts a contract address (e.g. `0x833589...`), a native token keyword (`NATIVE`, `ETH`, `AVAX`, `SOL`, etc.), or a supported token symbol (`USDC`). buyToken: type: string description: | Token to buy on the destination chain. Same formats as `sellToken`. sellAmount: type: string description: Amount of `sellToken` in base units to sell. sortQuotesBy: type: string enum: - speed - price description: Sort quotes by `speed` or `price`. originAddress: type: string description: >- Wallet address on origin chain. Defaults to the client's EIP-155 address. destinationAddress: type: string description: Wallet address to receive tokens. Defaults to `originAddress`. slippageBps: type: number description: Maximum slippage in basis points (100 = 1%). Defaults to 100. maxNumQuotes: type: integer minimum: 1 maximum: 10 description: Maximum number of quotes to return. Defaults to 3. excludedBridges: type: string description: Comma-separated bridge providers to exclude. includedBridges: type: string description: Comma-separated bridge providers to include. excludedSwapSources: type: string description: Comma-separated DEX sources to exclude. feeBps: type: string description: Integrator fee in basis points. feeRecipient: type: string description: Address to receive integrator fees. feeToken: type: string description: Token for fee collection (defaults to sell token). zeroXApiKey: type: string description: Optional 0x API key. ZeroXCrossChainQuotesResponse: type: object properties: data: type: object properties: rawResponse: type: object properties: liquidityAvailable: type: boolean description: Whether liquidity exists for the cross-chain swap. allowanceTarget: type: string nullable: true description: Contract address to set allowance on. originChainId: type: string description: Origin chain in CAIP-2 format. originChain: type: string description: Origin chain name. destinationChainId: type: string description: Destination chain in CAIP-2 format. destinationChain: type: string description: Destination chain name. sellToken: type: string description: Sell token address on origin chain. buyToken: type: string description: Buy token address on destination chain. issues: type: object description: Allowance and balance requirements. properties: allowance: type: object nullable: true properties: actual: type: string spender: type: string balance: type: object nullable: true properties: token: type: string actual: type: string expected: type: string simulationIncomplete: type: boolean zid: type: string description: 0x request tracking ID. quotes: type: array description: Array of available cross-chain quotes. items: type: object properties: sellAmount: type: string description: Amount of sell token in base units. buyAmount: type: string description: Estimated buy token amount in base units. minBuyAmount: type: string description: Minimum guaranteed buy amount after slippage. fees: type: object description: Fee breakdown (integrator, 0x, bridge). additionalProperties: true gasCosts: type: object description: Estimated gas costs on origin chain. additionalProperties: true steps: type: array description: Sequential steps (swap, bridge, wrap/unwrap). items: type: object additionalProperties: true transaction: type: object description: > Portal-formatted transaction to sign and broadcast. Includes `from`, `to`, `data`, `gas`, `gasPrice`, `value`. properties: from: type: string to: type: string data: type: string gas: type: string gasPrice: type: string value: type: string approvalTransaction: type: object description: > Portal-formatted ERC20 approval transaction. Present when token allowance is needed. Sign and submit this **before** the main `transaction`. The `gas` and `gasPrice` fields are optional — when omitted, they should be derived at signing time. required: - from - to - data - value properties: from: type: string to: type: string data: type: string gas: type: string description: >- Optional. Omitted when gas should be estimated at signing time. gasPrice: type: string description: >- Optional. Omitted when gas price should be estimated at signing time. value: type: string estimatedTimeSeconds: type: number nullable: true description: Estimated time for the swap to complete. issues: type: object description: Quote-level allowance and balance issues. additionalProperties: true quoteId: type: string description: Unique ID for this quote. ErrorResponse: type: object properties: error: type: string description: Error message describing what went wrong securitySchemes: bearerAuth: type: http scheme: bearer description: > Client API Key or Client Session Token (CST). Pass as a Bearer token in the Authorization header. ````