HTTP API reference › GalaSwap DEX › incentive

GalaSwap DEX — incentive

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

7 operations in this group.

• GET /incentive/programs — GET /incentive/programs
• GET /incentive/program/pool/{poolHash} — GET /incentive/program/pool/{poolHash}
• GET /incentive/reward/{walletAddress}/{poolHash} — GET /incentive/reward/{walletAddress}/{poolHash}
• POST /incentive/reward/query — POST /incentive/reward/query
• GET /incentive/wallet/{walletAddress} — GET /incentive/wallet/{walletAddress}
• POST /incentive/enroll — POST /incentive/enroll
• GET /incentive/analytics/{programId} — GET /incentive/analytics/{programId}

GET /incentive/programs

IncentiveController_getActivePrograms

GET /incentive/programs

GET /incentive/programs

Security: []

Responses

200 —

Content type: application/json

Schema: array<ActiveIncentiveProgramResponse>

Field	Type	Required	Description
items.id	number	yes
items.name	string	yes
items.poolHash	string	yes
items.bonusToken	string nullable	yes
items.bonusPoolAmount	string nullable	yes
items.status	string enum: PENDING, ACTIVE, COMPLETED, CANCELLED	yes
items.startTime	string (date-time)	yes
items.endTime	string (date-time)	yes
items.requiresFullRange	boolean	yes
items.minPositionValueUsd	number nullable	yes
items.termsUrl	string nullable	yes
items.totalTvl	string	yes
items.participantCount	number	yes

default — An error response using the shared backend error envelope.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
status	integer	yes
error	boolean	yes
message	string	yes
errorKey	string	no

Example response

[]

GET /incentive/program/pool/{poolHash}

IncentiveController_getProgramByPool

GET /incentive/program/pool/{poolHash}

GET /incentive/program/pool/{poolHash}

Security: []

Parameters

Name	In	Required	Type	Description
poolHash	path	yes	string

Responses

200 —

Content type: application/json

Schema: oneOf: ActiveIncentiveProgramResponse | object nullable enum:

Field	Type	Required	Description
id	number	yes
name	string	yes
poolHash	string	yes
bonusToken	string nullable	yes
bonusPoolAmount	string nullable	yes
status	string enum: PENDING, ACTIVE, COMPLETED, CANCELLED	yes
startTime	string (date-time)	yes
endTime	string (date-time)	yes
requiresFullRange	boolean	yes
minPositionValueUsd	number nullable	yes
termsUrl	string nullable	yes
totalTvl	string	yes
participantCount	number	yes
*	free-form object	no	Additional properties allowed

default — An error response using the shared backend error envelope.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
status	integer	yes
error	boolean	yes
message	string	yes
errorKey	string	no

Example response

[]

GET /incentive/reward/{walletAddress}/{poolHash}

IncentiveController_getUserReward

GET /incentive/reward/{walletAddress}/{poolHash}

GET /incentive/reward/{walletAddress}/{poolHash}

Security: []

Parameters

Name	In	Required	Type	Description
walletAddress	path	yes	string
poolHash	path	yes	string
positionId	query	no	string
tickLower	query	no	string
tickUpper	query	no	string

Responses

200 —

Content type: application/json

Schema: oneOf: IncentiveRewardResponse | object nullable enum:

Field	Type	Required	Description
programId	number	yes
programName	string	yes
status	string enum: ACTIVE, COMPLETED, DISQUALIFIED, CALCULATING	yes
bonusTokenSymbol	string	yes
bonusTokenReward	string	yes
sharePercentage	string	yes
isQualified	boolean	yes
disqualificationReason	string	no
timeRemainingSeconds	number	yes
distributionTxHash	string	no
programStartTime	string (date-time)	yes
programEndTime	string (date-time)	yes
*	free-form object	no	Additional properties allowed

400 —

Content type: application/json

Schema: IncentiveErrorResponseDto

Field	Type	Required	Description
statusCode	number	yes
message	oneOf: string | array<string>	yes
error	string	no

default — An error response using the shared backend error envelope.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
status	integer	yes
error	boolean	yes
message	string	yes
errorKey	string	no

Example response

[]

POST /incentive/reward/query

IncentiveController_getUserRewardPost

POST /incentive/reward/query

POST /incentive/reward/query

Security: []

Responses

200 —

Content type: application/json

Schema: oneOf: IncentiveRewardResponse | object nullable enum:

Field	Type	Required	Description
programId	number	yes
programName	string	yes
status	string enum: ACTIVE, COMPLETED, DISQUALIFIED, CALCULATING	yes
bonusTokenSymbol	string	yes
bonusTokenReward	string	yes
sharePercentage	string	yes
isQualified	boolean	yes
disqualificationReason	string	no
timeRemainingSeconds	number	yes
distributionTxHash	string	no
programStartTime	string (date-time)	yes
programEndTime	string (date-time)	yes
*	free-form object	no	Additional properties allowed

