Action

Partner action lifecycle endpoints

Create deposit action

post

Creates a partner deposit action and returns execution payloads for approval/deposit transactions.

Authorizations

apiKeyAuth

X-API-KeystringRequired

Body

application/json

strategyIdstringRequired

Strategy identifier.

Example: stable_vault

externalIdstringRequired

Partner idempotency key unique per partner.

Example: partner-deposit-20260301-001

addressstringRequired

User EVM wallet address.

Example: 0x1111111111111111111111111111111111111111

networkstring · enumRequired

Source network for deposit.

Example: basePossible values:

amountstringRequired

Human-readable token amount.

Example: 1.0Pattern: ^\d+(\.\d+)?$

tokenstringRequired

Input token symbol or configured token id.

Example: USDC

Responses

200

Deposit action created.

application/json

400

Invalid deposit action request.

application/json

401

Missing or invalid X-API-Key.

application/json

409

Duplicate partner externalId for this action.

application/json

429

Rate limit exceeded.

application/json

post

/v1/action/deposit

HTTPcURLJavaScriptPython

POST /v1/action/deposit HTTP/1.1
Host: app.hakolabs.app
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 175

{
  "strategyId": "stable_vault",
  "externalId": "partner-deposit-20260301-001",
  "address": "0x1111111111111111111111111111111111111111",
  "network": "base",
  "amount": "1.0",
  "token": "USDC"
}

{
  "id": "3f0ae4f8-4cb4-4cf5-9e52-1f6c0f4ec8a1",
  "externalId": "partner-deposit-20260301-001",
  "type": "deposit",
  "status": "NEW",
  "createdAt": "2026-03-01T10:00:00.000Z",
  "address": "0x1111111111111111111111111111111111111111",
  "decimals": 6,
  "network": "base",
  "amount": 1,
  "amountUsd": 1,
  "amountRaw": "1000000",
  "approvalTx": {
    "network": "base",
    "token": "USDC",
    "amountRaw": "1000000",
    "spenderAddress": "0xda6600Dd3124f07EC82304b059248e5b529864df",
    "tx": {
      "to": "0xda6600Dd3124f07EC82304b059248e5b529864df",
      "data": "0xb6b55f25000000000000000000000000...",
      "value": "0"
    }
  },
  "transaction": {
    "network": "base",
    "tx": {
      "to": "0xda6600Dd3124f07EC82304b059248e5b529864df",
      "data": "0xb6b55f25000000000000000000000000...",
      "value": "0"
    }
  }
}

Create withdraw action

post

Creates a partner withdraw action and returns typed-data authorization payload for user signing.

Authorizations

apiKeyAuth

X-API-KeystringRequired

Body

application/json

strategyIdstringRequired

Strategy identifier.

Example: stable_vault

externalIdstringRequired

Partner idempotency key unique per partner.

Example: partner-withdraw-20260301-001

addressstringRequired

User EVM wallet address.

Example: 0x1111111111111111111111111111111111111111

receiverstringOptional

Optional receiver address. Defaults to address when omitted.

Example: 0x2222222222222222222222222222222222222222

networkstring · enumRequired

Network where shares are redeemed.

Example: basePossible values:

amountstringRequired

Human-readable token amount to withdraw.

Example: 1.0Pattern: ^\d+(\.\d+)?$

tokenstringRequired

Token symbol or configured token id.

Example: USDC

Responses

200

Withdraw action created.

application/json

400

Invalid withdraw action request.

application/json

401

Missing or invalid X-API-Key.

application/json

409

Duplicate partner externalId for this action.

application/json

429

Rate limit exceeded.

application/json

post

/v1/action/withdraw

HTTPcURLJavaScriptPython

POST /v1/action/withdraw HTTP/1.1
Host: app.hakolabs.app
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 232

{
  "strategyId": "stable_vault",
  "externalId": "partner-withdraw-20260301-001",
  "address": "0x1111111111111111111111111111111111111111",
  "receiver": "0x2222222222222222222222222222222222222222",
  "network": "base",
  "amount": "1.0",
  "token": "USDC"
}

{
  "id": "7797f2f3-1cb8-449d-9f8d-16754df73f06",
  "externalId": "partner-withdraw-20260301-001",
  "type": "withdraw",
  "status": "NEW",
  "createdAt": "2026-03-01T10:00:00.000Z",
  "address": "0x1111111111111111111111111111111111111111",
  "receiver": "0x2222222222222222222222222222222222222222",
  "token": "USDC",
  "decimals": 6,
  "network": "base",
  "amount": 1.6,
  "amountUsd": 1.57,
  "amountRaw": "1600000",
  "expiresAt": "2026-03-01T12:00:00.000Z",
  "authorization": "{\"domain\":{\"name\":\"Hako Withdraw\",\"version\":\"1\",\"chainId\":8453,\"verifyingContract\":\"0xda6600Dd3124f07EC82304b059248e5b529864df\"},\"types\":{\"Authorization\":[{\"name\":\"actionId\",\"type\":\"string\"},{\"name\":\"owner\",\"type\":\"address\"},{\"name\":\"receiver\",\"type\":\"address\"}]},\"primaryType\":\"Authorization\",\"message\":{\"actionId\":\"7797f2f3-1cb8-449d-9f8d-16754df73f06\",\"owner\":\"0x1111111111111111111111111111111111111111\",\"receiver\":\"0x2222222222222222222222222222222222222222\"}}"
}

