> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amberdata.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Token Transfers - By Wallet Address
> Retrieves all token transfers involving the specified address.
If you intend to traverse all the token-transfers, it is recommended to specify the flag `direction=ascending`, which will guarantee that the pagination is stable and will not change with the arrival of new token-transfers.
## OpenAPI
````yaml get /addresses/{hash}/token-transfers
openapi: 3.1.0
info:
title: blockchain-api
version: '2'
servers:
- url: https://api.amberdata.com/blockchains
security:
- sec0: []
paths:
/addresses/{hash}/token-transfers:
get:
summary: Token Transfers - By Wallet Address
description: >-
Retrieves all token transfers involving the specified address.
If you intend to traverse all the token-transfers, it is recommended to
specify the flag `direction=ascending`, which will guarantee that the
pagination is stable and will not change with the arrival of new
token-transfers.
operationId: token-transfers-by-address-pro
parameters:
- name: hash
in: path
description: The address to retrieve the token transfers for
schema:
type: string
default: '0x06012c8cf97bead5deae237070f9587f8e7a266d'
required: true
- name: amount
in: query
description: Filter by token transfers which value is equal to this amount.
schema:
type: integer
format: int32
- name: amountGt
in: query
description: Filter by token transfers which value is greater than this amount.
schema:
type: integer
format: int32
- name: amountGte
in: query
description: >-
Filter by token transfers which value is greater than or equal to
this amount.
schema:
type: integer
format: int32
- name: amountLt
in: query
description: Filter by token transfers which value is less than this amount.
schema:
type: integer
format: int32
- name: amountLte
in: query
description: >-
Filter by token transfers which value is less than or equal to this
amount
schema:
type: integer
format: int32
- name: blockNumber
in: query
description: Filter by token transfers with this block number.
schema:
type: integer
format: int32
- name: startDate
in: query
description: Filter by token transfers which happened after this date.
schema:
type: string
format: date-time
- name: endDate
in: query
description: Filter by token transfers which happened before this date.
schema:
type: string
format: date-time
- name: transactionHash
in: query
description: Filter by token transfers for this transaction hash.
schema:
type: string
- name: direction
in: query
description: >-
The order in which to return the results (ascending or descending).
By default, records are returned in descending order, so the most
recent records are returned first.
schema:
type: string
- name: page
in: query
description: The page number to return.
schema:
type: integer
format: int32
default: 0
- name: size
in: query
description: Number of records per page.
schema:
type: integer
format: int32
default: 50
- name: validationMethod
in: query
description: >-
The validation method to be added to the response: `none`, `basic`,
`full`. Default: `none`. More
Details.
schema:
type: string
- name: includePrice
in: query
description: >-
Indicates whether or not to include price data with the results.
Options: true, false. More
Details.
schema:
type: boolean
- name: currency
in: query
description: >-
The currency of the price information. Options: usd, btc. Only used
in conjunction with includePrice. More
Details.
schema:
type: string
- name: x-amberdata-blockchain-id
in: header
description: The id of the blockchain
schema:
type: string
enum:
- ethereum-mainnet
- polygon-mainnet
default: ethereum-mainnet
- name: timeFormat
in: query
description: >-
**[Optional]** Time format of the timestamps in the return
payload.
**[Defaults]** `milliseconds | ms* | iso | iso8601 | hr
| human_readable`
schema:
type: string
responses:
'200':
description: '200'
content:
application/json:
schema:
type: object
properties:
status:
type: integer
example: 200
default: 0
title:
type: string
example: OK
description:
type: string
example: Successful request
payload:
type: object
properties:
totalRecords:
type: integer
example: 69918
default: 0
records:
type: array
items:
type: object
properties:
transactionHash:
type: string
example: >-
0x281d6478dee6d20da7e9293991cc68085532a915760f23d77ffa9923edb523de
blockHash:
type: string
example: >-
0x5b24ad74b3b6b7adb83e0ba4996726db5b91392a925bb54462c1d9833e921a4f
blockNumber:
type: string
example: '7252428'
tokenAddress:
type: string
example: '0x26fb86579e371c7aedc461b2ddef0a8628c93d3b'
amount:
type: string
example: '20000000000000000000'
timestamp:
type: integer
example: 1550825454000
default: 0
timestampNanoseconds:
type: integer
example: 0
default: 0
logIndex:
type: integer
example: 163
default: 0
blockchainId:
type: string
example: 1c9c969065fcd1cf
to:
type: array
items:
type: string
example: '0x06012c8cf97bead5deae237070f9587f8e7a266d'
from:
type: string
example: '0x41efb7f2fa8e27a5c089082e8a61f15f748f7e0b'
decimals:
type: string
example: '18'
name:
type: string
example: BORA
symbol:
type: string
example: BORA
isERC20:
type: boolean
example: true
default: true
isERC721:
type: boolean
example: false
default: true
isERC777:
type: boolean
example: false
default: true
isERC884:
type: boolean
example: false
default: true
isERC998:
type: boolean
example: false
default: true
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
security:
- ApiKeyAuth: []
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
````