Ctrl+K

Get pending TSS transaction requests for bulk OVC signing

get/api/v2/admin/txRequests/awaitingSignature/grouped

Returns pending TSS txRequests as a flat list, each item carrying a curve: 'ecdsa' | 'eddsa' field. At most limit records (default 500) are returned. When nextBatchPrevId is present, pass it as prevId to retrieve the next page. A multisig group will be added in a future release.

Query Parameters

  • limitstring<number>Default: 500
    Maximum total number of results to return across all curve-family groups combined.
    Minimum: >= 1
    Maximum: <= 500
  • prevIdstring
    Pagination cursor. Pass `nextBatchPrevId` from the previous response to retrieve the next page of results.
  • txRequestIdsarray[string]
    If provided, only the specified transaction requests will be returned
  • signingStagesarray[string]
    If provided, only transaction requests whose per-resource signing stage matches one of these values will be returned. Any mix of eddsa, ecdsa, and ecdsaMPCv2 stage values is accepted — results are grouped by curve family in the response. Omit to return all pending TSS stages
    Enum: 1-eddsa 2-eddsa 3-eddsa 4-eddsa 1-ecdsa 2-ecdsa 3-ecdsa 1-ecdsa-mpcv2 2-ecdsa-mpcv2 3-ecdsa-mpcv2 4-ecdsa-mpcv2
  • bitgoOrgstring
    Filter by BitGo org
    Enum: BitGo Trust BitGo New York BitGo Germany BitGo Switzerland BitGo Europe ApS Frankfurt DE Trust BitGo Singapore BitGo Korea BitGo Custody MENA FZE BitGo India BitGo Sister Trust 1 BitGo Inc
  • enterpriseIdstring
    Filter by enterprise ID
  • frozenboolean
    If true, only frozen transaction requests are returned
  • coinsarray[string]
    If provided, only transaction requests pertaining to specific coins will be returned
  • enterpriseSourcestring
    If provided, only transaction requests for ftx or non-ftx users will be returned
    Enum: ftx nonFtx
  • requestTypestring
    If provided, filter by request type (transaction or message)
    Enum: tx message
  • sortBystring
    Field to sort results by
    Enum: id createdDate
  • sortDirectionstring
    Sort direction
    Enum: ASC DESC

200 Response

txRequests array[object] required
walletLabel string
walletCoin string
enterpriseName string
recipientsInfo array[object]
ofcEnterpriseName string
ofcEnterpriseId string
ofcWalletId string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
ofcTransferComment string
freeze object
isTestTransaction boolean
memo array[object]
curve string
Allowed values: ecdsa eddsa
transactions array[object]
The transactions associated with the transaction request
messages array[object]
The messages associated with the transaction request
apiVersion string
The API version of the transaction request
Allowed values: lite full
txRequestId string <uuid>required
A unique ID for the TxRequest document across all wallets. The combination of the txRequestId and version will always be unique.
Example: 123e4567-e89b-12d3-a456-426614174000
idempotencyKey string
The idempotency key of the transaction request
walletId string required
The id of the Wallet the TxRequest is for.
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
walletType string
The type describes who owns the keys to the wallet associated to the TxRequest.
Allowed values: backing cold custodial custodialPaired hot advanced trading
version number required
The version of the transaction request
enterpriseId string
If the wallet that owns the TxRequest is owned by an enterprise then this is the Id of said enterprise.
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
state string required
Allowed values: pendingApproval canceled rejected initialized pendingDelivery delivered pendingUserSignature pendingUserCommitment pendingUserRShare pendingUserGShare readyToSend signed failed
date string <date-time>required
The date and time this version of the TxRequest document was created.
Example: 2021-01-01T00:00:00.000Z
createdDate string <date-time>required
The date and time the version 1 TxRequest document was created.
Example: 2021-01-01T00:00:00.000Z
userId string required
The Id of the User that produced this version of the TxRequest document. Could have created a new document or updated an existing document.
initiatedBy string required
The Id of the User that originally created the TxRequest document (initiated the TxRequest).
updatedBy string required
The Id of the User that last updated the TxRequest document. This is an alias for the userId field.
intent
The intent of the transaction request
intents array required
pendingApprovalId string
The id of the Pending Approval that was created for the TxRequest if one was required.
policiesChecked boolean
latest boolean required
Indicates if this is the latest transaction request
isCanceled boolean
True, if the transaction request is canceled.
errors array[object] required
enterpriseId string
enterpriseName string
walletId string
walletLabel string
coin string
pendingApprovalId string
unsignedTx object
transactions array[object]
message string required
stack string required
nextBatchPrevId string

400 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

401 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

403 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

404 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id