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 · nullableOptional

endDatestring · nullableOptional

poolIdstring · nullableOptional

Optional pool filter; hex-encoded pool id

token0string · nullableOptional

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

token1string · nullableOptional

cursorstring · nullableOptional

limitinteger · nullableOptional

sortCreatedAtstring · enum · nullableOptionalPossible values:

bitcoinTxStatusstring · nullableOptional

Responses

200

List of transactions

application/json

nextCursorstring · nullableOptional

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": "2026-08-08T04:24:43.885Z",
      "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 · nullableOptional

endDatestring · nullableOptional

poolIdstring · nullableOptional

Optional pool filter; hex-encoded pool id

token0string · nullableOptional

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

token1string · nullableOptional

cursorstring · nullableOptional

limitinteger · nullableOptional

sortCreatedAtstring · enum · nullableOptionalPossible values:

bitcoinTxStatusstring · nullableOptional

Responses

200

Paginated list of transactions

application/json

nextCursorstring · nullableOptional

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": "2026-08-08T04:24:43.885Z",
        "details": {
          "type": "initialize_protocol"
        },
        "writableAccounts": [
          "text"
        ]
      },
      "token0": {
        "id": "text",
        "name": "text",
        "displayName": "text",
        "symbol": null,
        "divisibility": 1,
        "supply": "text",
        "createdAt": "2026-08-08T04:24:43.885Z",
        "updatedAt": "2026-08-08T04:24:43.885Z",
        "type": "btc"
      },
      "token1": {
        "id": "text",
        "name": "text",
        "displayName": "text",
        "symbol": null,
        "divisibility": 1,
        "supply": "text",
        "createdAt": "2026-08-08T04:24:43.885Z",
        "updatedAt": "2026-08-08T04:24:43.885Z",
        "type": "btc"
      }
    }
  ],
  "nextCursor": null
}

get

Paginated list of all transactions that match the provided filter

Query parameters

startDatestring · nullableOptional

endDatestring · nullableOptional

poolIdstring · nullableOptional

Optional pool filter; hex-encoded pool id

token0string · nullableOptional

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

token1string · nullableOptional

cursorstring · nullableOptional

limitinteger · nullableOptional

sortCreatedAtstring · enum · nullableOptionalPossible values:

bitcoinTxStatusstring · nullableOptional

Responses

200

Paginated list of transactions

application/json

nextCursorstring · nullableOptional

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": "2026-08-08T04:24:43.885Z",
      "details": {
        "type": "initialize_protocol"
      },
      "writableAccounts": [
        "text"
      ]
    }
  ],
  "nextCursor": null
}

get

List of swap transactions for specific collections

Query parameters

token0stringRequired

token1stringRequired

statusstring · enum · nullableOptional

Optional status filter; defaults to processed when not provided

Possible values:

rollbackStatusstring · enum · nullableOptional

Optional rollback status filter

Possible values:

cursorstring · nullableOptional

limitinteger · nullableOptional

Responses

200

Paginated list of transactions

application/json

nextCursorstring · nullableOptional

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": "2026-08-08T04:24:43.885Z",
        "details": {
          "type": "initialize_protocol"
        },
        "writableAccounts": [
          "text"
        ]
      },
      "token0": {
        "id": "text",
        "name": "text",
        "displayName": "text",
        "symbol": null,
        "divisibility": 1,
        "supply": "text",
        "createdAt": "2026-08-08T04:24:43.885Z",
        "updatedAt": "2026-08-08T04:24:43.885Z",
        "type": "btc"
      },
      "token1": {
        "id": "text",
        "name": "text",
        "displayName": "text",
        "symbol": null,
        "divisibility": 1,
        "supply": "text",
        "createdAt": "2026-08-08T04:24:43.885Z",
        "updatedAt": "2026-08-08T04:24:43.885Z",
        "type": "btc"
      }
    }
  ],
  "nextCursor": null
}