Skip to content
Stove Website

Process Single Pending Corporate Action ​

Endpoint: POST /api/v1/maker/corporate-actions/action/{action_id}/process

Description: Authorize processing of a single corporate action

Authentication: API Key + Signature. See Authorization

Request Parameters:

FieldTypeRequiredDescription
action_idstringYesRoute parameter, corporate action ID
asset_tokenstringYesURL parameter, asset token address

Response Parameters ​

FieldTypeDescription
codeintResult code. 0 for success
dataobjectResult object
data.iduuidAction record id
data.successboolWhether execution was successful
data.tx_hashstring|nullExecution transaction hash
data.errorstring|nullError description
data.chain_idint|nullBlockchain network ID

Request Example ​

bash
curl -X POST "{API_BASE_URL}/api/v1/maker/corporate-actions/action/123/process?asset_token=0x09671802Cc9Bbf6402f2e7a07b220Aa7b43D8c91" \
     -H "X-API-Key: YOUR_API_KEY" \
     -H "X-Maker-Addr: YOUR_MAKER_ADDRESS" \
     -H "X-API-Timestamp: 1715100000000" \
     -H "X-API-Signature: GENERATED_SIGNATURE" \
     -H "Content-Type: application/json"

Response Example ​

json
{
  "code": 0,
  "data": {
    "id": "string",
    "success": true,
    "tx_hash": "0x...",
    "error": null,
    "chain_id": 56
  }
}

Implementation Notes ​

  • The processing result includes a chain_id field, identifying which blockchain network the corporate action is executed on
  • tx_hash is the transaction hash on that chain, which can be used to query transaction details in the blockchain explorer
  • When processing is successful, success is true and error is null
  • When processing fails, success is false and error contains the error description