Response Example (data field) - 200 OK

{
  "uuid": "12ate4e6-3aau-5c78-bg5g-5561ec5202031",
  "name": "molly_finance",
  "webhook_url": "https://xxx.yyy",
  "api_key": "73adf5e2-88ec-4d86-ae1c-3081ec520f07"
}

Notes:

• uuid: Serves as the {ns_id} parameter in other namespace API endpoints

• api_key: Used as the password parameter when calling /system/login; the uuid is used as the name parameter for that endpoint

• webhook_url: Must be a valid URL (query parameters supported), maximum length 255 characters. This endpoint will be called back via POST method with JSON payload when deposit or withdrawal operations complete.

  • Deposit Callback (Fund In)

    When the system detects an incoming deposit to a wallet address, it will trigger a callback to the namespace's configured webhook_url. The recipient should then call the deposit query endpoint (/namespaces/{ns_id}/apps/{app_id}/groups/{group_id}/wallets/deposit) to retrieve detailed deposit information.

    Callback Method: POST
    Data Format: JSON

    Example

    {
      "type": "fund_in",
      "namespace_uuid": "xxx",
      "timestamp": 1768710650,
      "data": {
          "wallet_uuid": "5d36640c-f8f7-4ccd-9db1-4e41c0544cb6",
          "wallet_address": "0x77Ff7e20a30b8bf8B2466CC9494150080b019333",
          "tx_id": "5d3afdfdfedb6",
          "timestamp": 1768710650
      }
    }

  
  

  • Withdrawal Callback (Fund Out)

    After a withdrawal operation completes, the system will trigger a callback to the namespace's configured webhook_url.

    Callback Method: POST
    Data Format: JSON

    Example

    {
      "type": "fund_out",
      "namespace_uuid": "xxx",
      "timestamp": 1768710650,
      "data": {
          "wallet_address": "0x......",
          "task_id": "withdraw~0x9898...",
          "tx_hash": "0x00110033...",
          "status": "success",
          "timestamp": 1768710650
      }
    }

    Note: The status field can have the following values: success or failed.