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
string · enumOptionalPossible values:
bitcoinTxStatusstring | nullOptional
Responses
200
List of transactions
application/json
400
Invalid pubkey format
get
/transaction/pool/{pool_id}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-11-07T04:45:28.075Z",
"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
string · enumOptionalPossible values:
bitcoinTxStatusstring | nullOptional
Responses
200
Paginated list of transactions
application/json
400
Invalid pubkey format
get
/transaction/user/{pubkey}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-11-07T04:45:28.075Z",
"details": {
"type": "initialize_protocol"
},
"writableAccounts": [
"text"
]
},
"token0": {
"id": "text",
"name": "text",
"displayName": "text",
"symbol": null,
"divisibility": 1,
"supply": "text",
"createdAt": "2025-11-07T04:45:28.075Z",
"updatedAt": "2025-11-07T04:45:28.075Z",
"type": "btc"
},
"token1": {
"id": "text",
"name": "text",
"displayName": "text",
"symbol": null,
"divisibility": 1,
"supply": "text",
"createdAt": "2025-11-07T04:45:28.075Z",
"updatedAt": "2025-11-07T04:45:28.075Z",
"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
string · enumOptionalPossible values:
bitcoinTxStatusstring | nullOptional
Responses
200
Paginated list of transactions
application/json
get
/transaction/allGET /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-11-07T04:45:28.075Z",
"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
string · enumOptionalPossible values:
Filter for high-level transaction processing status
rollbackStatusone ofOptional
Optional rollback status filter
nullOptional
string · enumOptionalPossible values:
Filter for rollback state
cursorstring | nullOptional
limitinteger | nullOptional
Responses
200
Paginated list of transactions
application/json
get
/transaction/swapsGET /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-11-07T04:45:28.075Z",
"details": {
"type": "initialize_protocol"
},
"writableAccounts": [
"text"
]
},
"token0": {
"id": "text",
"name": "text",
"displayName": "text",
"symbol": null,
"divisibility": 1,
"supply": "text",
"createdAt": "2025-11-07T04:45:28.075Z",
"updatedAt": "2025-11-07T04:45:28.075Z",
"type": "btc"
},
"token1": {
"id": "text",
"name": "text",
"displayName": "text",
"symbol": null,
"divisibility": 1,
"supply": "text",
"createdAt": "2025-11-07T04:45:28.075Z",
"updatedAt": "2025-11-07T04:45:28.075Z",
"type": "btc"
}
}
],
"nextCursor": null
}Last updated