Skip to main content
GET
/
wallets
/
{walletId}
/
history
Get Wallet History
curl --request GET \
  --url https://api.dfns.io/wallets/{walletId}/history \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "kind": "Erc20Transfer",
      "walletId": "wa-1f04s-lqc9q-xxxxxxxxxxxxxxxx",
      "network": "Ethereum",
      "direction": "Out",
      "blockNumber": 19036906,
      "timestamp": "2024-01-18T23:03:59.000Z",
      "txHash": "0x8e88793607610a83798eb5ec6dde861f3e459c7e4a22e78b0d2e675b86d0d1e7",
      "index": "134",
      "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "from": "0xea09cf8a006493566f8a8fd3d0b32ebff5939d6a",
      "to": "0xc42754e6f79f15082613b2b4ebead83dcf8116b6",
      "value": "1000000",
      "decimals": 6,
      "fee": "1542993669053672",
      "metadata": {
        "asset": {
          "symbol": "USDC",
          "decimals": 6,
          "verified": true
        },
        "fee": {
          "symbol": "ETH",
          "decimals": 18,
          "verified": true
        }
      }
    }
  ],
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "network": "Algorand",
  "nextPageToken": "<string>"
}

​
Authentication

✅ Organization User (CustomerEmployee)
✅ Delegated User (EndUser)
✅ Service Account

​
Required Permissions

Wallets:Read: Always required.

Authorizations

​
Authorization
string
header
required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

Path Parameters

​
walletId
string
required

Wallet you want to get the history from.

Required string length: 1 - 64

Query Parameters

​
limit
integer
default:50

Maximum number of items to return.

Required range: 1 <= x <= 500
​
paginationToken
string

Opaque token used to retrieve the next page. Returned as nextPageToken from the previous request.

Minimum string length: 1
​
direction
enum<string>

Transfer direction.

Available options:
In,
Out
​
kind
enum<string>

Blockchain event kind.

Available options:
NativeTransfer,
Aip21Transfer,
AsaTransfer,
AssetTransfer,
Cip56Transfer,
CoinTransfer,
Erc20Transfer,
Erc721Transfer,
Hip17Transfer,
HtsTransfer,
LockedCoinTransfer,
Snip2Transfer,
Snip3Transfer,
Tep74Transfer,
Trc10Transfer,
Trc20Transfer,
Trc721Transfer,
Sep41Transfer,
SplTransfer,
Spl2022Transfer,
UtxoTransfer
​
contract
string
Minimum string length: 1

Response

200 - application/json

Success

​
items
(Native Transfer · object | Aptos Fungible Asset (AIP-21) Transfer · object | Algorand Standard Asset Transfer · object | Cardano Asset Transfer · object | Canton Standard Token (CIP-56) Transfer · object | Sui Coin Transfer · object | EVM Fungible Token (ERC-20) Transfer · object | EVM Non Fungible Token (ERC-721) Transfer · object | HIP17 Transfer · object | HTS Transfer · object | Locked Coin Transfer · object | Stellar Classic Assets (SEP-41) Transfer · object | Snip2 Transfer · object | Snip3 Transfer · object | Solana Program Library Token (SPL and SPL 2022) Transfer · object | TON Jetton (TEP-74) Transfer · object | TRON Native Fungible Token (TRC-10) Transfer · object | TRON Smart Contract Fungible Token (TRC-20) Transfer · object | TRON Non Fungible Token (TRC-721) Transfer · object | UTXO Transfer · object)[]
required

Current page items.

Example:
{
  "kind": "Erc20Transfer",
  "walletId": "wa-1f04s-lqc9q-xxxxxxxxxxxxxxxx",
  "network": "Ethereum",
  "direction": "Out",
  "blockNumber": 19036906,
  "timestamp": "2024-01-18T23:03:59.000Z",
  "txHash": "0x8e88793607610a83798eb5ec6dde861f3e459c7e4a22e78b0d2e675b86d0d1e7",
  "index": "134",
  "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  "from": "0xea09cf8a006493566f8a8fd3d0b32ebff5939d6a",
  "to": "0xc42754e6f79f15082613b2b4ebead83dcf8116b6",
  "value": "1000000",
  "decimals": 6,
  "fee": "1542993669053672",
  "metadata": {
    "asset": {
      "symbol": "USDC",
      "decimals": 6,
      "verified": true
    },
    "fee": {
      "symbol": "ETH",
      "decimals": 18,
      "verified": true
    }
  }
}
​
walletId
string
required

Wallet id.

Required string length: 1 - 64
Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

​
network
enum<string>
required
Available options:
Algorand,
AlgorandTestnet,
Aptos,
AptosTestnet,
ArbitrumOne,
ArbitrumSepolia,
ArcTestnet,
AvalancheC,
AvalancheCFuji,
BabylonGenesis,
BabylonTestnet5,
Base,
BaseSepolia,
Berachain,
BerachainBepolia,
Bitcoin,
BitcoinSignet,
BitcoinTestnet3,
BitcoinCash,
Bob,
BobSepolia,
Bsc,
BscTestnet,
Canton,
CantonTestnet,
Cardano,
CardanoPreprod,
Celo,
CeloAlfajores,
Codex,
CodexSepolia,
CosmosHub4,
CosmosIcsTestnet,
Dogecoin,
Ethereum,
EthereumClassic,
EthereumClassicMordor,
EthereumGoerli,
EthereumSepolia,
EthereumHolesky,
EthereumHoodi,
FantomOpera,
FantomTestnet,
FlareC,
FlareCCoston2,
FlowEvm,
FlowEvmTestnet,
Hedera,
HederaTestnet,
Ink,
InkSepolia,
InternetComputer,
Ion,
IonTestnet,
Iota,
IotaTestnet,
Kaspa,
Kusama,
KusamaAssetHub,
Litecoin,
Near,
NearTestnet,
Optimism,
OptimismSepolia,
Origyn,
Plasma,
PlasmaTestnet,
Plume,
PlumeSepolia,
Paseo,
PaseoAssetHub,
Polkadot,
PolkadotAssetHub,
Polygon,
PolygonAmoy,
Polymesh,
PolymeshTestnet,
Race,
RaceSepolia,
SeiAtlantic2,
SeiPacific1,
Solana,
SolanaDevnet,
Starknet,
StarknetSepolia,
Stellar,
StellarTestnet,
Sui,
SuiTestnet,
Tezos,
TezosGhostnet,
TempoAndantino,
Tsc,
TscTestnet1,
Ton,
TonTestnet,
Tron,
TronNile,
Westend,
WestendAssetHub,
XrpLedger,
XrpLedgerTestnet
​
nextPageToken
string

token to use as paginationToken to request the next page.