400 —

Content type: application/json

Schema: IncentiveErrorResponseDto

Field	Type	Required	Description
statusCode	number	yes
message	oneOf: string | array<string>	yes
error	string	no

default — An error response using the shared backend error envelope.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
status	integer	yes
error	boolean	yes
message	string	yes
errorKey	string	no

Example response

[]

GET /incentive/wallet/{walletAddress}

IncentiveController_getWalletPositions

GET /incentive/wallet/{walletAddress}

GET /incentive/wallet/{walletAddress}

Security: []

Parameters

Name	In	Required	Type	Description
walletAddress	path	yes	string

Responses

200 —

Content type: application/json

Schema: array<IncentiveRewardResponse>

Field	Type	Required	Description
items.programId	number	yes
items.programName	string	yes
items.status	string enum: ACTIVE, COMPLETED, DISQUALIFIED, CALCULATING	yes
items.bonusTokenSymbol	string	yes
items.bonusTokenReward	string	yes
items.sharePercentage	string	yes
items.isQualified	boolean	yes
items.disqualificationReason	string	no
items.timeRemainingSeconds	number	yes
items.distributionTxHash	string	no
items.programStartTime	string (date-time)	yes
items.programEndTime	string (date-time)	yes

400 —

Content type: application/json

Schema: IncentiveErrorResponseDto

Field	Type	Required	Description
statusCode	number	yes
message	oneOf: string | array<string>	yes
error	string	no

default — An error response using the shared backend error envelope.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
status	integer	yes
error	boolean	yes
message	string	yes
errorKey	string	no

Example response

[]

POST /incentive/enroll

IncentiveController_enrollPosition

POST /incentive/enroll

POST /incentive/enroll

Security: []

Request body

Required: yes

application/json

Schema: EnrollPositionDto

Field	Type	Required	Description
programId	number	yes	Incentive program identifier.
walletAddress	string	yes	Synthetic or caller wallet reference that owns the position.
tickLower	number	yes	Lower tick bound of the enrolled position.
tickUpper	number	yes	Upper tick bound of the enrolled position.
termsAcceptedTxHash	string	no	Transaction hash proving acceptance of program terms.

Responses

200 —

Content type: application/json

Schema: IncentiveProgramPositionResponseDto

Field	Type	Required	Description
id	number	yes
programId	number	yes
walletAddress	string	yes
owner	string nullable	yes
positionId	string	yes
tickLower	number nullable	yes
tickUpper	number nullable	yes
initialLiquidity	string	yes
initialValueUsd	number nullable	yes
isFullRange	boolean	yes
isQualified	boolean	yes
enrolledAt	string (date-time)	yes
disqualifiedAt	string (date-time) nullable	yes
disqualificationReason	string nullable	yes
termsAcceptedAt	string (date-time) nullable	yes
termsAcceptedIp	string nullable	yes
createdAt	string (date-time)	yes
updatedAt	string (date-time)	yes

400 —

Content type: application/json

Schema: IncentiveErrorResponseDto

Field	Type	Required	Description
statusCode	number	yes
message	oneOf: string | array<string>	yes
error	string	no

404 —

Content type: application/json

Schema: IncentiveErrorResponseDto

Field	Type	Required	Description
statusCode	number	yes
message	oneOf: string | array<string>	yes
error	string	no

default — An error response using the shared backend error envelope.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
status	integer	yes
error	boolean	yes
message	string	yes
errorKey	string	no

Example request

[]

Example response

[]

GET /incentive/analytics/{programId}

IncentiveController_getProgramAnalytics

GET /incentive/analytics/{programId}

GET /incentive/analytics/{programId}

Security: []

Parameters

Name	In	Required	Type	Description
programId	path	yes	number

Responses

200 —

Content type: application/json

Schema: array<IncentiveProgramAnalyticsResponseDto>

Field	Type	Required	Description
items.id	number	yes
items.programId	number	yes
items.snapshotTime	string (date-time)	yes
items.periodType	string enum: REALTIME, HOURLY, DAILY	yes
items.tvlUsd	number	yes
items.volume24hUsd	number	yes
items.fees24hUsd	number	yes
items.trailingApr24h	number nullable	yes
items.trailingApr7d	number nullable	yes
items.uniqueLpCount	number	yes
items.totalPositions	number	yes
items.qualifiedPositions	number	yes
items.totalFeesDistributed	number	yes
items.createdAt	string (date-time)	yes

default — An error response using the shared backend error envelope.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
status	integer	yes
error	boolean	yes
message	string	yes
errorKey	string	no

Example response

[]

---

Previous group: onramper · Next group: competition