sound_v1_ethereum

Tables

SAM_Bought_event

NFT purchase events from Sound.xyz’s SAM (Sound Automated Market) bonding curve on Ethereum, capturing edition mints with quantity, pricing, and fee distribution (artist, platform, affiliate, golden egg) across buyers and token IDs. Used for analyzing music NFT sales dynamics, creator revenue, and referral program performance.

Columns

Column	Type	Description
`block_timestamp`	`TIMESTAMP`	Timestamp when the block was produced. UTC timezone, millisecond precision.
`block_number`	`INT64`	Sequential identifier for the block in which the event or transaction was recorded. Integer value indicating the block’s position in the blockchain.
`transaction_hash`	`STRING`	Unique identifier for the transaction. 66-character hex string including 0x prefix.
`log_index`	`INT64`	Position of the event within the block’s transaction logs. Zero-indexed integer representing the sequential order of log emission.
`address`	`STRING`	Contract address that emitted the event. Hex-encoded, 0x-prefixed, 42-character string.
`removed`	`BOOL`	Boolean flag indicating whether the event log was removed from the blockchain due to a chain reorganization.
`in_edition`	`STRING`	Contract address of the music edition NFT being minted, bought, or sold. Hex-encoded, 0x-prefixed, 42-character string.
`in_buyer`	`STRING`	Address of the account purchasing tokens or assets in the transaction. Hex-encoded, 0x-prefixed, 42-character string.
`in_fromTokenId`	`STRING`	Starting token identifier of the minted NFT range. Numeric string representation indicating the first token ID in the sequence of tokens being minted or purchased.
`in_fromCurveSupply`	`STRING`	Supply count on the bonding curve before the transaction executed. Numeric string representation.
`in_quantity`	`STRING`	Number of tokens or units being purchased, minted, transferred, or involved in the transaction. Numeric string representation in smallest denomination.
`in_totalPayment`	`STRING`	Total payment amount for the NFT purchase transaction. Numeric string representation of the amount in wei.
`in_platformFee`	`STRING`	Platform fee charged for the transaction. Numeric string representation of the fee amount in wei.
`in_artistFee`	`STRING`	Fee paid to the artist for the music edition NFT sale. Numeric string representation of the amount in wei.
`in_goldenEggFee`	`STRING`	Fee allocated to the Golden Egg program for the music NFT purchase. Numeric string representation of the amount in wei.
`in_affiliateFee`	`STRING`	Fee paid to an affiliate for referring the transaction. Hex-encoded bytes value representing the affiliate address and fee amount.
`in_affiliate`	`STRING`	Address of the affiliate who referred the transaction. Hex-encoded, 0x-prefixed, 42-character string.
`in_affiliated`	`BOOL`	Boolean flag indicating whether the transaction involved an affiliate referral.
`in_attributionId`	`STRING`	Unique identifier linking the transaction to its referral or attribution source. Numeric string representation that can be zero for non-attributed transactions.

Sample Data

address	removed	in_buyer	log_index	in_edition	in_quantity	block_number	in_affiliate	in_artistFee	in_affiliated	in_fromTokenId	in_platformFee	block_timestamp	in_totalPayment	in_attributionId	transaction_hash	in_fromCurveSupply
0xb77a65e680ba99bdfb530d3cc0692cd75b088ba1	false	0xd35d60b1746caec2289c892eac7351d66d63455b	226	0xb937d618c24265b13024ec8c624b2a2f1984dbc9	1	16969076	0x0000000000000000000000000000000000000000	375013666666500	false	129	125004555555500	2023-04-03T14:26:11.000Z	5500200444444220	100034050823429212663744024974472219327326309225212339598659123908725914828493	0xb7c2903110891dbfda07a5762b20a98c36253e7f6d0fdff51c426a17c3f8e847	1
0xb77a65e680ba99bdfb530d3cc0692cd75b088ba1	false	0x317bc38b66566566529c41462ba774f489b4a63f	192	0xe6e3e88afd9634bba0e8c1f41d6001232861cf6b	1	16970119	0x0000000000000000000000000000000000000000	375085416666000	false	39	125028472222000	2023-04-03T17:58:11.000Z	5501252777776875	100034050823429212663744024974472219327326309225212339598659123908725914828493	0xed51d80102be6fa32e89b47d5ecbb0631f4ed55aa1cba39e84651c1a7124fbdc	4
0xb77a65e680ba99bdfb530d3cc0692cd75b088ba1	false	0xb19591db84ab85cc4c64015252e6584b216e0a15	472	0x33929092bc211c9961801b6a322769b30bcb6eb0	1	16966469	0x0000000000000000000000000000000000000000	375669666666000	false	442	125223222222000	2023-04-03T05:34:23.000Z	5509821777776780	100034050823429212663744024974472219327326309225212339598659123908725914828493	0x614841234c34904d9781f478d2a23c93ca59883926e9aecc5bc0d6687381cd17	13

