Get Transfers

Endpoint

GET /api/transfer/v1

Parameters

Name	In	Type	Required	Description
network	query	string		Finney is the current network. Nakamoto and kusanagi are historical versions.
address	query	string		SS58 or hex format
from	query	string		SS58 or hex format
to	query	string		SS58 or hex format
transaction_hash	query	string		hash of the transaction
extrinsic_id	query	string		The extrinsic ID
amount_min	query	string		min transaction amount in rao
amount_max	query	string		max transaction amount in rao
block_number	query	integer		exact block number
block_start	query	integer		block number for start of range
block_end	query	integer		block number for end of range
timestamp_start	query	integer		Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)
timestamp_end	query	integer		Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)
page	query	integer		The page number of the response.
limit	query	integer		The number of responses. max is 200.
order	query	string

Responses

200 — 200

Media: application/json

{
  "type": "object",
  "properties": {
    "pagination": {
      "type": "object",
      "properties": {
        "current_page": {
          "type": "integer",
          "example": 1,
          "default": 0
        },
        "per_page": {
          "type": "integer",
          "example": 50,
          "default": 0
        },
        "total_items": {
          "type": "integer",
          "example": 3126936,
          "default": 0
        },
        "total_pages": {
          "type": "integer",
          "example": 62539,
          "default": 0
        },
        "next_page": {
          "type": "integer",
          "example": 2,
          "default": 0
        },
        "prev_page": {}
      }
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "finney-5011620-0017"
          },
          "to": {
            "type": "object",
            "properties": {
              "ss58": {
                "type": "string",
                "example": "5FqBL928choLPmeFz5UVAvonBD5k7K2mZSXVC9RkFzLxoy2s"
              },
              "hex": {
                "type": "string",
                "example": "0xa69ffb8d15b780999fc0ae940aabf71073498ab19a1561a4c4b473ebbe8a336a"
              }
            }
          },
          "from": {
            "type": "object",
            "properties": {
              "ss58": {
                "type": "string",
                "example": "5HmArgNJrnzR1QuMJGNXEE1bTixsEAtucnhoN6inzRfB1cmS"
              },
              "hex": {
                "type": "string",
                "example": "0xfc09dfc989a44fcdea0fb82622ed69fffe1bc53478e7e1264838a7b85c84345f"
              }
            }
          },
          "network": {
            "type": "string",
            "example": "finney"
          },
          "block_number": {
            "type": "integer",
            "example": 5011620,
            "default": 0
          },
          "timestamp": {
            "type": "string",
            "example": "2025-02-26T13:57:36Z"
          },
          "amount": {
            "type": "string",
            "example": "57855024736"
          },
          "fee": {
            "type": "string",
            "example": "135264"
          },
          "transaction_hash": {
            "type": "string",
            "example": "0xbe46e30347cac35f0de27ad47c1a3892de2e32b741da73db754d6047b2a6e4e9"
          },
          "extrinsic_id": {
            "type": "string",
            "example": "5011620-0008"
          }
        }
      }
    }
  }
}

400 — 400

Media: application/json

{
  "type": "object",
  "properties": {}
}

Authentication

All Taostats API requests require an Authorization header containing your API key. See Getting Started.