Skip to main content

Scalar Types

These fundamental types represent atomic values in the OneSource Web3 API.

TypeDescriptionFormatExample
IDA unique identifier (always serialized as a string).Hexadecimal or UUID"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
StringUTF-8 text.Freeform text"Bored Ape #123"
String!Non-nullable string.Enforced server-side"ERC-721" (never null)
BooleanTrue/false value.true/falseisERC721: true
IntSigned 32-bit integer.Base-10createdBlock: 12345678
UInt64!Unsigned 64-bit integer (for large counts).String-encoded*"10003748766674344597655376"
TimeTimestamp (ISO-8601).YYYY-MM-DDTHH:MM:SSZ"2023-01-01T00:00:00Z"

Key Notes:

  • UInt64!: Always returned as a string to avoid JavaScript number precision loss.
  • Time: Derived from blockchain timestamps.
  • ID: For contracts, this is the Ethereum address; for tokens, it’s tokenID.