Cregis Developer Docs
POST/api/v1/trade/page

Query Historical Transactions

Query paginated transaction records for a WaaS project, including incoming and outgoing transactions. Supports filtering by status, transaction type, and block time range.

Rate limit: 30 requests/minute

Request

Request Body

required

application/json
  • noncestringrequired

    6-character random string.

  • timestampinteger<int64>required

    Timestamp.

  • signstringrequired

    Signature.

  • pidinteger<int64>required

    Project ID.

  • cidinteger<int64>

    Cregis order ID.

  • tx_idstring

    Transaction hash.

  • statusinteger<int32>
    enum: 0, 1, 2

    Transaction status

    • 0pending confirmation
    • 1successful
    • 2failed
  • trade_typeinteger<int32>
    enum: 1, 2

    Transaction type

    • 1transfer in
    • 2transfer out
  • business_typeinteger<int32>
    enum: 0, 2, 3, 4, 5

    Business type

    • 0normal transaction
    • 2review transaction
    • 3address deposit
    • 4collection fee
    • 5collection
  • blocktime_startinteger<int64>

    Block time query start timestamp, 10 digits.

  • blocktime_endinteger<int64>

    Block time query end timestamp, 10 digits.

  • chain_idstring

    Main chain identifier.

  • token_idstring

    Token ID.

  • page_numinteger<int32>

    Page number. Defaults to 1 if omitted.

  • page_sizeinteger<int32>

    Number of records per page. Defaults to 10 if omitted. Maximum value is 100.

Responses

200Success
application/json
  • codestring

    Response code.

  • msgstring

    Response message.

  • dataobject

    Response data.

    • totalinteger<int64>

      Total number of records.

    • page_numinteger<int32>

      Current page number.

    • page_sizeinteger<int32>

      Number of records per page.

    • rowsarray<object>

      Transaction record list.

      Array items · object

      • cidinteger<int64>

        System serial number.

      • pidinteger<int64>

        Project ID.

      • statusinteger<int32>
        enum: 0, 1, 2

        Transaction status

        • 0pending confirmation
        • 1successful
        • 2failed
      • amountstring

        Amount.

      • currencystring

        Currency identifier.

      • chain_idstring

        Main chain identifier.

      • token_idstring

        Token ID.

      • from_addressstring

        Source address.

      • to_addressstring

        Destination address.

      • txidstring

        Transaction hash.

      • block_heightstring

        Block height.

      • block_timeinteger<int64>

        Block time.

      • feestring

        Transaction fee.