Finding a Wallet’s First Transaction Reliably
Define what first wallet activity means, distinguish discovery from coverage, and avoid treating a partial API response as a wallet creation date.
Overview
When translating these concepts into an integration, keep the scope described by the wallet history api with the result. The examples in wallet transaction history and smart contract event logs show how the same distinction affects neighbouring data questions.
The earliest returned transaction is not necessarily the wallet’s first activity. The answer depends on which event types, assets, networks and historical ranges were searched.
Define first for a specific question
First outgoing native transaction, first token receipt and first contract interaction can all produce different dates. An externally owned address can receive funds before it sends a transaction. A contract account has creation evidence but can also receive assets through other paths. Do not label one API’s earliest row as a universal wallet creation timestamp.
Worked example: an older token receipt
A scan finds the first outgoing transaction in June. A separate token-event scan finds an incoming transfer in March. June is a valid answer to first outgoing transaction, but an invalid answer to first known activity across both evidence types. Preserve the query definition with each derived date.
Report the discovery boundary
Record the earliest scanned block, completed pages, included movement classes and excluded networks. Test a wallet with only incoming transfers and a history that starts before available data. If the scan is partial, call the result earliest observed activity within the checked range. Broader language requires broader evidence, not merely a lower timestamp.
A practical acceptance test
Provide an early token receipt, a later first outgoing transaction and a scan beginning between them. Assert that the result names its chosen activity class and covered range. A partial scan must not publish a universal creation date. When broader evidence becomes available, retain the previous query definition alongside the revised earliest-observed result.
Questions about the topic
Frequently asked questions
Does a wallet have a universal creation timestamp?
Not generally for an externally owned address. A derived activity date is query-dependent.
Can an empty result prove no past activity?
Only within a completed, explicitly defined evidence scope.
Standards & technical documentation
