> ## Documentation Index > Fetch the complete documentation index at: https://docs.rhinestone.dev/llms.txt > Use this file to discover all available pages before exploring further. # Create an exchange funding URL > Creates a signed Swapped Connect URL for funding from a centralized exchange. ## OpenAPI ````yaml https://raw.githubusercontent.com/rhinestonewtf/openapi/refs/heads/main/deposit-service.json post /onramp/swapped/connect-url openapi: 3.1.0 info: title: Deposit Service API version: 1.0.0 description: >- Rhinestone Deposits API: accept deposits from any chain, asset or payment method, and settle them as one token on one chain. servers: - url: https://v1.orchestrator.rhinestone.dev/deposit-processor security: [] paths: /onramp/swapped/connect-url: post: tags: - Onramp summary: Create an exchange funding URL description: >- Creates a signed Swapped Connect URL for funding from a centralized exchange. parameters: - schema: type: string description: API key for authentication example: your-api-key required: true description: API key for authentication name: x-api-key in: header - schema: type: string pattern: ^[A-Z]{2}$ description: >- Trusted edge-resolved ISO country. When present it overrides body.baseCountry and x-client-ip, and enables country-specific payment-method validation. example: PH required: false description: >- Trusted edge-resolved ISO country. When present it overrides body.baseCountry and x-client-ip, and enables country-specific payment-method validation. name: x-user-country in: header - schema: type: string description: >- The end user's IP address as observed by the edge, for edges that can name the IP but cannot resolve a country themselves (no local GeoIP database). Used only when x-user-country is absent, and ignored unless it is a publicly-routable address. Prefer x-user-country when your edge already has a country — for example Cloudflare's cf-ipcountry — since it needs no lookup here. example: 203.0.113.7 required: false description: >- The end user's IP address as observed by the edge, for edges that can name the IP but cannot resolve a country themselves (no local GeoIP database). Used only when x-user-country is absent, and ignored unless it is a publicly-routable address. Prefer x-user-country when your edge already has a country — for example Cloudflare's cf-ipcountry — since it needs no lookup here. name: x-client-ip in: header requestBody: content: application/json: schema: $ref: '#/components/schemas/SwappedConnectUrlRequestBody' responses: '200': description: Signed Connect URL content: application/json: schema: $ref: '#/components/schemas/SwappedUrlResponse' '400': description: >- Invalid request, including a `connections` allowlist naming an unrecognized slug, declared without the `connection` selection that narrows the session, or one that excludes the selection content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Authentication required or invalid credential content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: >- API key lacks the required deposits scope, or the account is not registered to the calling project content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: >- The Exchange Fee changed after the caller loaded the picker; the returned rate must be disclosed and accepted before retrying content: application/json: schema: $ref: '#/components/schemas/SwappedExchangeFeeChangedResponse' '500': description: Server misconfigured or signing failed content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: Swapped on-ramp is not configured content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: SwappedConnectUrlRequestBody: type: object properties: smartAccount: type: string pattern: ^0x[a-fA-F0-9]{40}$ description: Ethereum address (0x followed by 40 hex characters) example: '0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91' baseCountry: type: string pattern: ^[A-Z]{2}$ description: ISO-3166-1 alpha-2 country code example: US baseCurrencyCode: type: string pattern: ^[A-Z]{3,4}$ description: ISO fiat currency code example: USD locale: type: string connection: type: string acceptedExchangeFeeBps: type: integer minimum: 0 maximum: 10000 connections: type: array items: type: string minLength: 1 maxLength: 64 minItems: 1 maxItems: 26 example: - coinbase - kraken merchantName: type: string maxLength: 64 description: >- Optional. Overrides the merchant name Swapped Connect shows on its confirm screen — both the "To:" row and its tooltip ("Funds will be delivered to your wallet."). Omit it to inherit the Rhinestone default. Send it raw; the service URL-encodes it. example: Superform merchantLogoUrl: type: string maxLength: 2048 format: uri description: >- Optional. Publicly accessible HTTPS URL of the merchant's logo, shown beside `merchantName` on the Swapped Connect confirm screen. PNG or SVG recommended. Send it raw; the service URL-encodes it. example: https://cdn.example.com/logo.svg required: - smartAccount SwappedUrlResponse: type: object properties: ok: type: boolean enum: - true url: type: string currencyCode: type: string sandbox: type: boolean externalCustomerId: type: string expiresAt: type: string exchangeFeeBps: type: integer minimum: 0 required: - ok - url - currencyCode - sandbox - externalCustomerId - expiresAt ErrorResponse: type: object properties: error: type: string code: type: string description: >- Deposit error code (e.g. `TOKEN-3`) when the refusal is one a deposit would also receive. details: type: array items: type: object properties: message: type: string path: type: array items: anyOf: - type: string - type: number code: type: string required: - message required: - error SwappedExchangeFeeChangedResponse: type: object properties: error: type: string exchangeFeeBps: type: integer minimum: 0 maximum: 10000 required: - error - exchangeFeeBps ````