> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hotstuff.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Action Requests

Use JSON-RPC `post` with `params.type: "action"` to call all Exchange/action endpoints from the REST API reference over WebSocket.

## Example Request

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "post",
  "params": {
    "type": "action",
    "payload": {
      "action": {
        "data": {
          "collateralId": 1,
          "amount": "50",
          "toDerivativesAccount": false,
          "nonce": 1774279181328
        },
        "type": "internalBalanceTransferRequest"
      },
      "signature": "0x22ea3cd743b8c1090ab6987fddfec85d9d9d459e9ca2060295243b0a2065247424b431b6f7bbd60e1f0b0540b1de390c760eb6c518455430fbd64f5ba0451ef11c",
      "nonce": 1774279181328
    }
  }
}
```


## AsyncAPI

````yaml asyncapi/ws-subscriptions.json rpc-post-action
id: rpc-post-action
title: Rpc-post-action
description: ''
servers:
  - id: production
    protocol: wss
    host: api.hotstuff.trade/ws
    bindings: []
    variables: []
  - id: testnet
    protocol: wss
    host: testnet-api.hotstuff.trade/ws
    bindings: []
    variables: []
address: /
parameters: []
bindings: []
operations:
  - &ref_3
    id: rpc-post-action_receiveRequest
    title: Rpc-post-action_receive request
    type: receive
    messages:
      - &ref_5
        id: request
        contentType: application/json
        payload:
          - name: JSON-RPC post action request
            description: >-
              Request-response call over WebSocket for Exchange action REST
              methods.
            type: object
            properties:
              - name: jsonrpc
                type: string
                examples: &ref_0
                  - '2.0'
                required: true
              - name: id
                type: integer
                description: Client request identifier.
                required: true
              - name: method
                type: string
                enumValues:
                  - post
                required: true
              - name: params
                type: object
                required: true
                properties:
                  - name: type
                    type: string
                    enumValues:
                      - action
                    required: true
                  - name: payload
                    type: object
                    required: true
                    properties:
                      - name: action
                        type: object
                        description: Action payload matching Exchange endpoint format.
                        required: true
                      - name: signature
                        type: string
                        description: Signed payload produced by wallet.
                        required: true
                      - name: nonce
                        type: integer
                        required: true
        headers: []
        jsonPayloadSchema:
          type: object
          properties:
            jsonrpc:
              type: string
              default: '2.0'
              examples: *ref_0
              x-parser-schema-id: <anonymous-schema-346>
            id:
              type: integer
              description: Client request identifier.
              x-parser-schema-id: <anonymous-schema-347>
            method:
              type: string
              enum:
                - post
              default: post
              x-parser-schema-id: <anonymous-schema-348>
            params:
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - action
                  x-parser-schema-id: <anonymous-schema-350>
                payload:
                  type: object
                  properties:
                    action:
                      type: object
                      description: Action payload matching Exchange endpoint format.
                      x-parser-schema-id: <anonymous-schema-352>
                    signature:
                      type: string
                      description: Signed payload produced by wallet.
                      x-parser-schema-id: <anonymous-schema-353>
                    nonce:
                      type: integer
                      x-parser-schema-id: <anonymous-schema-354>
                  required:
                    - action
                    - signature
                    - nonce
                  x-parser-schema-id: <anonymous-schema-351>
              required:
                - type
                - payload
              x-parser-schema-id: <anonymous-schema-349>
          required:
            - jsonrpc
            - id
            - method
            - params
          x-parser-schema-id: <anonymous-schema-345>
        title: JSON-RPC post action request
        description: Request-response call over WebSocket for Exchange action REST methods.
        example: |-
          {
            "jsonrpc": "2.0",
            "id": 2,
            "method": "post",
            "params": {
              "type": "action",
              "payload": {
                "action": {
                  "data": {
                    "collateralId": 1,
                    "amount": "50",
                    "toDerivativesAccount": false,
                    "nonce": 1774279181328
                  },
                  "type": "internalBalanceTransferRequest"
                },
                "signature": "0x22ea3cd743b8c1090ab6987fddfec85d9d9d459e9ca2060295243b0a2065247424b431b6f7bbd60e1f0b0540b1de390c760eb6c518455430fbd64f5ba0451ef11c",
                "nonce": 1774279181328
              }
            }
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: request
    bindings: []
    extensions: &ref_2
      - id: x-parser-unique-object-id
        value: rpc-post-action
  - &ref_4
    id: rpc-post-action_sendResponse
    title: Rpc-post-action_send response
    type: send
    messages:
      - &ref_6
        id: response
        contentType: application/json
        payload:
          - name: JSON-RPC post response
            description: Success or error response for post requests.
            type: object
            properties:
              - name: jsonrpc
                type: string
                examples: &ref_1
                  - '2.0'
                required: true
              - name: id
                type: integer
                required: true
              - name: description
                type: string
                description: Method-specific success payload for Info or Exchange request.
                required: false
              - name: error
                type: object
                required: false
                properties:
                  - name: code
                    type: integer
                    required: true
                  - name: message
                    type: string
                    required: true
        headers: []
        jsonPayloadSchema:
          type: object
          properties:
            jsonrpc:
              type: string
              examples: *ref_1
              x-parser-schema-id: <anonymous-schema-338>
            id:
              type: integer
              x-parser-schema-id: <anonymous-schema-339>
            result:
              description: Method-specific success payload for Info or Exchange request.
              x-parser-schema-id: <anonymous-schema-340>
            error:
              type: object
              properties:
                code:
                  type: integer
                  x-parser-schema-id: <anonymous-schema-342>
                message:
                  type: string
                  x-parser-schema-id: <anonymous-schema-343>
                data:
                  x-parser-schema-id: <anonymous-schema-344>
              required:
                - code
                - message
              x-parser-schema-id: <anonymous-schema-341>
          required:
            - jsonrpc
            - id
          x-parser-schema-id: <anonymous-schema-337>
        title: JSON-RPC post response
        description: Success or error response for post requests.
        example: |-
          {
            "jsonrpc": "2.0",
            "id": 1,
            "result": {
              "instruments": []
            }
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: response
    bindings: []
    extensions: *ref_2
sendOperations:
  - *ref_3
receiveOperations:
  - *ref_4
sendMessages:
  - *ref_5
receiveMessages:
  - *ref_6
extensions:
  - id: x-parser-unique-object-id
    value: rpc-post-action
securitySchemes: []

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.