Example Query

Query with partition filter

SELECT *
FROM `tt-contracts.sound_v1_ethereum.SAM_Bought_event`
WHERE block_timestamp >= DATE_SUB(CURRENT_DATE(), INTERVAL 7 DAY)
LIMIT 100

SAM_Created_event

SAM (Sound Automated Market) music edition creation events on Ethereum, capturing bonding curve parameters including base price, inflection points, max supply, and fee splits (artist, affiliate, golden egg) in basis points. Used for analyzing music NFT launch economics and pricing mechanisms on the Sound protocol.

Columns

Column	Type	Description
`block_timestamp`	`TIMESTAMP`	Timestamp when the block was produced. UTC timezone, millisecond precision.
`block_number`	`INT64`	Sequential identifier for the block in which the event or transaction was recorded. Integer value indicating the block’s position in the blockchain.
`transaction_hash`	`STRING`	Unique identifier for the transaction. 66-character hex string including 0x prefix.
`log_index`	`INT64`	Position of the event within the block’s transaction logs. Zero-indexed integer representing the sequential order of log emission.
`address`	`STRING`	Contract address that emitted the event. Hex-encoded, 0x-prefixed, 42-character string.
`removed`	`BOOL`	Boolean flag indicating whether the event log was removed from the blockchain due to a chain reorganization.
`in_edition`	`STRING`	Contract address of the music edition NFT being minted, bought, or sold. Hex-encoded, 0x-prefixed, 42-character string.
`in_basePrice`	`STRING`	Starting price for a Sound Automated Market (SAM) edition in wei, representing the minimum mint cost before bonding curve pricing applies. Typically set at 0.005 ETH (5000000000000000 wei) across most SAM editions.
`in_linearPriceSlope`	`STRING`	Linear slope coefficient used in SAM (Sound Automated Market) pricing curve after the inflection point is reached. Value of 0 indicates a flat pricing curve with no linear price increase per additional token minted.
`in_inflectionPrice`	`STRING`	Price in wei at which the bonding curve changes behavior after reaching the inflection point. Stored as a string representation of the wei-denominated value (e.g., ‘102500000000000000’ = 0.1025 ETH).
`in_inflectionPoint`	`STRING`	Supply quantity at which the bonding curve pricing transitions from the base price to the inflection price. Typically set to 1409 or 1500 in sample SAM (Sound Automated Market) editions.
`in_maxSupply`	`STRING`	Maximum token supply for the edition’s bonding curve. Stored as a string representation of an integer, commonly set to 4294967295 (max uint32) for unlimited supply.
`in_buyFreezeTime`	`STRING`	Period in seconds after minting during which secondary sales are restricted for the edition. Value of 4294967295 typically indicates no freeze period is enforced.
`in_artistFeeBPS`	`STRING`	Artist fee allocation in basis points (BPS) for this Sound Automated Market (SAM) edition. Typically set to 500 BPS (5% of sale price).
`in_goldenEggFeeBPS`	`STRING`	Fee allocation in basis points (BPS) for the Golden Egg mechanism in the SAM bonding curve pricing model. Typically set to 0, indicating no Golden Egg fee is collected on this edition.
`in_affiliateFeeBPS`	`STRING`	Affiliate fee in basis points (BPS) for the SAM (Sound Automated Market) edition created. One basis point equals 0.01%, so a value of 250 represents a 2.5% affiliate fee.

Sample Data

address	removed	log_index	in_edition	block_number	in_basePrice	in_maxSupply	block_timestamp	in_artistFeeBPS	in_buyFreezeTime	transaction_hash	in_affiliateFeeBPS	in_inflectionPoint	in_inflectionPrice
0xb77a65e680ba99bdfb530d3cc0692cd75b088ba1	false	173	0x7c17be92fa11211657476a7aafb61bb416d3a94f	16969162	5000000000000000	4294967295	2023-04-03T14:43:47.000Z	500	4294967295	0x50552291be1f54f9187c07522ab43c1cf76ad27228c19c1a5345371aa68bfd6d	250	1500	102500000000000000
0xb77a65e680ba99bdfb530d3cc0692cd75b088ba1	false	238	0x72862800e9d5526b5f49b56d444d3bc50663c6c3	16971141	5000000000000000	4294967295	2023-04-03T21:25:59.000Z	500	4294967295	0x1a23016aa2faaf7a292c6fdaaf3c17d3ea67eff114ab5575ef49abfcdeb475a2	250	1500	102500000000000000
0xb77a65e680ba99bdfb530d3cc0692cd75b088ba1	false	208	0xe28e9b0f17eed53fe559957db6e90ab0d2d49222	16964609	5000000000000000	4294967295	2023-04-02T23:18:23.000Z	500	4294967295	0xbc866fb2646a776047ecefd42bf3751266aeb6811f8f9b6a195a8cb69715eb6d	250	1500	102500000000000000

