GAgala
incentive

POST /incentive/enroll

POST /incentive/enroll

post/incentive/enroll

Request

Request body

programIdnumber required

Incentive program identifier.

walletAddressstring required

Synthetic or caller wallet reference that owns the position.

tickLowernumber required

Lower tick bound of the enrolled position.

tickUppernumber required

Upper tick bound of the enrolled position.

termsAcceptedTxHashstring

Transaction hash proving acceptance of program terms.

Example request

{
  "programId": 1,
  "walletAddress": "client|000000000000000000000000",
  "tickLower": -100,
  "tickUpper": 100,
  "termsAcceptedTxHash": "0x1234abcd"
}

Response

idnumber required
programIdnumber required
walletAddressstring required
ownerstring nullable required
positionIdstring required
tickLowernumber nullable required
tickUppernumber nullable required
initialLiquiditystring required
initialValueUsdnumber nullable required
isFullRangeboolean required
isQualifiedboolean required
enrolledAtstring date-time required
disqualifiedAtstring date-time nullable required
disqualificationReasonstring nullable required
termsAcceptedAtstring date-time nullable required
termsAcceptedIpstring nullable required
createdAtstring date-time required
updatedAtstring date-time required

Example response

{
  "id": 10,
  "programId": 1,
  "walletAddress": "client|000000000000000000000000",
  "owner": "client|000000000000000000000000",
  "positionId": "synthetic-position-id",
  "tickLower": -100,
  "tickUpper": 100,
  "initialLiquidity": "1000000000000000",
  "initialValueUsd": 1500.25,
  "isFullRange": true,
  "isQualified": true,
  "enrolledAt": "2026-08-01T00:00:00.000Z",
  "createdAt": "2026-08-01T00:00:00.000Z",
  "updatedAt": "2026-08-01T00:00:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.