GalaSwap DEX API reference

Source commit: unknown. Generated: 2026-10-26T22:08:07.586Z.

This is the moving main/next specification. Production references must use the spec keyed to the deployed backend commit.

OpenAPI 3.0.0; 410 operations across 134 paths.

Servers

• https://swap-backend.stage.defi.ovh.gala.com
• https://dex-backend-prod1.defi.gala.com

Authentication schemes

• api-key: apiKey, header X-Api-Key
• shadow-bearer: http (bearer), JWT

Error envelope

• 400 Bad Request: CoinGeckoBadRequestResponseDto, CompetitionErrorResponseDto, IncentiveErrorResponseDto, MarketErrorResponseDto, MarketplaceErrorResponseDto, MarketplaceHttpErrorResponseDto, PairsHttpErrorResponseDto, ShadowHttpErrorResponseDto, TokenSupplyHttpErrorResponseDto, TradeCustomErrorResponseDto, TradeV2ErrorResponseDto, TradeValidationErrorResponseDto, WalletCompatErrorResponseDto
• 401: ProtocolFeeSweepHttpErrorResponseDto, ShadowHttpErrorResponseDto
• 403: ProtocolFeeSweepHttpErrorResponseDto, TradeCustomErrorResponseDto
• 404: CompetitionErrorResponseDto, IncentiveErrorResponseDto, MarketplaceHttpErrorResponseDto, TerminalNotFoundResponseDto, TradeCustomErrorResponseDto, TradeV2ErrorResponseDto
• 409: ProtocolFeeSweepHttpErrorResponseDto
• 410: WalletCompatErrorResponseDto
• 426: ExtensionVersionUpgradeRequiredResponseDto
• 500: UserErrorResponseDto
• 502: MarketErrorResponseDto, MarketplaceErrorResponseDto, TokenSupplyHttpErrorResponseDto
• 503: MarketplaceRateLimitResponseDto
• default An error response using the shared backend error envelope.: ApiErrorEnvelope

Tags

• onboarding — 1 operation
• user — 3 operations
• trade — 13 operations
• trade-v2 — 16 operations
• chain — 2 operations
• coin-gecko — 6 operations
• leaderboard — 4 operations
• pairs — 2 operations
• onramper — 1 operation
• incentive — 7 operations
• competition — 8 operations
• WalletExtensionCompat — 327 operations
• token-class — 1 operation
• market — 7 operations
• marketplace — 2 operations
• ExtensionVersion — 1 operation
• protocol-fee-sweep — 2 operations
• WhatsNew — 1 operation
• token-registry — 3 operations
• shadow — 3 operations

Schemas

• All 180 component schemas: every named request and response type, linked from the tables on the group pages.