# History

The transaction history displays all deposits and withdrawals from the user wallet. When building applications, try to keep the data as shallow as possible to reduce the data fetched. We added filter parameters to reduce the number of entries per page or pick a specific coin types that are referenced by their respective tokenID. 

```javascript
var parameters = {
    nextPageToken: 'optional',
    serviceId: 'optional',
    walletID: 'optional',
    type: 'optional',
}

const response = await relysia.wallet.v1.history(parameters);
```

{% hint style="info" %}
We currently integrate token transactions into the /history endpoint.
{% endhint %}

## Get your transaction history.

<mark style="color:blue;">`GET`</mark> `https://api.relysia.com/v1/history`

The transaction history endpoint returns all past transactions, both BSV and Tokens.

#### Query Parameters

| Name          | Type   | Description |
| ------------- | ------ | ----------- |
| nextPageToken | string |             |

#### Headers

| Name     | Type   | Description |
| -------- | ------ | ----------- |
| walletID | string |             |
| type     | string |             |
| version  | string |             |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
  "statusCode": 200,
  "data": {
    "status": "success",
    "msg": "Operation completed successfully",
    "histories": [
      {
        "version": "1.0.0",
        "to": "bulk transaction",
        "txId": "29f6d4ee36ffbb70226f342a89097e040df4cdbc91e15bb698d0bf27fa228956",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-09-15 05:25:49",
        "balance_change": -2,
        "docId": "29f6d4ee36ffbb70226f342a89097e040df4cdbc91e15bb698d0bf27fa228956",
        "notes": null,
        "type": "debit",
        "protocol": "STAS"
      },
      {
        "version": "1.0.0",
        "to": "1K1xqUS6nt2niaAcM7K5WuNWyqBaD8JQkN",
        "txId": "baf52af692ed06a2b9fa0e3c256b4e0d3259f6b651dce8c065d5b9d67e91e70c",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-09-15 05:14:38",
        "balance_change": -1,
        "docId": "baf52af692ed06a2b9fa0e3c256b4e0d3259f6b651dce8c065d5b9d67e91e70c",
        "notes": null,
        "type": "debit",
        "protocol": "STAS"
      },
      {
        "version": "1.0.0",
        "to": "payto:3577@relysia.com?amount=120",
        "txId": "d181897e8952e20b38256ba4893a2f2d7ae42ee627d74adcce49c9c6a4b0dd81",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-09-15 04:59:36",
        "balance_change": 0.0000012,
        "docId": "d181897e8952e20b38256ba4893a2f2d7ae42ee627d74adcce49c9c6a4b0dd81",
        "notes": "Send to 3577@relysia.com",
        "type": null,
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "bulk transaction",
        "txId": "0397640d62d8dece842ec6209345de94d4ca9997f83aa31c7467c6060c3f39aa",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-09-15 04:45:39",
        "balance_change": -200,
        "docId": "0397640d62d8dece842ec6209345de94d4ca9997f83aa31c7467c6060c3f39aa",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "1K1xqUS6nt2niaAcM7K5WuNWyqBaD8JQkN",
        "txId": "82f2852d3b0c327f3d67b3a8f96f90b69b312a36bad102b62b69622c8e26fc19",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-09-15 04:39:51",
        "balance_change": -100,
        "docId": "82f2852d3b0c327f3d67b3a8f96f90b69b312a36bad102b62b69622c8e26fc19",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "1Abju7foXMqhBK8CbHVuRXLqTtmxFgTdRh",
        "txId": "b2d88f2b119e276f6c22e62b58ef33f8c572cc1a87c7fd8c0b52ad5c3c713690",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-09-07 16:49:17",
        "balance_change": -100,
        "docId": "b2d88f2b119e276f6c22e62b58ef33f8c572cc1a87c7fd8c0b52ad5c3c713690",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "1L1ik3bjuJFgye8g4f2PYDtB3AAjjif2fK",
        "txId": "4408297291c835d6618105f313e3ebd130f86e3b363469fadc6d19768bde0570",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-08-11 04:38:06",
        "balance_change": -50000,
        "docId": "4408297291c835d6618105f313e3ebd130f86e3b363469fadc6d19768bde0570",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "1FJ4Lt7B5ekcucefgT44VaiZffffZAAUUp",
        "txId": "c0c5761191674cf78d26b227e8faf51e52e1b0888adebec1863847d370f6311e",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-08-01 16:05:26",
        "balance_change": -50000,
        "docId": "c0c5761191674cf78d26b227e8faf51e52e1b0888adebec1863847d370f6311e",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "17n2JVhrCf1oYSMkZtZNjcf1deteUEKQsH",
        "txId": "ddef95711560df8373a06d455d716cf2ce21322511b2ec9112a9bb387577859e",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-07-28 16:16:18",
        "balance_change": -500,
        "docId": "ddef95711560df8373a06d455d716cf2ce21322511b2ec9112a9bb387577859e",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "17n2JVhrCf1oYSMkZtZNjcf1deteUEKQsH",
        "txId": "1dad4406281f7f5c899ab833a08a16958f194f102ca53ecbdf0f629824af8cba",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-07-28 16:11:46",
        "balance_change": -500,
        "docId": "1dad4406281f7f5c899ab833a08a16958f194f102ca53ecbdf0f629824af8cba",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      }
    ],
    "nextPageTokenId": "2022-07-28T16:11:46.021Z"
  }
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.relysia.com/wallets/history.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.