Crypto Actions Notifications

Crypto Actions refer to events or changes that affect crypto assets, similar to traditional corporate actions in the stock market.
These actions can include various events such as crypto/token merger, burns, modifications/rebranding and more.
Notifications for crypto actions are needed by partners to stay informed about changes that may impact the asset value, structure, and portfolio of their users.

Merger Crypto: A specific type of crypto action where two or more crypto assets are combined into a single, unified asset.
This process is comparable to traditional corporate mergers, aiming to streamline operations within the blockchain ecosystem.

Examples

Merger Crypto

There can be 2 cases:

The payload contains 2 transactions (1 outgoing & 1 incoming) for each asset pair that is merged

{
  "params": {
    "id": "c125f2e8-e4b7-4776-a634-0a351ecd1dee",
    "user_id": "1ef39d79-9339-678a-837c-3d4fce1bebbd",
    "type": "merger_crypto",
    "credited_at": "2024-07-04T07:40:11Z",
    "transactions": [
      {
        "id": "c125f2e8-e4b7-4776-a634-0a351ecd1dee",
        "asset_id": "1edcf0f1-0267-687e-8fc8-8aa7f8be420e",
        "asset_int": 4108,
        "fiat_id": "ea96ccef-edee-11eb-9bf0-06502b1fe55d",
        "fiat_int": 1,
        "asset_amount": "3501.04394764",
        "fiat_amount": "10.69",
        "fee_amount": "0",
        "type_defined_for": "asset",
        "direction": "outgoing"
      },
      {
        "id": "587b8cca-b3f9-4549-815a-82be8a197dca",
        "asset_id": "fb9e023f-ae71-11ec-87a8-024dd640430f",
        "asset_int": 2473,
        "fiat_id": "ea96ccef-edee-11eb-9bf0-06502b1fe55d",
        "fiat_int": 1,
        "asset_amount": "1516.74326526",
        "fiat_amount": "1677.97",
        "fee_amount": "0",
        "type_defined_for": "asset",
        "direction": "incoming"
      }
    ]
  }
}

The payload contains 1 transaction (1 outgoing) which occurs only when there is a very small position that cannot be converted due to the ratio being less than 1 (also known as dust removal).

{
  "params": {
    "id": "c125f2e8-e4b7-4776-a634-0a351ecd1dee",
    "user_id": "1ef39d79-9339-678a-837c-3d4fce1bebbd",
    "type": "merger_crypto",
    "credited_at": "2024-07-04T07:40:11Z",
    "transactions": [
      {
        "id": "c125f2e8-e4b7-4776-a634-0a351ecd1dee",
        "asset_id": "1edcf0f1-0267-687e-8fc8-8aa7f8be420e",
        "asset_int": 4108,
        "fiat_id": "ea96ccef-edee-11eb-9bf0-06502b1fe55d",
        "fiat_int": 1,
        "asset_amount": "0.0000000012",
        "fiat_amount": "0.00000001",
        "fee_amount": "0",
        "type_defined_for": "asset",
        "direction": "outgoing"
      },
    ]
  }
}

curl --location --request POST 'https://your-api-server.com' \ --header 'Content-Type: application/json' \ --data-raw '{ "params": { "id": "abcd1234-12ab-ab12-abcdef123456", "user_id": "abcd1234-12ab-ab12-abcdef123456", "type": "merger_crypto", "credited_at": "2023-01-09T13:08:00Z", "transactions": [ { "id": "c125f2e8-e4b7-4776-a634-0a351ecd1dee", "asset_id": "1edcf0f1-0267-687e-8fc8-8aa7f8be420e", "asset_int": 1, "fiat_id": "1edcf0f1-0267-687e-8fc8-8aa7f8be420e", "fiat_int": 1, "asset_amount": "120.02", "fiat_amount": "5930.20", "fee_amount": "0", "type_defined_for": "fiat", "direction": "incoming" } ] } }'

Examples

Merger Crypto

Request

Responses

Crypto Actions Notifications

Examples#

Merger Crypto#

Request

Responses

Examples

Merger Crypto