Token conversion triggers

When you submit a conversion, you reference a triggerId, and DALP prices and authorises that conversion against the named trigger. A conversion trigger is the priced, authorised round a holder converts against, and it carries the round price, the discount and cap that produce the effective price, an expiry, and an active flag.

Discover the triggers on a token, read the effective price each one offers, and audit when a trigger was published, disabled, or republished using the two read endpoints below. Both are read-only: they list and report triggers but cannot publish, disable, or execute against them.

List triggers

Call GET /api/v2/tokens/{tokenAddress}/conversion/triggers for the source token that carries the Conversion feature. The response uses the standard DALP paginated list shape.

curl --globoff "$DAPI_URL/api/v2/tokens/0x1111111111111111111111111111111111111111/conversion/triggers?page[limit]=50&filter[active]=true" \
  -H "X-Api-Key: $DALP_API_TOKEN"

{
  "data": [
    {
      "triggerId": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "denominationAsset": "0x3333333333333333333333333333333333333333",
      "roundPricePerShareWad": "1",
      "roundPricePerShareWadExact": "1000000000000000000",
      "effectivePriceWad": "0.95",
      "effectivePriceWadExact": "950000000000000000",
      "publishedAt": "2026-06-06T12:00:00.000Z",
      "expiresAt": "2026-07-06T12:00:00.000Z",
      "metadataHash": "0xcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
      "active": true,
      "disabledAt": null,
      "totalConversions": 12,
      "totalPrincipalConverted": "1000",
      "totalPrincipalConvertedExact": "1000000000000000000000"
    }
  ],
  "meta": {
    "total": 1,
    "facets": {}
  },
  "links": {
    "self": "/v2/tokens/0x1111111111111111111111111111111111111111/conversion/triggers?page%5Boffset%5D=0&page%5Blimit%5D=50"
  }
}

If the token has no attached Conversion feature in the indexed tenant scope, DALP returns an empty data array with total set to 0. It does not infer triggers from another token or tenant.

Trigger fields

The effective price is the number to show a holder and to reconcile against, because the round price does not yet account for the configured discount and cap. The raw *Exact fields carry the precise on-chain values; use them for any arithmetic and use the display fields for presentation.

Query controls

The list endpoint supports pagination, sorting, filtering, and facets using the standard JSON:API query pattern.

Read trigger lifecycle events

Call GET /api/v2/tokens/{tokenAddress}/conversion/events to read the append-only lifecycle of the token's conversion triggers. Each event records a point at which a trigger was published, disabled, or republished.

curl --globoff "$DAPI_URL/api/v2/tokens/0x1111111111111111111111111111111111111111/conversion/events?sort=-blockTimestamp" \
  -H "X-Api-Key: $DALP_API_TOKEN"

{
  "data": [
    {
      "triggerId": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "kind": "published",
      "eventIndex": 0,
      "denominationAsset": "0x3333333333333333333333333333333333333333",
      "roundPricePerShareWad": "1",
      "roundPricePerShareWadExact": "1000000000000000000",
      "expiresAt": "2026-07-06T12:00:00.000Z",
      "metadataHash": "0xcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
      "blockNumber": "184920",
      "blockTimestamp": "2026-06-06T12:00:00.000Z",
      "txHash": "0xdddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
      "logIndex": 3
    }
  ],
  "meta": {
    "total": 1,
    "facets": {}
  },
  "links": {
    "self": "/v2/tokens/0x1111111111111111111111111111111111111111/conversion/events?sort=-blockTimestamp&page%5Boffset%5D=0&page%5Blimit%5D=50"
  }
}

Event fields

A republished event records that a trigger's terms were observed again on-chain; it appends a new event row rather than mutating an earlier one. Each trigger is identified by a unique triggerId, so introducing new conversion terms means publishing a fresh trigger with its own triggerId, not re-publishing an existing one. To rebuild the full history of a trigger, read its events in blockTimestamp order and treat the latest publish or republish observation as the terms recorded at any point in time.

Query controls

SDK and CLI

The same reads are available through the SDK and CLI.

const triggers = await client.token.conversionTriggers({
  params: { tokenAddress: "0x1111111111111111111111111111111111111111" },
  query: { filter: { active: true } },
});

const events = await client.token.conversionTriggerEvents({
  params: { tokenAddress: "0x1111111111111111111111111111111111111111" },
  query: { sort: "-blockTimestamp" },
});

dalp tokens conversion-triggers 0x1111111111111111111111111111111111111111
dalp tokens conversion-trigger-events 0x1111111111111111111111111111111111111111

Behaviour and failure cases

• If the token has no attached Conversion feature, both endpoints return an empty paginated response rather than an error.
• A disabled trigger stays in the trigger list with active set to false and a populated disabledAt, so historical pricing remains readable.
• The events endpoint is append-only. A republished event is a new row recording a fresh on-chain observation of a trigger's terms, never an edit to an existing row.
• Both endpoints read indexed data. The read does not make a live contract call, publish a trigger, or execute a conversion.

Related

• Token conversion records
• Conversion token feature
• Token lifecycle API
• API reference