Example Query

Query with partition filter

SELECT *
FROM `tt-contracts.sound_v1_ethereum.SAM_Created_event`
WHERE block_timestamp >= DATE_SUB(CURRENT_DATE(), INTERVAL 7 DAY)
LIMIT 100

SAM_Sold_event

NFT sale events from Sound.xyz’s SAM (Sound Automated Market) bonding curve contract on Ethereum, tracking secondary market sells with payout amounts, token IDs, and curve supply positions. Used for analyzing creator earnings and bonding curve price discovery for music NFT editions.

Columns

Column	Type	Description
`block_timestamp`	`TIMESTAMP`	Timestamp when the block was produced. UTC timezone, millisecond precision.
`block_number`	`INT64`	Sequential identifier for the block in which the event or transaction was recorded. Integer value indicating the block’s position in the blockchain.
`transaction_hash`	`STRING`	Unique identifier for the transaction. 66-character hex string including 0x prefix.
`log_index`	`INT64`	Position of the event within the block’s transaction logs. Zero-indexed integer representing the sequential order of log emission.
`address`	`STRING`	Contract address that emitted the event. Hex-encoded, 0x-prefixed, 42-character string.
`removed`	`BOOL`	Boolean flag indicating whether the event log was removed from the blockchain due to a chain reorganization.
`in_edition`	`STRING`	Contract address of the music edition NFT being minted, bought, or sold. Hex-encoded, 0x-prefixed, 42-character string.
`in_seller`	`STRING`	Address of the account selling tokens or assets in the transaction. Hex-encoded, 0x-prefixed, 42-character string.
`in_fromCurveSupply`	`STRING`	Supply count on the bonding curve before the transaction executed. Numeric string representation.
`in_tokenIds`	`ARRAY<STRING>`	Array of NFT token identifiers sold in the transaction. Numeric string elements representing sequential token IDs from the edition.
`in_totalPayout`	`STRING`	Total amount paid to the seller from the NFT sale transaction. Numeric string representation in wei (smallest denomination of the native token).
`in_attributionId`	`STRING`	Unique identifier linking the transaction to its referral or attribution source. Numeric string representation that can be zero for non-attributed transactions.

Sample Data

address	removed	in_seller	log_index	in_edition	in_tokenIds	block_number	in_totalPayout	block_timestamp	in_attributionId	transaction_hash	in_fromCurveSupply
0xb77a65e680ba99bdfb530d3cc0692cd75b088ba1	false	0xa19ebb6a024a7d86a3a595cc7d2c7934dc2837d1	400	0x3d90650c6173a1b0675ac9c69b4a4f373e2ddf60	[“184”,“185”,“186”]	16973508	15158077777775850	2023-04-04T05:33:59.000Z	100034050823429212663744024974472219327326309225212339598659123908725914828493	0x6c47c2074be09e50b8d681a9b335182518be2ea2b0e75f1c959af5b6ba907262	35
0xb77a65e680ba99bdfb530d3cc0692cd75b088ba1	false	0xa19ebb6a024a7d86a3a595cc7d2c7934dc2837d1	210	0xdc310b26500a255f7c4fa7d8347c37f0b20f2538	[“77”,“78”]	16973640	10001138888888875	2023-04-04T06:01:11.000Z	100034050823429212663744024974472219327326309225212339598659123908725914828493	0xedd3ab535b5d3080e2d90f937be20fd4330c326dec59378306f74e618f4e7f7f	4
0xb77a65e680ba99bdfb530d3cc0692cd75b088ba1	false	0xe4ad52868492c281c206520569d90ce977223ab1	230	0x33929092bc211c9961801b6a322769b30bcb6eb0	[“9”,“10”,“11”,“12”,“13”]	16978151	25082683333332325	2023-04-04T21:25:11.000Z	100034050823429212663744024974472219327326309225212339598659123908725914828493	0x0ad5cc6186016a3ac766196376fce08a5c538dc45c5f8674d3f7080d47283ff6	21

Example Query

Query with partition filter

SELECT *
FROM `tt-contracts.sound_v1_ethereum.SAM_Sold_event`
WHERE block_timestamp >= DATE_SUB(CURRENT_DATE(), INTERVAL 7 DAY)
LIMIT 100

Metrics

Primitives

Contracts

Blockchain

Tables

SAM_Bought_event

SAM_Created_event

SAM_Sold_event

Metrics

Primitives

Contracts

Blockchain

​Tables

​SAM_Bought_event

​SAM_Created_event

​SAM_Sold_event

Tables

SAM_Bought_event

SAM_Created_event

SAM_Sold_event