Ft Schemas

FtBalance

Data Type

Name	Type	Description
timestamp	number	The timestamp of balance changed.
blockNumber	number	The block number in which the transfer was emitted.
address	string	The owner's address.
contract	string	The ERC20 address.
balance	string	The owner's balance.
weight	number	The owner's balance after scaled (number type for easy sorting).

Example

{
  "timestamp": 1646708400,
  "blockNumber": 32849988,
  "address": "0x38aca5484b8603373acc6961ecd57a6a594510a3",
  "contract": "0x321162cd933e2be498cd2267a90534a804051b11",
  "balance": "644320344044",
  "weight": 6443.2
}

FtBalanceHold

Data Type

Name	Type	Description
timestamp	number	The timestamp.
contract	string	The ERC20 address.
all	number	The number of users that have held the tokens.
active	number	The amount of users who sents or receives tokens in (timestamp - 1day, timestamp].
held	string	The amount of tokens which are held by all users.

Example

{
  "timestamp": 1619308800,
  "contract": "0x841fad6eae12c286d1fd18d1d525dffa75c7effe",
  "all": 4309,
  "active": 4309,
  "held": "2736957827141471661095001"
}

FtBalanceInsight

Data Type

Name	Type	Description
timestamp	number	The timestamp.
contract	string	The ERC20 address.
allHolders	number	The number of users that have held the tokens.
activeHolders	number	The number of users holding the token in the most recent period(e.g. in 7 days).
seniority	array<number>	The amount of new users in [[0, 7), [7, 30), [30, 60), [60, 90), [90, infinite)] days ago.
gini	number	The gini coefficient, see https://en.wikipedia.org/wiki/Gini_coefficient.

Example

{
  "timestamp": 1646708400,
  "contract": "0x321162cd933e2be498cd2267a90534a804051b11",
  "allHolders": 26699,
  "activeHolders": 105,
  "seniority": [712, 3358, 5546, 1806, 15277],
  "gini": 0.9991524827089143
}

FtBalanceLine

Data Type

Name	Type	Description
timestamp	number	The timestamp at which the balance is changed.
blockNumber	number	The block number in which the transfer was emitted.
contract	string	The contract address.
address	string	The owner address.
balance	string	The owner's balance.
weight	number	The owner's balance after scaled (number type for easy sorting).
sent	string	Total amount transferred out.
received	string	Total amount transferred in.
transactionHash	Array<string>	The transaction hash array in this block where the balance has changed.
created	string	The created timestamp.

Example

{
  "timestamp": 1646708400,
  "blockNumber": 32849988,
  "contract": "0x321162cd933e2be498cd2267a90534a804051b11",
  "address": "0x38aca5484b8603373acc6961ecd57a6a594510a3",
  "balance": "644320000000",
  "weight": 6443.2,
  "sent": "356299049",
  "received": "0",
  "transactionHash": [
    "0xd04e465a8843cd793e5374984bb70e1c05ca41bed2333c4c39f8dbaa62fe53b2"
  ],
  "created": 1646708400
}

FtTransfer

Data Type

Name	Type	Description
timestamp	number	The timestamp at which the event is emitted.
blockNumber	number	The block number in which the transfer was emitted.
transactionHash	string	The hash of the transaction which generates this transfer.
logIndex	number	The log index in the transaction.
address	string	The contract address which emits this transfer.
from	string	The token's current owner.
to	string	The token's new owner.
value	string	The amount of token to transfer from sender to recipient.

Example

{
  "timestamp": 1646716073,
  "blockNumber": 32849988,
  "transactionHash": "0xd0fc950da56b2e942728813c78f1c01ae119b98b242c6b3961eeb47c754fd73a",
  "logIndex": 3426,
  "address": "0x321162cd933e2be498cd2267a90534a804051b11",
  "from": "0x9b0191fe8b32b5a8344a7c6cec07b6259b9a091e",
  "to": "0x04c25d06ed3984aae14ca705d3caf97fb7238799",
  "value": "1371447530000000"
}

FtTransferStat

Data Type

Name	Type	Description
contract	string	The ERC20 address.
timestamp	number	The timestamp.
count	number	The transfer's count in (timestamp - 1hour, timestamp].
volume	string	The transfer's volume in (timestamp - 1hour, timestamp].

Example

{
  "contract": "0x321162cd933e2be498cd2267a90534a804051b11",
  "timestamp": 1646708400,
  "count": 251,
  "volume": "7992665487"
}