Get Address Transactions

1 import { FathomXClient } from "fathomx"; 2 3 const client = new FathomXClient({ token: "YOUR_TOKEN" }); 4 await client.addresses.transactions("BTC", "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh", { 5 limit: "10", 6 offset: "0" 7 });

1 { 2 "currency": "BTC", 3 "currencyName": "Bitcoin", 4 "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh", 5 "total": 2, 6 "limit": 2, 7 "offset": 0, 8 "transactions": [ 9 { 10 "txid": "e4b2db653fbdee60839834a89a336edd29c0fe20de2d7b39b64ccb2285608933", 11 "date": "2025-08-03T07:23:23.000Z", 12 "asset": "BTC", 13 "from": [ 14 { 15 "address": "3N2wg53Hg2grX6An6ws2yAJptF6zsM5Mbw", 16 "amount": "0.00012679" 17 } 18 ], 19 "to": [ 20 { 21 "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh", 22 "amount": "0.00050875" 23 } 24 ] 25 } 26 ] 27 }

Transaction history for a cryptocurrency address

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

currencystringRequired

Currency ticker (BTC, LTC, DOGE, ZEC, RUNE, ETH, BASE, BCH)

addressstringRequired

Cryptocurrency address to fetch transactions for

Query parameters

assetstringOptional

Token asset (contract address) to filter transactions by (e.g. the contract address of USDC, USDT, etc.)

limitstringOptionalDefaults to 10

Number of transactions to return per page (1-100)

offsetstringOptionalDefaults to 0

Number of transactions to skip

networkstringOptionalDefaults to mainnet

Network to query (for future use, currently only mainnet is supported)

Response

This endpoint returns an object.

currencystring

currencyNamestring

addressstring

totaldouble

limitdouble

offsetdouble

transactionslist of objects

Authentication

Path parameters

Query parameters

Response

Errors