Contracts

Get contract token transfers

Retrieve token transfers for a contract.

Time-window rules (checked in this order):

If the contract has no transfer activity at all, an empty response is returned with range.startTimestamp and range.endTimestamp set to null.
timestampFrom must be ≤ timestampTo, otherwise a 400 error is returned.
Every user-provided timestamp must fall within the contract’s activity range (range.startTimestamp … range.endTimestamp). If any provided timestamp is outside, an empty items array is returned together with the range object — use it to discover the valid window.
When both are provided, the span must not exceed 90 days, otherwise a 400 error is returned.

Defaults when only one timestamp is provided:

Only timestampFrom (must be inside the activity range) → timestampTo defaults to min(lastTransfer, timestampFrom + 90 days).
Only timestampTo (must be inside the activity range) → timestampFrom defaults to max(firstTransfer, timestampTo − 90 days).
Neither provided → the latest 90 days of activity.

Every response includes a range object with the contract’s first and latest transfer timestamps. Use range to page through the full history.

GET

contracts

{contractAddress}

transfers

Get contract token transfers

curl --request GET \
  --url https://public-api.voyager.online/beta/contracts/{contractAddress}/transfers \
  --header 'x-api-key: <api-key>'

import requests

url = "https://public-api.voyager.online/beta/contracts/{contractAddress}/transfers"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://public-api.voyager.online/beta/contracts/{contractAddress}/transfers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.voyager.online/beta/contracts/{contractAddress}/transfers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.voyager.online/beta/contracts/{contractAddress}/transfers"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://public-api.voyager.online/beta/contracts/{contractAddress}/transfers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "blockNumber": 1643556,
      "tokenAddress": "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
      "timestamp": 1753642806,
      "transferFrom": "0x01bed88e5027795facabb1a8fe8fa882f56a734412697232d9e7c86e18589b18",
      "transferTo": "0x01176a1bd84444c89232ec27754698e5d2e7e1a7f1539f12027f28b23ec9f3d8",
      "txHash": "0x36ff4c434ffed203e9c9c7d3acd25690861d8b1928028f0791e0942bd95d5b9",
      "callName": "transfer",
      "blockHash": "0x26e33072da06ad179ce6379c9673cc9384ec7255dca84f8edd21e12768c78c6",
      "fromAlias": null,
      "toAlias": "StarkWare: Sequencer",
      "invocationType": "fee_transfer",
      "tokenName": "Starknet Token",
      "tokenSymbol": "STRK",
      "tokenDecimals": 18,
      "tokenIcon": "https://coin-images.coingecko.com/coins/images/26433/small/starknet.png?1696525507"
    }
  ],
  "hasMore": true,
  "range": {
    "startTimestamp": 1630454400,
    "endTimestamp": 1753642806
  }
}

{
  "error": "<string>"
}

{
  "message": "Forbidden"
}

{
  "message": "Limit Exceeded"
}

Authorizations

x-api-key

string

header

required

API key for authentication. Get your key at https://voyager.online/plans

Path Parameters

contractAddress

string

required

Starknet contract address (0x-prefixed hex).

Pattern: ^(0x[0-9a-fA-F]{1,66})$

Query Parameters

integer

default:25

Number of items per page. Available options: 10, 25, 50, 100.

type

enum<string>

default:erc20

Token standard to filter by: "erc20", "erc721", or "erc1155". Defaults to "erc20".

Available options:

erc20,

erc721,

erc1155

from

string | null

Filter by sender address (0x-prefixed hex).

string | null

Filter by recipient address (0x-prefixed hex).

symbol

string | null

Filter by token symbol (e.g. ETH, STRK).

tokenAddress

string | null

Token contract address (0x-prefixed hex).

Pattern: ^(0x[0-9a-fA-F]{1,66})$

timestampFrom

number | null

Unix timestamp (seconds) for the start of the query window (inclusive). Must be within the contract's transfer activity range, available in the response range object. If omitted, it is derived automatically from timestampTo (up to 90 days back or the contract's first transfer). The window between timestampFrom and timestampTo must not exceed 90 days.

timestampTo

number | null

Unix timestamp (seconds) for the end of the query window (inclusive). Must be within the contract's transfer activity range, available in the response range object. If omitted, it is derived automatically from timestampFrom (up to 90 days forward or the contract's last transfer). The window between timestampFrom and timestampTo must not exceed 90 days.

invocationType

string | null

default:ALL

Transaction execution phase: VALIDATE, EXECUTE, FEE_TRANSFER, ALL_EXCEPT_FEE_TRANSFER (ERC-20 only: hide fee-phase transfers), or ALL (no filter). Defaults to ALL.

string

Cursor for keyset pagination. Pass the id from the last item of the previous response to fetch the next page.

order_by

enum<string>

default:desc

Sort direction: ascending or descending. Defaults to descending.

Available options:

asc,

desc

Response

A paginated list of token transfers within the resolved time window, along with the contract's full activity range.

items

object[]

required

Token transfer records for the requested window.

Option 1
Option 2
Option 3

Show child attributes

hasMore

boolean

required

True when additional pages are available. Pass the last item's id to fetch the next page.

range

object

required

The contract's full transfer activity range. Use these values to construct follow-up queries.

Show child attributes

Get contract token transfers

curl --request GET \
  --url https://public-api.voyager.online/beta/contracts/{contractAddress}/transfers \
  --header 'x-api-key: <api-key>'

import requests

url = "https://public-api.voyager.online/beta/contracts/{contractAddress}/transfers"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://public-api.voyager.online/beta/contracts/{contractAddress}/transfers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.voyager.online/beta/contracts/{contractAddress}/transfers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.voyager.online/beta/contracts/{contractAddress}/transfers"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://public-api.voyager.online/beta/contracts/{contractAddress}/transfers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "blockNumber": 1643556,
      "tokenAddress": "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
      "timestamp": 1753642806,
      "transferFrom": "0x01bed88e5027795facabb1a8fe8fa882f56a734412697232d9e7c86e18589b18",
      "transferTo": "0x01176a1bd84444c89232ec27754698e5d2e7e1a7f1539f12027f28b23ec9f3d8",
      "txHash": "0x36ff4c434ffed203e9c9c7d3acd25690861d8b1928028f0791e0942bd95d5b9",
      "callName": "transfer",
      "blockHash": "0x26e33072da06ad179ce6379c9673cc9384ec7255dca84f8edd21e12768c78c6",
      "fromAlias": null,
      "toAlias": "StarkWare: Sequencer",
      "invocationType": "fee_transfer",
      "tokenName": "Starknet Token",
      "tokenSymbol": "STRK",
      "tokenDecimals": 18,
      "tokenIcon": "https://coin-images.coingecko.com/coins/images/26433/small/starknet.png?1696525507"
    }
  ],
  "hasMore": true,
  "range": {
    "startTimestamp": 1630454400,
    "endTimestamp": 1753642806
  }
}

{
  "error": "<string>"
}

{
  "message": "Forbidden"
}

{
  "message": "Limit Exceeded"
}

Transactions

Token Transfers

Tokens

Contracts

Classes

NFTs

Blocks

Staking

Events

Messages

Daily Statistics

Statistics

Activities

Class Verification

Status

Get contract token transfers

Authorizations

Path Parameters

Query Parameters

Response