Vesting by redeemer

Unspent vestings for a redeemer PKH

POST /v1/vesting/get-by-redeemer

cURL

curl --request POST \
  --url "https://token-vesting.snek.fun/v1/vesting/get-by-redeemer?redeemerVkhs=e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62" \
  --header "Content-Type: application/json" \
  --data '{}'

200

{
  "vestings": [
    {
      "id": "abc123:0",
      "lockUntil": "1778390035864",
      "redeemerVkh": "e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62",
      "tokenPolicyId": "fbd4d3c334063ac19566f6ba39b6ec707ea91fa81d0c09201575c10b",
      "tokenAssetName": "44415645",
      "totalLocked": "19525508",
      "vestingOwnerAddress": "addr1q9...",
      "spent": false
    }
  ]
}

Returns all unspent vestings whose redeemer matches the given verification key hash (query parameter).

Auth: Public

POST requests must include Content-Type: application/json. There is no JSON body schema in the endpoint — send an empty body or {} if your client requires a body.

Query parameters

redeemerVkhs · string · required

A single 56-character hex redeemer payment key hash (name is plural for historical reasons; one value).

Response

vestings · object[]

List of vesting rows.

Show properties

id · string

Vesting identifier (domain id / UTxO-derived).

lockUntil · string

Lock deadline (stringified; Unix-style value from domain).

redeemerVkh · string

Redeemer verification key hash (hex).

tokenPolicyId · string

Minting policy id for the locked token.

tokenAssetName · string

Hex-encoded asset name for the locked token.

totalLocked · string

Total locked amount (string).

vestingOwnerAddress · string

Raw address string associated with the vesting output.

spent · boolean

Whether the vesting UTxO has been spent (should be false for rows returned as unspent).

cURL

curl --request POST \
  --url "https://token-vesting.snek.fun/v1/vesting/get-by-redeemer?redeemerVkhs=e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62" \
  --header "Content-Type: application/json" \
  --data '{}'

200

{
  "vestings": [
    {
      "id": "abc123:0",
      "lockUntil": "1778390035864",
      "redeemerVkh": "e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62",
      "tokenPolicyId": "fbd4d3c334063ac19566f6ba39b6ec707ea91fa81d0c09201575c10b",
      "tokenAssetName": "44415645",
      "totalLocked": "19525508",
      "vestingOwnerAddress": "addr1q9...",
      "spent": false
    }
  ]
}