Report deposit transaction hash

post

Authorizations

apiKeyAuth

X-API-KeystringRequired

Path parameters

actionIdstring · uuidRequired

Deposit action UUID.

Body

application/json

txHashstringRequired

Transaction hash submitted by partner after user sends deposit tx.

Example: 0x4ca8a43f1b800ce3edaed2faece0ea55566f4768ba22cb0fa10e60150587be52Pattern: ^0x[a-fA-F0-9]{64}$

networkstring · enumRequired

Network where the reported transaction was broadcast.

Example: basePossible values:

Responses

200

Deposit transaction hash was accepted.

application/json

400

Invalid tx hash, network, or payload.

application/json

401

Missing or invalid X-API-Key.

application/json

404

Action was not found for this partner.

application/json

409

Action status is not reportable.

application/json

429

Rate limit exceeded.

application/json

post

/v1/action/{actionId}/report

HTTPcURLJavaScriptPython

POST /v1/action/{actionId}/report HTTP/1.1
Host: app.hakolabs.app
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 96

{
  "txHash": "0x4ca8a43f1b800ce3edaed2faece0ea55566f4768ba22cb0fa10e60150587be52",
  "network": "base"
}

{
  "status": "ok"
}

Authorize withdrawal with user signature

post

Authorizations

apiKeyAuth

X-API-KeystringRequired

Path parameters

actionIdstring · uuidRequired

Withdraw action UUID.

Body

application/json

signaturestringRequired

User typed-data signature for the withdrawal authorization payload.

Example: 0x9f3f5c6dca3d9f7afeca45b611d5c56f3b4b10d4f354978e95f3c89f889ca6ce2cdba4359b402cc7c4f5cb2478f730f2c7f1078572f2fd66fef00f9f5f4d27ce1cPattern: ^0x[a-fA-F0-9]+$

Responses

200

Authorization accepted and relay transaction submitted.

application/json

400

Invalid signature, nonce, or authorization payload.

application/json

401

Missing or invalid X-API-Key.

application/json

404

Action was not found for this partner.

application/json

409

Action cannot be authorized in current status.

application/json

429

Rate limit exceeded.

application/json

post

/v1/action/{actionId}/authorize

HTTPcURLJavaScriptPython

POST /v1/action/{actionId}/authorize HTTP/1.1
Host: app.hakolabs.app
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 148

{
  "signature": "0x9f3f5c6dca3d9f7afeca45b611d5c56f3b4b10d4f354978e95f3c89f889ca6ce2cdba4359b402cc7c4f5cb2478f730f2c7f1078572f2fd66fef00f9f5f4d27ce1c"
}

{
  "status": "ok",
  "txHash": "0x4ca8a43f1b800ce3edaed2faece0ea55566f4768ba22cb0fa10e60150587be52"
}

Get action by id

get

Authorizations

apiKeyAuth

X-API-KeystringRequired

Path parameters

actionIdstring · uuidRequired

Action UUID.

Responses

200

Action found.

application/json

Responseone of

or

400

actionId must be a valid UUID.

application/json

401

Missing or invalid X-API-Key.

application/json

404

Action was not found for this partner.

application/json

429

Rate limit exceeded.

application/json

get

/v1/action/{actionId}

HTTPcURLJavaScriptPython

GET /v1/action/{actionId} HTTP/1.1
Host: app.hakolabs.app
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "id": "3f0ae4f8-4cb4-4cf5-9e52-1f6c0f4ec8a1",
  "externalId": "partner-deposit-20260301-001",
  "type": "deposit",
  "status": "NEW",
  "createdAt": "2026-03-01T10:00:00.000Z",
  "address": "0x1111111111111111111111111111111111111111",
  "decimals": 6,
  "network": "base",
  "amount": 1,
  "amountUsd": 1,
  "amountRaw": "1000000",
  "approvalTx": {
    "network": "base",
    "token": "USDC",
    "amountRaw": "1000000",
    "spenderAddress": "0xda6600Dd3124f07EC82304b059248e5b529864df",
    "tx": {
      "to": "0xda6600Dd3124f07EC82304b059248e5b529864df",
      "data": "0xb6b55f25000000000000000000000000...",
      "value": "0"
    }
  },
  "transaction": {
    "network": "base",
    "tx": {
      "to": "0xda6600Dd3124f07EC82304b059248e5b529864df",
      "data": "0xb6b55f25000000000000000000000000...",
      "value": "0"
    }
  }
}