Transactions

get

Get a paginated list of all transactions in the specified pool that match the provided filter

Path parameters

pool_idstringRequired

Pool ID in hex format

Query parameters

startDatestring | nullOptional

endDatestring | nullOptional

poolIdstring | nullOptional

Optional pool filter; hex-encoded pool id

token0string | nullOptional

Optional asset pair filter; provide both tokens to filter by a specific pair

token1string | nullOptional

typesarray | nullOptional

cursorstring | nullOptional

limitinteger | nullOptional

sortCreatedAtone ofOptional

nullOptional

or

string · enumOptionalPossible values:

bitcoinTxStatusstring | nullOptional

Responses

200

List of transactions

application/json

400

Invalid pubkey format

get

/transaction/pool/{pool_id}

HTTPcURLJavaScriptPython

GET /transaction/pool/{pool_id} HTTP/1.1
Host: 127.0.0.1:3000
Accept: */*

{
  "response": [
    {
      "id": "text",
      "status": {
        "type": "queued"
      },
      "rollbackStatus": {
        "message": "text",
        "type": "rolledback"
      },
      "bitcoinTxId": null,
      "bitcoinBlockHeight": null,
      "bitcoinTxStatus": null,
      "blockHeight": "text",
      "poolPubkey": "text",
      "userPubkey": "text",
      "transactionType": "open_position",
      "createdAt": "2025-12-14T05:27:33.000Z",
      "details": {
        "type": "initialize_protocol"
      },
      "writableAccounts": [
        "text"
      ]
    }
  ],
  "nextCursor": null
}

get

Fetches a paginated list of user's transactions that match the provided filter

Path parameters

pubkeystringRequired

User public key in hex format

Query parameters

startDatestring | nullOptional

endDatestring | nullOptional

poolIdstring | nullOptional

Optional pool filter; hex-encoded pool id

token0string | nullOptional

Optional asset pair filter; provide both tokens to filter by a specific pair

token1string | nullOptional

typesarray | nullOptional

cursorstring | nullOptional

limitinteger | nullOptional

sortCreatedAtone ofOptional

nullOptional

or

string · enumOptionalPossible values:

bitcoinTxStatusstring | nullOptional

Responses

200

Paginated list of transactions

application/json

400

Invalid pubkey format

get

/transaction/user/{pubkey}

HTTPcURLJavaScriptPython

GET /transaction/user/{pubkey} HTTP/1.1
Host: 127.0.0.1:3000
Accept: */*

{
  "response": [
    {
      "transaction": {
        "id": "text",
        "status": {
          "type": "queued"
        },
        "rollbackStatus": {
          "message": "text",
          "type": "rolledback"
        },
        "bitcoinTxId": null,
        "bitcoinBlockHeight": null,
        "bitcoinTxStatus": null,
        "blockHeight": "text",
        "poolPubkey": "text",
        "userPubkey": "text",
        "transactionType": "open_position",
        "createdAt": "2025-12-14T05:27:33.000Z",
        "details": {
          "type": "initialize_protocol"
        },
        "writableAccounts": [
          "text"
        ]
      },
      "token0": {
        "id": "text",
        "name": "text",
        "displayName": "text",
        "symbol": null,
        "divisibility": 1,
        "supply": "text",
        "createdAt": "2025-12-14T05:27:33.000Z",
        "updatedAt": "2025-12-14T05:27:33.000Z",
        "type": "btc"
      },
      "token1": {
        "id": "text",
        "name": "text",
        "displayName": "text",
        "symbol": null,
        "divisibility": 1,
        "supply": "text",
        "createdAt": "2025-12-14T05:27:33.000Z",
        "updatedAt": "2025-12-14T05:27:33.000Z",
        "type": "btc"
      }
    }
  ],
  "nextCursor": null
}

get

Paginated list of all transactions that match the provided filter

Query parameters

startDatestring | nullOptional

endDatestring | nullOptional

poolIdstring | nullOptional

Optional pool filter; hex-encoded pool id

token0string | nullOptional

Optional asset pair filter; provide both tokens to filter by a specific pair

token1string | nullOptional

typesarray | nullOptional

cursorstring | nullOptional

limitinteger | nullOptional

sortCreatedAtone ofOptional

nullOptional

or

string · enumOptionalPossible values:

bitcoinTxStatusstring | nullOptional

Responses

200

Paginated list of transactions

application/json

get

/transaction/all

HTTPcURLJavaScriptPython

GET /transaction/all HTTP/1.1
Host: 127.0.0.1:3000
Accept: */*

200

Paginated list of transactions

{
  "response": [
    {
      "id": "text",
      "status": {
        "type": "queued"
      },
      "rollbackStatus": {
        "message": "text",
        "type": "rolledback"
      },
      "bitcoinTxId": null,
      "bitcoinBlockHeight": null,
      "bitcoinTxStatus": null,
      "blockHeight": "text",
      "poolPubkey": "text",
      "userPubkey": "text",
      "transactionType": "open_position",
      "createdAt": "2025-12-14T05:27:33.000Z",
      "details": {
        "type": "initialize_protocol"
      },
      "writableAccounts": [
        "text"
      ]
    }
  ],
  "nextCursor": null
}

get

List of swap transactions for specific collections

Query parameters

token0stringRequired

token1stringRequired

statusone ofOptional

Optional status filter; defaults to processed when not provided

nullOptional

or

string · enumOptional

Filter for high-level transaction processing status

Possible values:

rollbackStatusone ofOptional

Optional rollback status filter

nullOptional

or

string · enumOptional

Filter for rollback state

Possible values:

cursorstring | nullOptional

limitinteger | nullOptional

Responses

200

Paginated list of transactions

application/json

get

/transaction/swaps

HTTPcURLJavaScriptPython

GET /transaction/swaps?token0=text&token1=text HTTP/1.1
Host: 127.0.0.1:3000
Accept: */*

200

Paginated list of transactions

{
  "response": [
    {
      "transaction": {
        "id": "text",
        "status": {
          "type": "queued"
        },
        "rollbackStatus": {
          "message": "text",
          "type": "rolledback"
        },
        "bitcoinTxId": null,
        "bitcoinBlockHeight": null,
        "bitcoinTxStatus": null,
        "blockHeight": "text",
        "poolPubkey": "text",
        "userPubkey": "text",
        "transactionType": "open_position",
        "createdAt": "2025-12-14T05:27:33.000Z",
        "details": {
          "type": "initialize_protocol"
        },
        "writableAccounts": [
          "text"
        ]
      },
      "token0": {
        "id": "text",
        "name": "text",
        "displayName": "text",
        "symbol": null,
        "divisibility": 1,
        "supply": "text",
        "createdAt": "2025-12-14T05:27:33.000Z",
        "updatedAt": "2025-12-14T05:27:33.000Z",
        "type": "btc"
      },
      "token1": {
        "id": "text",
        "name": "text",
        "displayName": "text",
        "symbol": null,
        "divisibility": 1,
        "supply": "text",
        "createdAt": "2025-12-14T05:27:33.000Z",
        "updatedAt": "2025-12-14T05:27:33.000Z",
        "type": "btc"
      }
    }
  ],
  "nextCursor": null
}