Address transactions
List the transactions of an address, newest first, with a cursor. Available on DASH today.
# Address transactions
`GET https://api.rarebl.com/open/address/transactions` or `POST https://api.rarebl.com/open/address/transactions`
The transactions of an address, newest first, with a cursor to page back in time.
**Rate class:** read (5 requests per second, burst 20, per IP). **Available since:** Open API v1.
## Request
Send the parameters as query parameters (GET) or as a JSON object (POST with `Content-Type: application/json`). They are identical either way. No API key is needed: `X-API-KEY` is reserved and ignored.
Example: `curl "https://api.rarebl.com/open/address/transactions?chain=btc&address=XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT&limit=2"`
## Parameters
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `chain` | string | Yes | The chain to query. One of: btc, ltc, bch, dash, eth, tron. |
| `address` | string | Yes | The address to list. |
| `cursor` | string | No | Opaque cursor from the previous reply's `next`. |
| `limit` | integer | No | Transactions per page. 1 to 100 Default 25. |
## Responses
### API200 (HTTP 200): OK
A page of transactions for a Dash address.
```json
{
"status": 1,
"code": "API200",
"message": "success",
"data": {
"items": [
{
"hash": "8873c69e78499a49913042b743f3a96f28c520f3c0d66db47682f19dd9c43032",
"block": 2572369,
"time": "2026-11-14T22:18:18Z",
"status": "success",
"from": "Xf9atpnTdh2j8mQP2yaJkR9wWSp2vaorzE",
"to": "XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT",
"value": "50.0005",
"fee": "0",
"method": null,
"inputs": 5,
"outputs": 5
}
],
"next": null
},
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
| Field | Type | Description |
| --- | --- | --- |
| `data.items[]` | TxSummary | Transactions, newest first. |
| `data.next` | string \| null | Cursor for the next page; null on the last page. |
### API400 (HTTP 400): Bad Request
A parameter is missing or malformed. `data.param` names it (here `address`).
```json
{
"status": 0,
"code": "API400",
"message": "Invalid DASH address.",
"data": {
"param": "address"
},
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
### API409 (HTTP 409): Conflict
The history index is not built for that chain. Today only DASH has address history.
```json
{
"status": 0,
"code": "API409",
"message": "Address history needs the history index, which is not built yet for this chain.",
"data": {
"reason": "history_unavailable"
},
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
### API429 (HTTP 429): Too Many Requests
Rate limited (5 requests per second per IP, burst 20). A `Retry-After` header says how long to wait, in seconds.
```json
{
"status": 0,
"code": "API429",
"message": "Too many requests. Please retry shortly.",
"data": null,
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
### API502 (HTTP 502): Bad Gateway
The node is unavailable, still syncing or timed out. Retry later with a short back-off.
```json
{
"status": 0,
"code": "API502",
"message": "The node is unavailable or timed out. Please try again.",
"data": null,
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
## Notes
- Address history is available on DASH only today. BTC, LTC, BCH, ETH and TRON answer API409 `history_unavailable` until the history index is built.
- Check `features.addressHistory` in [Chains](https://docs.rarebl.com/api/stats/chains) before calling. Treat the `cursor` as opaque: pass `next` back unchanged.