Ctrl+K

Add reward adjustments for delegations

post/api/staking/v1/admin/{coin}/wallets/{walletId}/adjustments

Admin endpoint to add adjustment records for delegations. Only supports ETH, GTETH, and HTETH coins. Delegations must be in COMPLETE status and fully withdrawn (WITHDRAWAL_DONE). Processes adjustments for negative balances that don't exceed the configured threshold.

Path Parameters

  • coinstringRequired
    The staking asset.
    Enum: ADA APT ASI KAVA ATOM AVAXC AVAXP BABY BERA BLD BSC BTC COREDAO COREUM CRONOS CSPR DOT EIGEN ETH FLRP HASH INJECTIVE MATIC NEAR OSMO POL POLYX RETH-ROCKET SEI SOMI SOL STORY STX SUI SUI:WAL TAO TIA TON TRX WETH WCT WFLR ZETA
  • walletIdstringRequired
    The wallet ID.
    Example: 59cd72485007a239fb00282ed480da1f

Request Body

delegationIds array[string] required
List of delegation IDs to process adjustments for
Min items: >= 1 items
Example: ["123e4567-e89b-12d3-a456-426614174000","123e4567-e89b-12d3-a456-426614174001"]
note
string or null
Optional note to include with the adjustment
Example: Manual adjustment for consensus layer discrepancy
dryRun boolean
If true, simulates the adjustment without persisting changes. Defaults to false.
Default: false
Example: false
adjustmentDate
string or null
<date-time>
Optional historical timestamp for when the adjustment should apply. If not provided, will be automatically derived from the final withdrawal/claim record for that delegation. If no claim exists, defaults to now().
Example: 2024-12-31T23:59:59.000Z

200 Response

processedDelegations array[object]
Result of processing an adjustment for a single delegation
delegationId string
The delegation ID that was processed
Example: 123e4567-e89b-12d3-a456-426614174000
adjustmentAmount string
Amount adjusted (in base units, e.g., wei for ETH)
Example: 1000000000000000
calculatedBalance string
Calculated balance before adjustment (in base units, e.g., wei for ETH)
Example: -1000000000000000
period
string or null
Reward period for the adjustment (epoch or slot number)
Example: 12345
status string
Status of the adjustment processing: - SUCCESS: Adjustment was created successfully - DRY_RUN_SUCCESS: Dry run completed successfully (no changes persisted) - SKIPPED: Delegation was skipped (see reason field for details) - ERROR: An error occurred during processing (see reason field for details)
Allowed values: SUCCESS DRY_RUN_SUCCESS SKIPPED ERROR
reason
string or null
Reason for the status (especially for SKIPPED or ERROR statuses)
Example: Delegation not in COMPLETE status (current: ACTIVE)
summary object
Summary statistics of the adjustment processing
totalDelegations integer
Total number of delegations processed
Example: 5
successfulAdjustments integer
Number of successful adjustments
Example: 3
skippedDelegations integer
Number of delegations that were skipped
Example: 2
totalAdjustmentAmount string
Total amount adjusted across all successful adjustments (in base units)
Example: 3000000000000000

400 Response

error string
errorName string
reqId string
context object

401 Response

error string
errorName string
reqId string
context object

403 Response

error string
errorName string
reqId string
context object

500 Response

error string
errorName string
reqId string
context object