{ "openapi": "3.1.0", "info": { "title": "Goldrush Wallet API", "description": "Quicknode Goldrush Wallet API reference", "version": "1.0.0" }, "paths": { "/v1/address/{walletAddress}/activity": { "get": { "operationId": "get_v1_address_by_walletAddress_activity", "summary": "Locate chains which an address is active on with a single API call", "tags": [ "address" ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-address-walletAddress-activity" }, "parameters": [ { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, "required": true, "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, { "name": "testnets", "in": "query", "schema": { "type": "boolean", "description": "When set to true, the API includes data from testnet networks in the response. If omitted or set to false, only data from mainnet networks will be included" }, "description": "When set to true, the API includes data from testnet networks in the response. If omitted or set to false, only data from mainnet networks will be included" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "A timestamp indicating when the data was last updated" }, "address": { "type": "string", "description": "The wallet address queried" }, "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The short name of the chain" }, "chain_id": { "type": "string", "description": "The unique identifier for the chain" }, "is_testnet": { "type": "boolean", "description": "Indicates whether the chain is a testnet" }, "db_schema_name": { "type": "string", "description": "The database schema name corresponding to the chain" }, "label": { "type": "string", "description": "The display name of the chain" }, "category_label": { "type": "string", "description": "The category or ecosystem the chain belongs to" }, "priority_label": { "type": "string", "description": "The priority level of the chain" }, "logo_url": { "type": "string", "description": "URL pointing to the chain's default logo" }, "black_logo_url": { "type": "string", "description": "URL pointing to the chain's black-themed logo" }, "white_logo_url": { "type": "string", "description": "URL pointing to the chain's white-themed logo" }, "color_theme": { "type": "object", "properties": { "red": { "type": "integer", "description": "The red component of the color" }, "green": { "type": "integer", "description": "The green component of the color" }, "blue": { "type": "integer", "description": "The blue component of the color" }, "alpha": { "type": "integer", "description": "The alpha (opacity) value" }, "hex": { "type": "string", "description": "The hexadecimal representation of the color" }, "css_rgb": { "type": "string", "description": "The CSS rgb() representation of the color" } }, "description": "The color_theme object which contains the following fields:" }, "is_appchain": { "type": "boolean", "description": "Indicates whether the chain is an app-specific chain" }, "appchain_of": { "type": "string", "description": "Specifies which chain the appchain belongs to, or null if not an appchain" }, "last_seen_at": { "type": "string", "description": "A timestamp indicating the last time the chain's data was updated or accessed" } } }, "description": "An array of items representing activity on different chains" } }, "description": "The data object which contains the following fields:" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred, or null otherwise" }, "error_code": { "type": "string", "description": "The error code if an error occurred, or null otherwise" } } } } } } } } }, "/v1/allchains/address/{walletAddress}/balances": { "get": { "operationId": "get_v1_allchains_address_by_walletAddress_balances", "summary": "Fetch paginated spot & historical native and token balances for a single address on up to 10 EVM chains with one API cal", "tags": [ "allchains" ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-allchains-address-walletAddress-balances" }, "description": "Fetch paginated spot & historical native and token balances for a single address on up to 10 EVM chains with one API call", "parameters": [ { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The wallet address to fetch token balances for" }, "required": true, "description": "The wallet address to fetch token balances for" }, { "name": "chains", "in": "query", "schema": { "type": "string", "description": "A comma-separated list of chain names or IDs to retrieve token balances from. Defaults to all foundational chains" }, "description": "A comma-separated list of chain names or IDs to retrieve token balances from. Defaults to all foundational chains" }, { "name": "limit", "in": "query", "schema": { "type": "integer", "description": "The maximum number of token balances to return per page, up to 100" }, "description": "The maximum number of token balances to return per page, up to 100" }, { "name": "before", "in": "query", "schema": { "type": "string", "description": "Pagination cursor pointing to fetch token balances before a certain point in time" }, "description": "Pagination cursor pointing to fetch token balances before a certain point in time" }, { "name": "cutoff-timestamp", "in": "query", "schema": { "type": "integer", "description": "The timestamp to filter balances updated before this time" }, "description": "The timestamp to filter balances updated before this time" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency in which to return token quotes" }, "description": "The currency in which to return token quotes" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "cursor_before": { "type": "string", "description": "Cursor pointing to the position before the current page of data" }, "quote_currency": { "type": "string", "description": "The currency used for quoting values" }, "items": { "type": "array", "items": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimals used by the token contract" }, "contract_name": { "type": "string", "description": "The name of the token contract" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the token contract" }, "contract_address": { "type": "string", "description": "The address of the token contract" }, "supports_erc": { "type": "array", "items": {}, "description": "A list of supported ERC standards" }, "contract_display_name": { "type": "string", "description": "The display name of the token contract" }, "logo_urls": { "type": "object", "properties": { "token_logo_url": { "type": "string", "description": "The URL of the token's logo" }, "protocol_logo_url": { "type": "string", "description": "The URL of the protocol's logo, if available" }, "chain_logo_url": { "type": "string", "description": "The URL of the chain's logo" } }, "description": "URLs of logos associated with the token" }, "last_transferred_at": { "type": "string", "description": "The timestamp of the last transfer involving the token" }, "type": { "type": "string", "description": "The type of asset (e.g., cryptocurrency or dust)" }, "is_spam": { "type": "boolean", "description": "Indicates whether the asset is flagged as spam" }, "balance": { "type": "string", "description": "The current balance of the token" }, "balance_24h": { "type": "string", "description": "The balance of the token 24 hours ago" }, "quote_rate": { "type": "number", "description": "The quoted rate of the token in the specified currency" }, "quote_rate_24h": { "type": "number", "description": "The quoted rate of the token 24 hours ago in the specified currency" }, "quote": { "type": "number", "description": "The current value of the token in the specified currency" }, "pretty_quote": { "type": "string", "description": "A formatted string of the current token value" }, "quote_24h": { "type": "number", "description": "The token value 24 hours ago in the specified currency" }, "pretty_quote_24h": { "type": "string", "description": "A formatted string of the token value 24 hours ago" }, "chain_id": { "type": "string", "description": "The ID of the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "chain_display_name": { "type": "string", "description": "The display name of the blockchain network" }, "is_native_token": { "type": "boolean", "description": "Indicates if the token is the native token of the blockchain" } } }, "description": "A list of asset items" } }, "description": "The main container for the asset data" }, "error": { "type": "boolean", "description": "Indicates if an error occurred during the request" }, "error_message": { "type": "string", "description": "The error message, if applicable" }, "error_code": { "type": "integer", "description": "The error code, if applicable" } } } } } } } } }, "/v1/allchains/transactions": { "get": { "operationId": "get_v1_allchains_transactions", "summary": "Fetch transactions for up to 10 addresses and 10 EVM chains with one API call.", "tags": [ "allchains" ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-allchains-transactions" }, "description": "Fetch transactions for up to 10 addresses and 10 EVM chains with one API call. Useful for building Activity Feeds", "parameters": [ { "name": "chains", "in": "query", "schema": { "type": "string", "description": "The chains for which data is being queried" }, "description": "The chains for which data is being queried" }, { "name": "addresses", "in": "query", "schema": { "type": "string", "description": "The wallet addresses for which data is being queried" }, "description": "The wallet addresses for which data is being queried" }, { "name": "limit", "in": "query", "schema": { "type": "integer", "description": "The maximum number of results to return" }, "description": "The maximum number of results to return" }, { "name": "before", "in": "query", "schema": { "type": "string", "description": "The timestamp or block height to fetch transactions before this point" }, "description": "The timestamp or block height to fetch transactions before this point" }, { "name": "after", "in": "query", "schema": { "type": "string", "description": "The timestamp or block height to fetch transactions after this point" }, "description": "The timestamp or block height to fetch transactions after this point" }, { "name": "with-logs", "in": "query", "schema": { "type": "boolean", "description": "When set to true, includes event logs for the transactions in the response" }, "description": "When set to true, includes event logs for the transactions in the response" }, { "name": "with-decoded-logs", "in": "query", "schema": { "type": "boolean", "description": "When set to true, includes decoded event logs for the transactions in the response" }, "description": "When set to true, includes decoded event logs for the transactions in the response" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The preferred quote currency for token prices in the response" }, "description": "The preferred quote currency for token prices in the response" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "cursor_before": { "type": "string", "description": "The cursor value to be used for fetching the previous page of data" }, "cursor_after": { "type": "string", "description": "The cursor value to be used for fetching the next page of data" }, "quote_currency": { "type": "string", "description": "The currency used to quote token prices in the response" }, "items": { "type": "array", "items": { "type": "object", "properties": { "block_height": { "type": "integer", "description": "The height of the block containing the transaction" }, "block_signed_at": { "type": "string", "description": "The timestamp when the block containing the transaction was signed" }, "block_hash": { "type": "string", "description": "The unique hash of the block containing the transaction" }, "tx_hash": { "type": "string", "description": "The unique hash of the transaction" }, "tx_offset": { "type": "integer", "description": "The offset of the transaction within the block" }, "miner_address": { "type": "string", "description": "The address of the miner who mined the block" }, "from_address": { "type": "string", "description": "The address from which the transaction originated" }, "from_address_label": { "type": "string", "description": "The label for the address from which the transaction originated" }, "to_address": { "type": "string", "description": "The address to which the transaction is sent" }, "to_address_label": { "type": "string", "description": "The label for the address to which the transaction is sent" }, "value": { "type": "string", "description": "The value of the transaction in its native units" }, "value_quote": { "type": "integer", "description": "The value of the transaction quoted in the specified currency" }, "pretty_value_quote": { "type": "string", "description": "The formatted quoted value of the transaction" }, "gas_offered": { "type": "integer", "description": "The amount of gas offered for the transaction" }, "gas_spent": { "type": "integer", "description": "The amount of gas actually spent for the transaction" }, "gas_price": { "type": "integer", "description": "The gas price specified in the transaction" }, "gas_quote": { "type": "integer", "description": "The gas cost of the transaction quoted in the specified currency" }, "pretty_gas_quote": { "type": "string", "description": "The formatted quoted gas cost of the transaction" }, "gas_quote_rate": { "type": "integer", "description": "The rate used to calculate the gas quote" }, "fees_paid": { "type": "string", "description": "The total fees paid for the transaction" }, "gas_metadata": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimals used in the contract" }, "contract_name": { "type": "string", "description": "The name of the contract" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol for the contract" }, "contract_address": { "type": "string", "description": "The address of the contract" }, "supports_erc": { "type": "string", "description": "The list of ERC standards supported by the contract" }, "logo_url": { "type": "string", "description": "The URL of the contract's logo" } }, "description": "The metadata related to gas, including contract details" }, "successful": { "type": "boolean", "description": "The status of the transaction indicating success or failure" }, "chain_id": { "type": "string", "description": "The unique identifier of the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "explorers": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "The name of the blockchain explorer" }, "url": { "type": "string", "description": "The URL of the blockchain explorer" } } }, "description": "The list of blockchain explorers for this network" }, "log_events": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block containing the event was signed" }, "block_height": { "type": "integer", "description": "The height of the block containing the event" }, "tx_offset": { "type": "integer", "description": "The offset of the transaction within the block" }, "log_offset": { "type": "integer", "description": "The offset of the log within the transaction" }, "tx_hash": { "type": "string", "description": "The unique hash of the transaction containing the event" }, "raw_log_topics": { "type": "string", "description": "The topics of the raw log event" }, "sender_contract_decimals": { "type": "integer", "description": "The decimals used by the sender's contract" }, "sender_name": { "type": "string", "description": "The name of the sender contract" }, "sender_contract_ticker_symbol": { "type": "string", "description": "The ticker symbol for the sender's contract" }, "sender_address": { "type": "string", "description": "The address of the sender contract" }, "sender_address_label": { "type": "string", "description": "The label for the sender's address" }, "sender_logo_url": { "type": "string", "description": "The URL of the sender's contract logo" }, "supports_erc": { "type": "string", "description": "The list of ERC standards supported by the sender's contract" }, "sender_factory_address": { "type": "string", "description": "The factory address of the sender contract" }, "raw_log_data": { "type": "string", "description": "The raw data of the log event" }, "decoded": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the decoded event" }, "signature": { "type": "string", "description": "The signature of the decoded event" }, "params": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the parameter" }, "type": { "type": "string", "description": "The type of the parameter" }, "indexed": { "type": "boolean", "description": "Whether the parameter is indexed" }, "decoded": { "type": "boolean", "description": "Whether the parameter value is decoded" }, "value": { "type": "string", "description": "The value of the parameter" } } }, "description": "The parameters of the decoded event" } }, "description": "The decoded log event, including its parameters" } } }, "description": "The list of log events associated with the transaction" } } }, "description": "The array of transaction items" } }, "description": "The response data containing following fields:" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred, or null otherwise" }, "error_code": { "type": "string", "description": "The error code if an error occurred, or null otherwise" } } } } } } } } }, "/v1/btc-mainnet/address/{walletAddress}/balances_v2": { "get": { "operationId": "get_v1_btc_mainnet_address_by_walletAddress_balances_v2", "summary": "Fetch Bitcoin balance for a non-HD address.", "tags": [ "btc-mainnet" ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-btc-mainnet-address-walletAddress-balances_v2" }, "description": "Fetch Bitcoin balance for a non-HD address. Response includes spot prices and other metadata", "parameters": [ { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The wallet address for which the balances are to be retrieved" }, "required": true, "description": "The wallet address for which the balances are to be retrieved" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency to quote the balance values in (e.g., USD, EUR)" }, "description": "The currency to quote the balance values in (e.g., USD, EUR)" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "address": { "type": "string", "description": "The queried Bitcoin address" }, "updated_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "next_update_at": { "type": "string", "description": "The timestamp for the next scheduled update" }, "quote_currency": { "type": "string", "description": "The currency in which the values are quoted" }, "chain_id": { "type": "integer", "description": "The unique ID of the blockchain" }, "chain_name": { "type": "string", "description": "The name of the blockchain" }, "items": { "type": "array", "items": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimal places used by the token" }, "contract_name": { "type": "string", "description": "The name of the token contract" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the token contract" }, "contract_address": { "type": "string", "description": "The address of the token contract" }, "supports_erc": { "type": "array", "items": {}, "description": "An array listing the supported ERC standards, if applicable" }, "logo_url": { "type": "string", "description": "The URL to the token's logo" }, "contract_display_name": { "type": "string", "description": "The display name of the token contract" }, "logo_urls": { "type": "object", "properties": { "token_logo_url": { "type": "string", "description": "The URL of the token's logo" }, "protocol_logo_url": { "type": "string", "description": "The URL of the protocol's logo, if available" }, "chain_logo_url": { "type": "string", "description": "The URL of the chain's logo" } }, "description": "An object of URLs to different logo variations of the token" }, "last_transferred_at": { "type": "string", "description": "The timestamp when the token was last transferred" }, "native_token": { "type": "boolean", "description": "Indicates if the token is the native currency of the blockchain" }, "type": { "type": "string", "description": "The type of the token or transaction" }, "is_spam": { "type": "boolean", "description": "Indicates if the token is considered spam" }, "balance": { "type": "string", "description": "The balance of the token" }, "balance_24h": { "type": "string", "description": "The balance of the token 24 hours ago" }, "quote_rate": { "type": "number", "description": "The current quoted rate for the token in the given currency" }, "quote_rate_24h": { "type": "number", "description": "The quoted rate for the token in the given currency 24 hours ago" }, "quote": { "type": "number", "description": "The total quote value of the balance in the given currency" }, "pretty_quote": { "type": "string", "description": "The human-readable format of the quote value" }, "quote_24h": { "type": "number", "description": "The total quote value 24 hours ago in the given currency" }, "pretty_quote_24h": { "type": "string", "description": "The human-readable format of the quote value 24 hours ago" }, "protocol_metadata": { "type": "string", "description": "Any additional metadata related to the protocol" }, "nft_data": { "type": "string", "description": "NFT data associated with the token, if applicable" } } }, "description": "An array of objects containing information about the tokens or transactions associated with the address" }, "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "The flag indicating if there are more pages of data" }, "page_number": { "type": "integer", "description": "The current page number" }, "page_size": { "type": "integer", "description": "The number of items per page" }, "total_count": { "type": "integer", "description": "The total number of items (nullable)" } }, "description": "The pagination details for the response" } }, "description": "The main object containing details about the queried Bitcoin transactions" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message, if any" }, "error_code": { "type": "string", "description": "The error code, if any" } } } } } } } } }, "/v1/{chainName}/address/{walletAddress}/balances_native": { "get": { "operationId": "get_v1_by_chainName_address_by_walletAddress_balances_native", "summary": "Commonly used to get the native token balance for an address.", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-address-walletAddress-balances_native" }, "description": "Commonly used to get the native token balance for an address. This endpoint is required because native tokens are usually not ERC20 tokens and sometimes you want something lightweight", "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name eg: base-mainnet" }, "required": true, "description": "The chain name eg: base-mainnet" }, { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, "required": true, "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, { "name": "block-height", "in": "query", "schema": { "type": "integer", "description": "Ending block to define a block range. Omitting this parameter defaults to the latest block height" }, "description": "Ending block to define a block range. Omitting this parameter defaults to the latest block height" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "address": { "type": "string", "description": "The blockchain address for which token data is retrieved" }, "updated_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "quote_currency": { "type": "string", "description": "The currency used for quoting values" }, "chain_id": { "type": "integer", "description": "The ID of the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "items": { "type": "array", "items": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimals used by the token contract" }, "contract_name": { "type": "string", "description": "The name of the token contract" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the token contract" }, "contract_address": { "type": "string", "description": "The address of the token contract" }, "supports_erc": { "type": "array", "items": {}, "description": "A list of supported ERC standards for the token" }, "logo_url": { "type": "string", "description": "The URL of the token's logo" }, "block_height": { "type": "integer", "description": "The height of the block where the token balance was retrieved" }, "balance": { "type": "string", "description": "The token balance associated with the address" }, "quote_rate": { "type": "integer", "description": "The quoted rate of the token in the specified currency" }, "quote": { "type": "integer", "description": "The quoted value of the token balance in the specified currency" }, "pretty_quote": { "type": "string", "description": "A formatted string of the quoted value of the token balance" } } }, "description": "An array of token balance items" } }, "description": "The response data containing following fields:" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred, or null otherwise" }, "error_code": { "type": "string", "description": "The error code if an error occurred, or null otherwise" } } } } } } } } }, "/v1/{chainName}/address/{walletAddress}/balances_v2": { "get": { "operationId": "get_v1_by_chainName_address_by_walletAddress_balances_v2", "summary": "Fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address.", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-address-walletAddress-balances_v2" }, "description": "Fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address. Response includes spot prices and other metadata", "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name eg: base-mainnet" }, "required": true, "description": "The chain name eg: base-mainnet" }, { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, "required": true, "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency in which token values should be quoted" }, "description": "The currency in which token values should be quoted" }, { "name": "nft", "in": "query", "schema": { "type": "boolean", "description": "Whether to include NFTs in the response" }, "description": "Whether to include NFTs in the response" }, { "name": "no-nft-fetch", "in": "query", "schema": { "type": "boolean", "description": "Whether to exclude fetching NFT-related data" }, "description": "Whether to exclude fetching NFT-related data" }, { "name": "no-spam", "in": "query", "schema": { "type": "boolean", "description": "Whether to exclude spam tokens from the response" }, "description": "Whether to exclude spam tokens from the response" }, { "name": "no-nft-asset-metadata", "in": "query", "schema": { "type": "boolean", "description": "Whether to exclude NFT asset metadata from the response" }, "description": "Whether to exclude NFT asset metadata from the response" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "address": { "type": "string", "description": "The wallet address for which the data is returned" }, "chain_id": { "type": "integer", "description": "The unique identifier of the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "quote_currency": { "type": "string", "description": "The currency used to quote the token values" }, "updated_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "items": { "type": "array", "items": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimals used in the token's contract" }, "contract_name": { "type": "string", "description": "The name of the token's contract" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the token" }, "contract_address": { "type": "string", "description": "The contract address of the token" }, "contract_display_name": { "type": "string", "description": "The display name of the token" }, "supports_erc": { "type": "string", "description": "A list of ERC standards supported by the token" }, "logo_url": { "type": "string", "description": "The URL of the token's logo" }, "logo_urls": { "type": "object", "properties": { "token_logo_url": { "type": "string", "description": "The URL of the token's logo" }, "protocol_logo_url": { "type": "string", "description": "The URL of the protocol's logo" }, "chain_logo_url": { "type": "string", "description": "The URL of the chain's logo" } }, "description": "The object containing different logo URLs for the token" }, "last_transferred_at": { "type": "string", "description": "The timestamp when the token was last transferred" }, "native_token": { "type": "boolean", "description": "Whether the token is the native token of the blockchain" }, "type": { "type": "string", "description": "The type of the token, such as fungible or non-fungible" }, "is_spam": { "type": "boolean", "description": "Whether the token is flagged as spam" }, "balance": { "type": "string", "description": "The current balance of the token" }, "balance24h": { "type": "string", "description": "The balance of the token 24 hours ago" }, "quote_rate": { "type": "integer", "description": "The current price of the token in the quote currency" }, "quote_rate24h": { "type": "integer", "description": "The price of the token in the quote currency 24 hours ago" }, "quote": { "type": "integer", "description": "The current value of the token in the quote currency" }, "quote24h": { "type": "integer", "description": "The value of the token in the quote currency 24 hours ago" }, "pretty_quote": { "type": "string", "description": "The formatted current value of the token" }, "pretty_quote24h": { "type": "string", "description": "The formatted value of the token 24 hours ago" }, "protocol_metadata": { "type": "object", "properties": { "protocol_name": { "type": "string", "description": "The name of the protocol" } }, "description": "The metadata related to the protocol associated with the token" }, "nft_data": { "type": "array", "items": { "type": "object", "properties": { "token_id": { "type": "string", "description": "The unique identifier of the NFT" }, "token_balance": { "type": "string", "description": "The balance of the NFT token" }, "token_url": { "type": "string", "description": "The URL of the NFT's metadata" }, "supports_erc": { "type": "string", "description": "A list of ERC standards supported by the NFT" }, "token_price_wei": { "type": "string", "description": "The price of the NFT in wei" }, "token_quote_rate_eth": { "type": "string", "description": "The price of the NFT quoted in Ether" }, "original_owner": { "type": "string", "description": "The address of the NFT's original owner" }, "external_data": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the NFT" }, "desc": { "type": "string", "description": "The description of the NFT" }, "image": { "type": "string", "description": "The URL of the NFT's image" }, "image256": { "type": "string", "description": "The URL of the NFT's 256px image" }, "image512": { "type": "string", "description": "The URL of the NFT's 512px image" }, "image1024": { "type": "string", "description": "The URL of the NFT's 1024px image" }, "animation_url": { "type": "string", "description": "The URL of the NFT's animation" }, "external_url": { "type": "string", "description": "The external URL of the NFT" }, "attributes": { "type": "array", "items": { "type": "object", "properties": { "trait_type": { "type": "string", "description": "The type of the NFT trait" }, "value": { "type": "string", "description": "The value of the NFT trait" } } }, "description": "An array of attributes describing the NFT" }, "thumbnails": { "type": "object", "properties": { "image256": { "type": "string", "description": "The URL of the 256px thumbnail" }, "image512": { "type": "string", "description": "The URL of the 512px thumbnail" }, "image1024": { "type": "string", "description": "The URL of the 1024px thumbnail" }, "image_opengraph_url": { "type": "string", "description": "The OpenGraph URL of the NFT's image" }, "thumbhash": { "type": "string", "description": "The thumbhash of the NFT's image" } }, "description": "The object containing various thumbnail images of the NFT" }, "image_preview": { "type": "string", "description": "The URL of the preview image of the NFT" }, "asset_properties": { "type": "object", "properties": { "asset_width": { "type": "integer", "description": "The width of the NFT's asset" }, "asset_height": { "type": "integer", "description": "The height of the NFT's asset" }, "dominant_color": { "type": "string", "description": "The dominant color of the NFT's asset" } }, "description": "The metadata of the NFT's asset, including dimensions and dominant color" }, "owner": { "type": "string", "description": "The address of the current owner of the NFT" } }, "description": "The metadata associated with the NFT, such as its attributes and image URLs" }, "owner": { "type": "string", "description": "The address of the current owner of the NFT" }, "owner_address": { "type": "string", "description": "The wallet address of the NFT's current owner" }, "burned": { "type": "boolean", "description": "Whether the NFT has been burned" } } }, "description": "An array of data related to NFTs" } } }, "description": "An array of token balances or assets associated with the address" }, "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "The flag indicating if there are more pages of data" }, "page_number": { "type": "integer", "description": "The current page number" }, "page_size": { "type": "integer", "description": "The number of items per page" }, "total_count": { "type": "integer", "description": "The total number of items (nullable)" } }, "description": "The pagination details for the response" } }, "description": "The response data containing following fields:" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred, or null otherwise" }, "error_code": { "type": "string", "description": "The error code if an error occurred, or null otherwise" } } } } } } } } }, "/v1/{chainName}/address/{walletAddress}/portfolio_v2": { "get": { "operationId": "get_v1_by_chainName_address_by_walletAddress_portfolio_v2", "summary": "Commonly used to render a daily portfolio balance for an address broken down by the token.", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-address-walletAddress-portfolio_v2" }, "description": "Commonly used to render a daily portfolio balance for an address broken down by the token. The timeframe is user-configurable, defaults to 30 days", "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name eg: base-mainnet" }, "required": true, "description": "The chain name eg: base-mainnet" }, { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, "required": true, "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, { "name": "days", "in": "query", "schema": { "type": "integer", "description": "The number of days to return data for. Defaults to 30 days" }, "description": "The number of days to return data for. Defaults to 30 days" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "address": { "type": "string", "description": "The blockchain address for which data is retrieved" }, "updated_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "quote_currency": { "type": "string", "description": "The currency used for quote values" }, "chain_id": { "type": "integer", "description": "The ID of the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "items": { "type": "array", "items": { "type": "object", "properties": { "contract_address": { "type": "string", "description": "The address of the token contract" }, "contract_decimals": { "type": "integer", "description": "The number of decimals used by the token contract" }, "contract_name": { "type": "string", "description": "The name of the token contract" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the token contract" }, "logo_url": { "type": "string", "description": "The URL of the token's logo" }, "holdings": { "type": "array", "items": { "type": "object", "properties": { "quote_rate": { "type": "integer", "description": "The current quote rate for the token in the specified currency" }, "timestamp": { "type": "string", "description": "The timestamp of the holding record" }, "close": { "type": "object", "properties": { "balance": { "type": "string", "description": "The closing balance of the token" }, "quote": { "type": "integer", "description": "The quote value of the token at close" }, "pretty_quote": { "type": "string", "description": "A formatted string of the quote value at close" } }, "description": "The closing balance and quote value for the token" }, "high": { "type": "object", "description": "The highest balance and quote value during the period (empty for this dataset)" }, "low": { "type": "object", "description": "The lowest balance and quote value during the period (empty for this dataset)" }, "open": { "type": "object", "description": "The opening balance and quote value during the period (empty for this dataset)" } } }, "description": "An array of historical holdings data" } } }, "description": "An array of token balances and their historical holdings" }, "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "Indicates if more pages are available" }, "page_number": { "type": "integer", "description": "The current page number" }, "page_size": { "type": "integer", "description": "The number of items per page" }, "total_count": { "type": "integer", "description": "The total number of items available" } }, "description": "Pagination metadata for navigating through the data" } }, "description": "The response data containing following fields:" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred, or null otherwise" }, "error_code": { "type": "string", "description": "The error code if an error occurred, or null otherwise" } } } } } } } } }, "/v1/{chainName}/address/{walletAddress}/resolve_address": { "get": { "operationId": "get_v1_by_chainName_address_by_walletAddress_resolve_address", "summary": "Resolve ENS, RNS and Unstoppable Domains addresses", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-address-walletAddress-resolve_address" }, "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The blockchain name for which the address is being resolved (e.g., base-mainnet, bsc)" }, "required": true, "description": "The blockchain name for which the address is being resolved (e.g., base-mainnet, bsc)" }, { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The requested wallet address. Can be an ENS, RNS, Lens Handle, or an Unstoppable Domain, which will be resolved automatically" }, "required": true, "description": "The requested wallet address. Can be an ENS, RNS, Lens Handle, or an Unstoppable Domain, which will be resolved automatically" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp of the last update in ISO 8601 format" }, "chain_id": { "type": "integer", "description": "The unique identifier for the blockchain (e.g., 1 for Ethereum)" }, "chain_name": { "type": "string", "description": "The name of the blockchain (e.g., base-mainnet)" }, "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The ENS, RNS, Lens Handle, or Unstoppable Domain associated with the address" }, "address": { "type": "string", "description": "The resolved wallet address in hexadecimal format" } } }, "description": "An array containing the resolved address details" }, "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "The flag indicating if there are more pages of data" }, "page_number": { "type": "integer", "description": "The current page number" }, "page_size": { "type": "integer", "description": "The number of items per page" }, "total_count": { "type": "integer", "description": "The total number of items (nullable)" } }, "description": "The pagination details for the response" } }, "description": "The main response object containing the resolved address details and metadata" }, "error": { "type": "boolean", "description": "Indicates whether there was an error in the response" }, "error_message": { "type": "string", "description": "The error message, if any" }, "error_code": { "type": "integer", "description": "The error code, if any" } } } } } } } } }, "/v1/{chainName}/address/{walletAddress}/transactions_summary": { "get": { "operationId": "get_v1_by_chainName_address_by_walletAddress_transactions_summary", "summary": "Commonly used to fetch the earliest and latest transactions, and the transaction count for a wallet.", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-address-walletAddress-transactions_summary" }, "description": "Commonly used to fetch the earliest and latest transactions, and the transaction count for a wallet. Calculate the age of the wallet and the time it has been idle and quickly gain insights into their engagement with web3", "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name eg: base-mainnet" }, "required": true, "description": "The chain name eg: base-mainnet" }, { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, "required": true, "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, { "name": "with-gas", "in": "query", "schema": { "type": "boolean", "description": "Include gas summary details. Additional charge of 1 credit when true. Response times may be impacted for wallets with millions of transactions" }, "description": "Include gas summary details. Additional charge of 1 credit when true. Response times may be impacted for wallets with millions of transactions" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "address": { "type": "string", "description": "The wallet address associated with the transactions" }, "chain_id": { "type": "integer", "description": "The ID of the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "items": { "type": "array", "items": { "type": "object", "properties": { "total_count": { "type": "integer", "description": "The total number of transactions for the address" }, "earliest_transaction": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block containing the transaction was signed" }, "tx_hash": { "type": "string", "description": "The hash of the earliest transaction" }, "tx_detail_link": { "type": "string", "description": "A link to the details of the earliest transaction" } }, "description": "Details of the earliest transaction" }, "latest_transaction": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block containing the transaction was signed" }, "tx_hash": { "type": "string", "description": "The hash of the latest transaction" }, "tx_detail_link": { "type": "string", "description": "A link to the details of the latest transaction" } }, "description": "Details of the latest transaction (currently empty)" }, "gas_summary": { "type": "object", "properties": { "total_sent_count": { "type": "integer", "description": "The total number of transactions sent" }, "total_fees_paid": { "type": "string", "description": "The total gas fees paid across all transactions" }, "total_gas_quote": { "type": "integer", "description": "The total gas fees in the quoted currency" }, "pretty_total_gas_quote": { "type": "string", "description": "The total gas fees in quoted currency formatted as a readable string" }, "average_gas_quote_per_tx": { "type": "integer", "description": "The average gas fees in quoted currency per transaction" }, "pretty_average_gas_quote_per_tx": { "type": "string", "description": "The average gas fees per transaction formatted as a readable string" }, "gas_metadata": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimals used in the gas contract" }, "contract_name": { "type": "string", "description": "The name of the gas contract" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the gas contract" }, "contract_address": { "type": "string", "description": "The address of the gas contract" }, "supports_erc": { "type": "array", "items": {}, "description": "A list of ERC standards supported by the contract" }, "logo_url": { "type": "string", "description": "The URL of the contract's logo" } }, "description": "Metadata for the gas fees" } }, "description": "A summary of gas fees for transactions" } } }, "description": "An array of transaction summary items" } }, "description": "The response data containing following fields:" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred, or null otherwise" }, "error_code": { "type": "string", "description": "The error code if an error occurred, or null otherwise" } } } } } } } } }, "/v1/{chainName}/address/{walletAddress}/transactions_v3": { "get": { "operationId": "get_v1_by_chainName_address_by_walletAddress_transactions_v3", "summary": "Commonly used to fetch and render the most recent transactions involving an address.", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-address-walletAddress-transactions_v3" }, "description": "Commonly used to fetch and render the most recent transactions involving an address. Frequently seen in wallet applications", "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name eg: base-mainnet" }, "required": true, "description": "The chain name eg: base-mainnet" }, { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, "required": true, "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, { "name": "no-logs", "in": "query", "schema": { "type": "boolean", "description": "Flag to exclude logs from the response" }, "description": "Flag to exclude logs from the response" }, { "name": "block-signed-at-asc", "in": "query", "schema": { "type": "boolean", "description": "Sort the transactions in ascending chronological order. By default, it's set to false and returns transactions in descending chronological order" }, "description": "Sort the transactions in ascending chronological order. By default, it's set to false and returns transactions in descending chronological order" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "address": { "type": "string", "description": "The wallet address to fetch transaction details for" }, "updated_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "quote_currency": { "type": "string", "description": "The currency used for quoting transaction values" }, "chain_id": { "type": "integer", "description": "The unique identifier for the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "current_page": { "type": "integer", "description": "The current page of the paginated transactions list" }, "links": { "type": "object", "properties": { "prev": { "type": "string", "description": "The URL link to the previous page of the data. Null if no previous page exists" }, "next": { "type": "string", "description": "The URL link to the next page of the data. Null if no next page exists" } }, "description": "An object containing pagination links for navigating through pages of data" }, "items": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "block_height": { "type": "integer", "description": "The height of the block in the blockchain" }, "block_hash": { "type": "string", "description": "The unique hash of the block" }, "tx_hash": { "type": "string", "description": "The unique hash of the transaction" }, "tx_offset": { "type": "integer", "description": "The position of the transaction in the block" }, "successful": { "type": "boolean", "description": "Indicates whether the transaction was successful" }, "from_address": { "type": "string", "description": "The address of the transaction sender" }, "miner_address": { "type": "string", "description": "The address of the miner who mined the block" }, "from_address_label": { "type": "string", "description": "A label or name associated with the sender's address, if available" }, "to_address": { "type": "string", "description": "The address of the transaction recipient" }, "to_address_label": { "type": "string", "description": "The label or description associated with the recipient address" }, "value": { "type": "string", "description": "The amount of cryptocurrency transferred in the transaction, expressed as a raw string value" }, "value_quote": { "type": "integer", "description": "The fiat currency equivalent of the transaction value at the time of execution" }, "pretty_value_quote": { "type": "string", "description": "A human-readable string representation of the fiat currency equivalent of the transaction value" }, "gas_metadata": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimal places used by the contract for token calculations" }, "contract_name": { "type": "string", "description": "The name of the contract associated with the transaction" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol representing the contract's token" }, "contract_address": { "type": "string", "description": "The blockchain address of the contract" }, "supports_erc": { "type": "string", "description": "A list of strings specifying the ERC standards supported by the contract, such as ERC20 or ERC721" }, "logo_url": { "type": "string", "description": "A URL pointing to the logo associated with the contract" } }, "description": "The gas metadata object providing details about the gas contract, including its address, name, and token details" }, "gas_offered": { "type": "integer", "description": "The amount of gas that was initially offered for the transaction" }, "gas_spent": { "type": "integer", "description": "The actual amount of gas consumed during the transaction execution" }, "gas_price": { "type": "integer", "description": "The price per unit of gas offered by the sender, typically measured in Gwei" }, "fees_paid": { "type": "string", "description": "The total transaction fees paid, calculated as gas spent multiplied by gas price" }, "gas_quote": { "type": "integer", "description": "The transaction fee expressed in the quoted currency (e.g., USD)" }, "pretty_gas_quote": { "type": "string", "description": "A human-readable representation of the transaction fee in the quoted currency" }, "gas_quote_rate": { "type": "integer", "description": "The exchange rate used to convert gas fees from the native currency to the quoted currency" }, "explorers": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "The name or label of the explorer" }, "url": { "type": "string", "description": "The URL of the blockchain explorer" } } }, "description": "An array containing information about blockchain explorers related to the transaction" }, "dex_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "protocol_name": { "type": "string", "description": "The name of the DEX protocol involved in the transaction" }, "protocol_address": { "type": "string", "description": "The address of the DEX protocol's smart contract" }, "protocol_logo_url": { "type": "string", "description": "The URL of the logo for the DEX protocol" }, "aggregator_name": { "type": "string", "description": "The name of the aggregator involved in the transaction, if applicable" }, "aggregator_address": { "type": "string", "description": "The address of the aggregator's smart contract" }, "version": { "type": "integer", "description": "The version number of the protocol used" }, "fork_version": { "type": "integer", "description": "The fork version of the protocol, if applicable" }, "fork": { "type": "string", "description": "The name of the blockchain fork, if relevant" }, "event": { "type": "string", "description": "The specific event type that occurred in the transaction" }, "pair_address": { "type": "string", "description": "The address of the token pair involved in the transaction" }, "pair_lp_fee_bps": { "type": "integer", "description": "The liquidity provider fee in basis points (bps)" }, "lp_token_address": { "type": "string", "description": "The address of the liquidity pool token" }, "lp_token_ticker": { "type": "string", "description": "The ticker symbol of the liquidity pool token" }, "lp_token_num_decimals": { "type": "integer", "description": "The number of decimals for the liquidity pool token" }, "lp_token_name": { "type": "string", "description": "The name of the liquidity pool token" }, "lp_token_value": { "type": "string", "description": "The value of the liquidity pool token" }, "exchange_rate_usd": { "type": "integer", "description": "The exchange rate in USD for the token pair" }, "token_0_address": { "type": "string", "description": "The address of the first token in the pair" }, "token_0_ticker": { "type": "string", "description": "The ticker symbol of the first token" }, "token_0_num_decimals": { "type": "integer", "description": "The number of decimals for the first token" }, "token_0_name": { "type": "string", "description": "The name of the first token" }, "token_1_address": { "type": "string", "description": "The address of the second token in the pair" }, "token_1_ticker": { "type": "string", "description": "The ticker symbol of the second token" }, "token_1_num_decimals": { "type": "integer", "description": "The number of decimals for the second token" }, "token_1_name": { "type": "string", "description": "The name of the second token" }, "token_0_amount": { "type": "string", "description": "The amount of the first token involved in the transaction" }, "token_0_quote_rate": { "type": "integer", "description": "The quote rate for the first token in USD" }, "token_0_usd_quote": { "type": "integer", "description": "The USD equivalent of the first token amount" }, "pretty_token_0_usd_quote": { "type": "string", "description": "A human-readable USD equivalent of the first token amount" }, "token_0_logo_url": { "type": "string", "description": "The URL of the logo for the first token" }, "token_1_amount": { "type": "string", "description": "The amount of the second token involved in the transaction" }, "token_1_quote_rate": { "type": "integer", "description": "The quote rate for the second token in USD" }, "token_1_usd_quote": { "type": "integer", "description": "The USD equivalent of the second token amount" }, "pretty_token_1_usd_quote": { "type": "string", "description": "A human-readable USD equivalent of the second token amount" }, "token_1_logo_url": { "type": "string", "description": "The URL of the logo for the second token" }, "sender": { "type": "string", "description": "The address of the sender in the transaction" }, "recipient": { "type": "string", "description": "The address of the recipient in the transaction" } } }, "description": "(Optional) An array of details about DEX (Decentralized Exchange) activities related to the transaction" }, "nft_sale_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "topic0": { "type": "string", "description": "The first topic of the event log, typically used for event identification" }, "protocol_contract_address": { "type": "string", "description": "The address of the NFT protocol's contract involved in the sale" }, "protocol_name": { "type": "string", "description": "The name of the NFT protocol facilitating the sale" }, "protocol_logo_url": { "type": "string", "description": "The URL of the logo representing the NFT protocol" }, "to": { "type": "string", "description": "The address of the recipient in the NFT sale" }, "from": { "type": "string", "description": "The address of the sender in the NFT sale" }, "maker": { "type": "string", "description": "The address of the maker (order creator) in the NFT trade" }, "taker": { "type": "string", "description": "The address of the taker (order fulfiller) in the NFT trade" }, "token_id": { "type": "string", "description": "The unique identifier of the NFT token involved in the sale" }, "collection_address": { "type": "string", "description": "The address of the NFT collection's contract" }, "collection_name": { "type": "string", "description": "The name of the NFT collection" }, "token_address": { "type": "string", "description": "The address of the token used in the sale" }, "token_name": { "type": "string", "description": "The name of the token used in the sale" }, "ticker_symbol": { "type": "string", "description": "The ticker symbol of the token used in the sale" }, "num_decimals": { "type": "integer", "description": "The number of decimal places used by the token" }, "contract_quote_rate": { "type": "integer", "description": "The exchange rate of the token used in the sale, quoted in USD" }, "nft_token_price": { "type": "integer", "description": "The price of the NFT token in the native token" }, "nft_token_price_usd": { "type": "integer", "description": "The price of the NFT token in USD" }, "pretty_nft_token_price_usd": { "type": "string", "description": "A human-readable string representation of the NFT token price in USD" }, "nft_token_price_native": { "type": "integer", "description": "The price of the NFT token in the native blockchain currency" }, "pretty_nft_token_price_native": { "type": "string", "description": "A human-readable string representation of the NFT token price in the native currency" }, "token_count": { "type": "integer", "description": "The number of tokens involved in the NFT sale" }, "num_token_ids_sold_per_sale": { "type": "integer", "description": "The number of unique token IDs sold in a single sale" }, "num_token_ids_sold_per_tx": { "type": "integer", "description": "The number of unique token IDs sold in a single transaction" }, "num_collections_sold_per_sale": { "type": "integer", "description": "The number of NFT collections involved in a single sale" }, "num_collections_sold_per_tx": { "type": "integer", "description": "The number of NFT collections involved in a single transaction" }, "trade_type": { "type": "string", "description": "The type of trade (e.g., primary sale, secondary sale)" }, "trade_group_type": { "type": "string", "description": "The group type of the trade (e.g., batch, single)" } } }, "description": "(Optional) An array containing details of NFT sales associated with the transaction" }, "lending_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "protocol_name": { "type": "string", "description": "The name of the lending protocol involved in the transaction" }, "protocol_address": { "type": "string", "description": "The address of the lending protocol's contract" }, "protocol_logo_url": { "type": "string", "description": "The URL of the lending protocol's logo" }, "version": { "type": "string", "description": "The version of the lending protocol" }, "fork": { "type": "string", "description": "The fork of the lending protocol, if applicable" }, "fork_version": { "type": "string", "description": "The version of the protocol fork, if applicable" }, "event": { "type": "string", "description": "The specific event type associated with the lending transaction" }, "lp_token_name": { "type": "string", "description": "The name of the liquidity provider token" }, "lp_decimals": { "type": "integer", "description": "The number of decimal places for the liquidity provider token" }, "lp_ticker_symbol": { "type": "string", "description": "The ticker symbol for the liquidity provider token" }, "lp_token_address": { "type": "string", "description": "The address of the liquidity provider token contract" }, "lp_token_amount": { "type": "integer", "description": "The amount of liquidity provider tokens involved in the transaction" }, "lp_token_price": { "type": "integer", "description": "The price of the liquidity provider token" }, "exchange_rate": { "type": "integer", "description": "The exchange rate between the liquidity provider token and the underlying asset" }, "exchange_rate_usd": { "type": "integer", "description": "The exchange rate between the liquidity provider token and USD" }, "token_name_in": { "type": "string", "description": "The name of the input token for the lending transaction" }, "token_decimal_in": { "type": "integer", "description": "The number of decimal places for the input token" }, "token_address_in": { "type": "string", "description": "The address of the input token's contract" }, "token_ticker_in": { "type": "string", "description": "The ticker symbol of the input token" }, "token_logo_in": { "type": "string", "description": "The URL of the logo for the input token" }, "token_amount_in": { "type": "integer", "description": "The amount of input tokens involved in the lending transaction" }, "amount_in_usd": { "type": "integer", "description": "The value of the input tokens in USD" }, "pretty_amount_in_usd": { "type": "string", "description": "A human-readable string representation of the input token value in USD" }, "token_name_out": { "type": "string", "description": "The name of the output token for the lending transaction" }, "token_decimals_out": { "type": "integer", "description": "The number of decimal places for the output token" }, "token_address_out": { "type": "string", "description": "The address of the output token's contract" }, "token_ticker_out": { "type": "string", "description": "The ticker symbol of the output token" }, "token_logo_out": { "type": "string", "description": "The URL of the logo for the output token" }, "token_amount_out": { "type": "integer", "description": "The amount of output tokens involved in the lending transaction" }, "amount_out_usd": { "type": "integer", "description": "The value of the output tokens in USD" }, "pretty_amount_out_usd": { "type": "string", "description": "A human-readable string representation of the output token value in USD" }, "borrow_rate_mode": { "type": "integer", "description": "The mode of the borrowing rate (e.g., stable or variable)" }, "borrow_rate": { "type": "integer", "description": "The borrowing rate for the transaction" }, "on_behalf_of": { "type": "string", "description": "The address of the entity on whose behalf the transaction is performed" }, "liquidator": { "type": "string", "description": "The address of the liquidator involved in the lending transaction, if applicable" }, "user": { "type": "string", "description": "The address of the user initiating the lending transaction" } } }, "description": "(Optional) An array of lending details containing information about lending transactions" }, "log_events": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp at which the block containing the log event was signed" }, "block_height": { "type": "integer", "description": "The height of the block containing the log event" }, "tx_offset": { "type": "integer", "description": "The offset of the transaction in the block" }, "log_offset": { "type": "integer", "description": "The offset of the log event within the transaction" }, "tx_hash": { "type": "string", "description": "The hash of the transaction associated with the log event" }, "raw_log_topics": { "type": "string", "description": "A list of string values representing the raw topics for the log event" }, "sender_contract_decimals": { "type": "integer", "description": "The number of decimal places used by the sender's contract" }, "sender_name": { "type": "string", "description": "The name of the sender's contract, if available" }, "sender_contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the sender's contract, if available" }, "sender_address": { "type": "string", "description": "The address of the sender involved in the log event" }, "sender_address_label": { "type": "string", "description": "The label associated with the sender's address, if available" }, "sender_logo_url": { "type": "string", "description": "The URL of the logo for the sender's contract or address" }, "supports_erc": { "type": "string", "description": "A list of string values indicating the supported ERC standards for the sender's contract" }, "sender_factory_address": { "type": "string", "description": "The address of the factory contract that created the sender's contract, if applicable" }, "raw_log_data": { "type": "string", "description": "The raw data of the log event" }, "decoded": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the event associated with the log" }, "signature": { "type": "string", "description": "The signature of the event associated with the log" }, "params": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the parameter" }, "type": { "type": "string", "description": "The data type of the parameter" }, "indexed": { "type": "boolean", "description": "Indicates whether the parameter is indexed in the log" }, "decoded": { "type": "boolean", "description": "Indicates whether the parameter has been decoded" }, "value": { "type": "string", "description": "The value of the parameter" } } }, "description": "An array of parameters associated with the log event" } }, "description": "The decoded object which contains detailed information about the log event" } } }, "description": "(Optional) An array of log events that detail specific occurrences within a transaction" }, "safe_details": { "type": "array", "items": { "type": "object", "properties": { "owner_address": { "type": "string", "description": "The address of the owner associated with the safe" }, "signature": { "type": "string", "description": "The cryptographic signature provided by the owner for safe operations" }, "signature_type": { "type": "string", "description": "The type of cryptographic signature used for the safe" } } }, "description": "(Optional) An array of safe details providing information about the owners and signatures of the safe" } } }, "description": "An array of items" } }, "description": "The response data containing details of the wallet and its token approvals" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred, or null otherwise" }, "error_code": { "type": "string", "description": "The error code if an error occurred, or null otherwise" } } } } } } } } }, "/v1/{chainName}/address/{walletAddress}/transactions_v3/page/{page}": { "get": { "operationId": "get_v1_by_chainName_address_by_walletAddress_transactions_v3_page_by_page", "summary": "Commonly used to fetch the transactions involving an address including the decoded log events in a paginated fashion", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-address-walletAddress-transactions_v3-page-page" }, "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name eg: base-mainnet" }, "required": true, "description": "The chain name eg: base-mainnet" }, { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, "required": true, "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, { "name": "page", "in": "path", "schema": { "type": "integer", "description": "The requested page, 0-indexed" }, "required": true, "description": "The requested page, 0-indexed" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, { "name": "no-logs", "in": "query", "schema": { "type": "boolean", "description": "Flag to exclude logs from the response" }, "description": "Flag to exclude logs from the response" }, { "name": "block-signed-at-asc", "in": "query", "schema": { "type": "boolean", "description": "Sort the transactions in ascending chronological order. By default, it's set to false and returns transactions in descending chronological order" }, "description": "Sort the transactions in ascending chronological order. By default, it's set to false and returns transactions in descending chronological order" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "address": { "type": "string", "description": "The wallet address to fetch transaction details for" }, "updated_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "quote_currency": { "type": "string", "description": "The currency used for quoting transaction values" }, "chain_id": { "type": "integer", "description": "The unique identifier for the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "current_page": { "type": "integer", "description": "The current page of the paginated transactions list" }, "links": { "type": "object", "properties": { "prev": { "type": "string", "description": "The URL link to the previous page of the data. Null if no previous page exists" }, "next": { "type": "string", "description": "The URL link to the next page of the data. Null if no next page exists" } }, "description": "An object containing pagination links for navigating through pages of data" }, "items": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "block_height": { "type": "integer", "description": "The height of the block in the blockchain" }, "block_hash": { "type": "string", "description": "The unique hash of the block" }, "tx_hash": { "type": "string", "description": "The unique hash of the transaction" }, "tx_offset": { "type": "integer", "description": "The position of the transaction in the block" }, "successful": { "type": "boolean", "description": "Indicates whether the transaction was successful" }, "from_address": { "type": "string", "description": "The address of the transaction sender" }, "miner_address": { "type": "string", "description": "The address of the miner who mined the block" }, "from_address_label": { "type": "string", "description": "A label or name associated with the sender's address, if available" }, "to_address": { "type": "string", "description": "The address of the transaction recipient" }, "to_address_label": { "type": "string", "description": "The label or description associated with the recipient address" }, "value": { "type": "string", "description": "The amount of cryptocurrency transferred in the transaction, expressed as a raw string value" }, "value_quote": { "type": "integer", "description": "The fiat currency equivalent of the transaction value at the time of execution" }, "pretty_value_quote": { "type": "string", "description": "A human-readable string representation of the fiat currency equivalent of the transaction value" }, "gas_metadata": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimal places used by the contract for token calculations" }, "contract_name": { "type": "string", "description": "The name of the contract associated with the transaction" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol representing the contract's token" }, "contract_address": { "type": "string", "description": "The blockchain address of the contract" }, "supports_erc": { "type": "string", "description": "A list of strings specifying the ERC standards supported by the contract, such as ERC20 or ERC721" }, "logo_url": { "type": "string", "description": "A URL pointing to the logo associated with the contract" } }, "description": "The gas metadata object providing details about the gas contract, including its address, name, and token details" }, "gas_offered": { "type": "integer", "description": "The amount of gas that was initially offered for the transaction" }, "gas_spent": { "type": "integer", "description": "The actual amount of gas consumed during the transaction execution" }, "gas_price": { "type": "integer", "description": "The price per unit of gas offered by the sender, typically measured in Gwei" }, "fees_paid": { "type": "string", "description": "The total transaction fees paid, calculated as gas spent multiplied by gas price" }, "gas_quote": { "type": "integer", "description": "The transaction fee expressed in the quoted currency (e.g., USD)" }, "pretty_gas_quote": { "type": "string", "description": "A human-readable representation of the transaction fee in the quoted currency" }, "gas_quote_rate": { "type": "integer", "description": "The exchange rate used to convert gas fees from the native currency to the quoted currency" }, "explorers": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "The name or label of the explorer" }, "url": { "type": "string", "description": "The URL of the blockchain explorer" } } }, "description": "An array containing information about blockchain explorers related to the transaction" }, "dex_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "protocol_name": { "type": "string", "description": "The name of the DEX protocol involved in the transaction" }, "protocol_address": { "type": "string", "description": "The address of the DEX protocol's smart contract" }, "protocol_logo_url": { "type": "string", "description": "The URL of the logo for the DEX protocol" }, "aggregator_name": { "type": "string", "description": "The name of the aggregator involved in the transaction, if applicable" }, "aggregator_address": { "type": "string", "description": "The address of the aggregator's smart contract" }, "version": { "type": "integer", "description": "The version number of the protocol used" }, "fork_version": { "type": "integer", "description": "The fork version of the protocol, if applicable" }, "fork": { "type": "string", "description": "The name of the blockchain fork, if relevant" }, "event": { "type": "string", "description": "The specific event type that occurred in the transaction" }, "pair_address": { "type": "string", "description": "The address of the token pair involved in the transaction" }, "pair_lp_fee_bps": { "type": "integer", "description": "The liquidity provider fee in basis points (bps)" }, "lp_token_address": { "type": "string", "description": "The address of the liquidity pool token" }, "lp_token_ticker": { "type": "string", "description": "The ticker symbol of the liquidity pool token" }, "lp_token_num_decimals": { "type": "integer", "description": "The number of decimals for the liquidity pool token" }, "lp_token_name": { "type": "string", "description": "The name of the liquidity pool token" }, "lp_token_value": { "type": "string", "description": "The value of the liquidity pool token" }, "exchange_rate_usd": { "type": "integer", "description": "The exchange rate in USD for the token pair" }, "token_0_address": { "type": "string", "description": "The address of the first token in the pair" }, "token_0_ticker": { "type": "string", "description": "The ticker symbol of the first token" }, "token_0_num_decimals": { "type": "integer", "description": "The number of decimals for the first token" }, "token_0_name": { "type": "string", "description": "The name of the first token" }, "token_1_address": { "type": "string", "description": "The address of the second token in the pair" }, "token_1_ticker": { "type": "string", "description": "The ticker symbol of the second token" }, "token_1_num_decimals": { "type": "integer", "description": "The number of decimals for the second token" }, "token_1_name": { "type": "string", "description": "The name of the second token" }, "token_0_amount": { "type": "string", "description": "The amount of the first token involved in the transaction" }, "token_0_quote_rate": { "type": "integer", "description": "The quote rate for the first token in USD" }, "token_0_usd_quote": { "type": "integer", "description": "The USD equivalent of the first token amount" }, "pretty_token_0_usd_quote": { "type": "string", "description": "A human-readable USD equivalent of the first token amount" }, "token_0_logo_url": { "type": "string", "description": "The URL of the logo for the first token" }, "token_1_amount": { "type": "string", "description": "The amount of the second token involved in the transaction" }, "token_1_quote_rate": { "type": "integer", "description": "The quote rate for the second token in USD" }, "token_1_usd_quote": { "type": "integer", "description": "The USD equivalent of the second token amount" }, "pretty_token_1_usd_quote": { "type": "string", "description": "A human-readable USD equivalent of the second token amount" }, "token_1_logo_url": { "type": "string", "description": "The URL of the logo for the second token" }, "sender": { "type": "string", "description": "The address of the sender in the transaction" }, "recipient": { "type": "string", "description": "The address of the recipient in the transaction" } } }, "description": "(Optional) An array of details about DEX (Decentralized Exchange) activities related to the transaction" }, "nft_sale_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "topic0": { "type": "string", "description": "The first topic of the event log, typically used for event identification" }, "protocol_contract_address": { "type": "string", "description": "The address of the NFT protocol's contract involved in the sale" }, "protocol_name": { "type": "string", "description": "The name of the NFT protocol facilitating the sale" }, "protocol_logo_url": { "type": "string", "description": "The URL of the logo representing the NFT protocol" }, "to": { "type": "string", "description": "The address of the recipient in the NFT sale" }, "from": { "type": "string", "description": "The address of the sender in the NFT sale" }, "maker": { "type": "string", "description": "The address of the maker (order creator) in the NFT trade" }, "taker": { "type": "string", "description": "The address of the taker (order fulfiller) in the NFT trade" }, "token_id": { "type": "string", "description": "The unique identifier of the NFT token involved in the sale" }, "collection_address": { "type": "string", "description": "The address of the NFT collection's contract" }, "collection_name": { "type": "string", "description": "The name of the NFT collection" }, "token_address": { "type": "string", "description": "The address of the token used in the sale" }, "token_name": { "type": "string", "description": "The name of the token used in the sale" }, "ticker_symbol": { "type": "string", "description": "The ticker symbol of the token used in the sale" }, "num_decimals": { "type": "integer", "description": "The number of decimal places used by the token" }, "contract_quote_rate": { "type": "integer", "description": "The exchange rate of the token used in the sale, quoted in USD" }, "nft_token_price": { "type": "integer", "description": "The price of the NFT token in the native token" }, "nft_token_price_usd": { "type": "integer", "description": "The price of the NFT token in USD" }, "pretty_nft_token_price_usd": { "type": "string", "description": "A human-readable string representation of the NFT token price in USD" }, "nft_token_price_native": { "type": "integer", "description": "The price of the NFT token in the native blockchain currency" }, "pretty_nft_token_price_native": { "type": "string", "description": "A human-readable string representation of the NFT token price in the native currency" }, "token_count": { "type": "integer", "description": "The number of tokens involved in the NFT sale" }, "num_token_ids_sold_per_sale": { "type": "integer", "description": "The number of unique token IDs sold in a single sale" }, "num_token_ids_sold_per_tx": { "type": "integer", "description": "The number of unique token IDs sold in a single transaction" }, "num_collections_sold_per_sale": { "type": "integer", "description": "The number of NFT collections involved in a single sale" }, "num_collections_sold_per_tx": { "type": "integer", "description": "The number of NFT collections involved in a single transaction" }, "trade_type": { "type": "string", "description": "The type of trade (e.g., primary sale, secondary sale)" }, "trade_group_type": { "type": "string", "description": "The group type of the trade (e.g., batch, single)" } } }, "description": "(Optional) An array containing details of NFT sales associated with the transaction" }, "lending_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "protocol_name": { "type": "string", "description": "The name of the lending protocol involved in the transaction" }, "protocol_address": { "type": "string", "description": "The address of the lending protocol's contract" }, "protocol_logo_url": { "type": "string", "description": "The URL of the lending protocol's logo" }, "version": { "type": "string", "description": "The version of the lending protocol" }, "fork": { "type": "string", "description": "The fork of the lending protocol, if applicable" }, "fork_version": { "type": "string", "description": "The version of the protocol fork, if applicable" }, "event": { "type": "string", "description": "The specific event type associated with the lending transaction" }, "lp_token_name": { "type": "string", "description": "The name of the liquidity provider token" }, "lp_decimals": { "type": "integer", "description": "The number of decimal places for the liquidity provider token" }, "lp_ticker_symbol": { "type": "string", "description": "The ticker symbol for the liquidity provider token" }, "lp_token_address": { "type": "string", "description": "The address of the liquidity provider token contract" }, "lp_token_amount": { "type": "integer", "description": "The amount of liquidity provider tokens involved in the transaction" }, "lp_token_price": { "type": "integer", "description": "The price of the liquidity provider token" }, "exchange_rate": { "type": "integer", "description": "The exchange rate between the liquidity provider token and the underlying asset" }, "exchange_rate_usd": { "type": "integer", "description": "The exchange rate between the liquidity provider token and USD" }, "token_name_in": { "type": "string", "description": "The name of the input token for the lending transaction" }, "token_decimal_in": { "type": "integer", "description": "The number of decimal places for the input token" }, "token_address_in": { "type": "string", "description": "The address of the input token's contract" }, "token_ticker_in": { "type": "string", "description": "The ticker symbol of the input token" }, "token_logo_in": { "type": "string", "description": "The URL of the logo for the input token" }, "token_amount_in": { "type": "integer", "description": "The amount of input tokens involved in the lending transaction" }, "amount_in_usd": { "type": "integer", "description": "The value of the input tokens in USD" }, "pretty_amount_in_usd": { "type": "string", "description": "A human-readable string representation of the input token value in USD" }, "token_name_out": { "type": "string", "description": "The name of the output token for the lending transaction" }, "token_decimals_out": { "type": "integer", "description": "The number of decimal places for the output token" }, "token_address_out": { "type": "string", "description": "The address of the output token's contract" }, "token_ticker_out": { "type": "string", "description": "The ticker symbol of the output token" }, "token_logo_out": { "type": "string", "description": "The URL of the logo for the output token" }, "token_amount_out": { "type": "integer", "description": "The amount of output tokens involved in the lending transaction" }, "amount_out_usd": { "type": "integer", "description": "The value of the output tokens in USD" }, "pretty_amount_out_usd": { "type": "string", "description": "A human-readable string representation of the output token value in USD" }, "borrow_rate_mode": { "type": "integer", "description": "The mode of the borrowing rate (e.g., stable or variable)" }, "borrow_rate": { "type": "integer", "description": "The borrowing rate for the transaction" }, "on_behalf_of": { "type": "string", "description": "The address of the entity on whose behalf the transaction is performed" }, "liquidator": { "type": "string", "description": "The address of the liquidator involved in the lending transaction, if applicable" }, "user": { "type": "string", "description": "The address of the user initiating the lending transaction" } } }, "description": "(Optional) An array of lending details containing information about lending transactions" }, "log_events": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp at which the block containing the log event was signed" }, "block_height": { "type": "integer", "description": "The height of the block containing the log event" }, "tx_offset": { "type": "integer", "description": "The offset of the transaction in the block" }, "log_offset": { "type": "integer", "description": "The offset of the log event within the transaction" }, "tx_hash": { "type": "string", "description": "The hash of the transaction associated with the log event" }, "raw_log_topics": { "type": "string", "description": "A list of string values representing the raw topics for the log event" }, "sender_contract_decimals": { "type": "integer", "description": "The number of decimal places used by the sender's contract" }, "sender_name": { "type": "string", "description": "The name of the sender's contract, if available" }, "sender_contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the sender's contract, if available" }, "sender_address": { "type": "string", "description": "The address of the sender involved in the log event" }, "sender_address_label": { "type": "string", "description": "The label associated with the sender's address, if available" }, "sender_logo_url": { "type": "string", "description": "The URL of the logo for the sender's contract or address" }, "supports_erc": { "type": "string", "description": "A list of string values indicating the supported ERC standards for the sender's contract" }, "sender_factory_address": { "type": "string", "description": "The address of the factory contract that created the sender's contract, if applicable" }, "raw_log_data": { "type": "string", "description": "The raw data of the log event" }, "decoded": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the event associated with the log" }, "signature": { "type": "string", "description": "The signature of the event associated with the log" }, "params": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the parameter" }, "type": { "type": "string", "description": "The data type of the parameter" }, "indexed": { "type": "boolean", "description": "Indicates whether the parameter is indexed in the log" }, "decoded": { "type": "boolean", "description": "Indicates whether the parameter has been decoded" }, "value": { "type": "string", "description": "The value of the parameter" } } }, "description": "An array of parameters associated with the log event" } }, "description": "The decoded object which contains detailed information about the log event" } } }, "description": "(Optional) An array of log events that detail specific occurrences within a transaction" }, "safe_details": { "type": "array", "items": { "type": "object", "properties": { "owner_address": { "type": "string", "description": "The address of the owner associated with the safe" }, "signature": { "type": "string", "description": "The cryptographic signature provided by the owner for safe operations" }, "signature_type": { "type": "string", "description": "The type of cryptographic signature used for the safe" } } }, "description": "(Optional) An array of safe details providing information about the owners and signatures of the safe" } } }, "description": "An array of items" } }, "description": "The response data containing details of the wallet and its token approvals" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred, or null otherwise" }, "error_code": { "type": "string", "description": "The error code if an error occurred, or null otherwise" } } } } } } } } }, "/v1/{chainName}/address/{walletAddress}/transfers_v2": { "get": { "operationId": "get_v1_by_chainName_address_by_walletAddress_transfers_v2", "summary": "Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-address-walletAddress-transfers_v2" }, "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name eg: base-mainnet" }, "required": true, "description": "The chain name eg: base-mainnet" }, { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, "required": true, "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, { "name": "contract-address", "in": "query", "schema": { "type": "string", "description": "The requested contract address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, "description": "The requested contract address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, { "name": "starting-block", "in": "query", "schema": { "type": "integer", "description": "The block height to start from, defaults to 0" }, "description": "The block height to start from, defaults to 0" }, { "name": "ending-block", "in": "query", "schema": { "type": "integer", "description": "The block height to end at, defaults to current block height" }, "description": "The block height to end at, defaults to current block height" }, { "name": "page-size", "in": "query", "schema": { "type": "integer", "description": "The number of results to return per page. Omitting this parameter defaults to 100" }, "description": "The number of results to return per page. Omitting this parameter defaults to 100" }, { "name": "page-number", "in": "query", "schema": { "type": "integer", "description": "The page number to retrieve" }, "description": "The page number to retrieve" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "address": { "type": "string", "description": "The blockchain address for which transaction data is retrieved" }, "updated_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "quote_currency": { "type": "string", "description": "The currency used for quoting values" }, "chain_id": { "type": "integer", "description": "The ID of the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "items": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "block_height": { "type": "integer", "description": "The height of the block in the blockchain" }, "block_hash": { "type": "string", "description": "The unique hash of the block" }, "tx_hash": { "type": "string", "description": "The unique hash of the transaction" }, "tx_offset": { "type": "integer", "description": "The offset of the transaction in the block" }, "successful": { "type": "boolean", "description": "Indicates if the transaction was successful" }, "miner_address": { "type": "string", "description": "The address of the miner who validated the block" }, "from_address": { "type": "string", "description": "The sender's address for the transaction" }, "from_address_label": { "type": "string", "description": "A label for the sender's address, if available" }, "to_address": { "type": "string", "description": "The recipient's address for the transaction" }, "to_address_label": { "type": "string", "description": "A label for the recipient's address, if available" }, "value": { "type": "string", "description": "The value of the transaction" }, "value_quote": { "type": "integer", "description": "The quoted value of the transaction in the specified currency" }, "pretty_value_quote": { "type": "string", "description": "A formatted string of the quoted value" }, "gas_metadata": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimals used by the token contract" }, "contract_name": { "type": "string", "description": "The name of the token contract" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the token contract" }, "contract_address": { "type": "string", "description": "The address of the token contract" }, "supports_erc": { "type": "array", "items": {}, "description": "A list of supported ERC standards" }, "logo_url": { "type": "string", "description": "The URL of the token's logo" } }, "description": "Metadata about the gas used in the transaction" }, "gas_offered": { "type": "integer", "description": "The amount of gas offered for the transaction" }, "gas_spent": { "type": "integer", "description": "The amount of gas spent for the transaction" }, "gas_price": { "type": "integer", "description": "The price of gas used in the transaction" }, "fees_paid": { "type": "string", "description": "The total fees paid for the transaction" }, "gas_quote": { "type": "integer", "description": "The quoted value of gas in the specified currency" }, "pretty_gas_quote": { "type": "string", "description": "A formatted string of the gas quote" }, "gas_quote_rate": { "type": "integer", "description": "The rate of gas in the specified currency" }, "transfers": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "tx_hash": { "type": "string", "description": "The unique hash of the transaction" }, "from_address": { "type": "string", "description": "The sender's address for the transfer" }, "to_address": { "type": "string", "description": "The recipient's address for the transfer" }, "delta": { "type": "string", "description": "The change in balance resulting from the transfer" } } }, "description": "An array of transfer details within the transaction" } } }, "description": "An array of transaction items" }, "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "Indicates if there are more pages of data" }, "page_number": { "type": "integer", "description": "The current page number" }, "page_size": { "type": "integer", "description": "The number of items per page" }, "total_count": { "type": "integer", "description": "The total number of items available" } }, "description": "Pagination details for the result set" } }, "description": "The response data containing following fields:" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred, or null otherwise" }, "error_code": { "type": "string", "description": "The error code if an error occurred, or null otherwise" } } } } } } } } }, "/v1/{chainName}/approvals/{walletAddress}": { "get": { "operationId": "get_v1_by_chainName_approvals_by_walletAddress", "summary": "Commonly used to get a list of approvals across all token contracts categorized by spenders for a wallet’s assets", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-approvals-walletAddress" }, "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name eg: base-mainnet" }, "required": true, "description": "The chain name eg: base-mainnet" }, { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, "required": true, "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "address": { "type": "string", "description": "The wallet address associated with the approvals" }, "updated_at": { "type": "string", "description": "The timestamp of the last update for the data" }, "quote_currency": { "type": "string", "description": "The currency in which the balances and risks are quoted" }, "chain_id": { "type": "integer", "description": "The ID of the blockchain network queried" }, "chain_name": { "type": "string", "description": "The name of the blockchain network queried" }, "items": { "type": "array", "items": { "type": "object", "properties": { "token_address": { "type": "string", "description": "The contract address of the token" }, "token_address_label": { "type": "string", "description": "The label or name of the token contract" }, "ticker_symbol": { "type": "string", "description": "The ticker symbol of the token" }, "contract_decimals": { "type": "integer", "description": "The number of decimals for the token" }, "logo_url": { "type": "string", "description": "The URL for the token's logo" }, "quote_rate": { "type": "number", "description": "The quoted rate of the token in the specified currency" }, "balance": { "type": "string", "description": "The token balance in raw format" }, "balance_quote": { "type": "number", "description": "The balance value quoted in the specified currency" }, "pretty_balance_quote": { "type": "string", "description": "The balance value in a human-readable format" }, "value_at_risk": { "type": "string", "description": "The amount of token value at risk" }, "value_at_risk_quote": { "type": "number", "description": "The value at risk quoted in the specified currency" }, "pretty_value_at_risk_quote": { "type": "string", "description": "The value at risk in a human-readable format" }, "spenders": { "type": "array", "items": { "type": "object", "properties": { "block_height": { "type": "integer", "description": "The height of the block where the approval occurred" }, "tx_offset": { "type": "integer", "description": "The transaction offset in the block" }, "log_offset": { "type": "integer", "description": "The log offset in the transaction" }, "block_signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "tx_hash": { "type": "string", "description": "The hash of the transaction where the approval occurred" }, "spender_address": { "type": "string", "description": "The address of the spender with token approval" }, "spender_address_label": { "type": "string", "description": "The label for the spender address, if available" }, "allowance": { "type": "string", "description": "The allowance granted to the spender" }, "allowance_quote": { "type": "number", "description": "The quoted allowance value in the specified currency" }, "pretty_allowance_quote": { "type": "string", "description": "The quoted allowance value in a human-readable format" }, "value_at_risk": { "type": "string", "description": "The token value at risk due to the spender" }, "value_at_risk_quote": { "type": "number", "description": "The value at risk quoted in the specified currency" }, "pretty_value_at_risk_quote": { "type": "string", "description": "The value at risk in a human-readable format" }, "risk_factor": { "type": "string", "description": "The risk level associated with the token approval" } } }, "description": "A list of spenders who have approvals for the token" } } }, "description": "A list of token approval details for the wallet address" } }, "description": "The response data containing details of the wallet and its token approvals" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred, or null otherwise" }, "error_code": { "type": "string", "description": "The error code if an error occurred, or null otherwise" } } } } } } } } }, "/v1/{chainName}/block/{blockHeight}/transactions_v3/page/{page}": { "get": { "operationId": "get_v1_by_chainName_block_by_blockHeight_transactions_v3_page_by_page", "summary": "Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting walle", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-block-blockHeight-transactions_v3-page-page" }, "description": "Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions", "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name for the blockchain network" }, "required": true, "description": "The chain name for the blockchain network" }, { "name": "blockHeight", "in": "path", "schema": { "type": "integer", "description": "The height of the block to query" }, "required": true, "description": "The height of the block to query" }, { "name": "page", "in": "path", "schema": { "type": "integer", "description": "The requested 0-indexed page number" }, "required": true, "description": "The requested 0-indexed page number" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, { "name": "no-logs", "in": "query", "schema": { "type": "boolean", "description": "Flag to exclude logs from the response" }, "description": "Flag to exclude logs from the response" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp indicating when the data was last updated" }, "chain_id": { "type": "integer", "description": "The unique identifier of the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "links": { "type": "object", "properties": { "prev": { "type": "string", "description": "The URL link to the previous page of the data. Null if no previous page exists" }, "next": { "type": "string", "description": "The URL link to the next page of the data. Null if no next page exists" } }, "description": "An object containing pagination links for navigating through pages of data" }, "items": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "block_height": { "type": "integer", "description": "The height of the block in the blockchain" }, "block_hash": { "type": "string", "description": "The unique hash of the block" }, "tx_hash": { "type": "string", "description": "The unique hash of the transaction" }, "tx_offset": { "type": "integer", "description": "The position of the transaction in the block" }, "successful": { "type": "boolean", "description": "Indicates whether the transaction was successful" }, "from_address": { "type": "string", "description": "The address of the transaction sender" }, "miner_address": { "type": "string", "description": "The address of the miner who mined the block" }, "from_address_label": { "type": "string", "description": "A label or name associated with the sender's address, if available" }, "to_address": { "type": "string", "description": "The address of the transaction recipient" }, "to_address_label": { "type": "string", "description": "The label or description associated with the recipient address" }, "value": { "type": "string", "description": "The amount of cryptocurrency transferred in the transaction, expressed as a raw string value" }, "value_quote": { "type": "integer", "description": "The fiat currency equivalent of the transaction value at the time of execution" }, "pretty_value_quote": { "type": "string", "description": "A human-readable string representation of the fiat currency equivalent of the transaction value" }, "gas_metadata": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimal places used by the contract for token calculations" }, "contract_name": { "type": "string", "description": "The name of the contract associated with the transaction" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol representing the contract's token" }, "contract_address": { "type": "string", "description": "The blockchain address of the contract" }, "supports_erc": { "type": "string", "description": "A list of strings specifying the ERC standards supported by the contract, such as ERC20 or ERC721" }, "logo_url": { "type": "string", "description": "A URL pointing to the logo associated with the contract" } }, "description": "The gas metadata object providing details about the gas contract, including its address, name, and token details" }, "gas_offered": { "type": "integer", "description": "The amount of gas that was initially offered for the transaction" }, "gas_spent": { "type": "integer", "description": "The actual amount of gas consumed during the transaction execution" }, "gas_price": { "type": "integer", "description": "The price per unit of gas offered by the sender, typically measured in Gwei" }, "fees_paid": { "type": "string", "description": "The total transaction fees paid, calculated as gas spent multiplied by gas price" }, "gas_quote": { "type": "integer", "description": "The transaction fee expressed in the quoted currency (e.g., USD)" }, "pretty_gas_quote": { "type": "string", "description": "A human-readable representation of the transaction fee in the quoted currency" }, "gas_quote_rate": { "type": "integer", "description": "The exchange rate used to convert gas fees from the native currency to the quoted currency" }, "explorers": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "The name or label of the explorer" }, "url": { "type": "string", "description": "The URL of the blockchain explorer" } } }, "description": "An array containing information about blockchain explorers related to the transaction" }, "dex_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "protocol_name": { "type": "string", "description": "The name of the DEX protocol involved in the transaction" }, "protocol_address": { "type": "string", "description": "The address of the DEX protocol's smart contract" }, "protocol_logo_url": { "type": "string", "description": "The URL of the logo for the DEX protocol" }, "aggregator_name": { "type": "string", "description": "The name of the aggregator involved in the transaction, if applicable" }, "aggregator_address": { "type": "string", "description": "The address of the aggregator's smart contract" }, "version": { "type": "integer", "description": "The version number of the protocol used" }, "fork_version": { "type": "integer", "description": "The fork version of the protocol, if applicable" }, "fork": { "type": "string", "description": "The name of the blockchain fork, if relevant" }, "event": { "type": "string", "description": "The specific event type that occurred in the transaction" }, "pair_address": { "type": "string", "description": "The address of the token pair involved in the transaction" }, "pair_lp_fee_bps": { "type": "integer", "description": "The liquidity provider fee in basis points (bps)" }, "lp_token_address": { "type": "string", "description": "The address of the liquidity pool token" }, "lp_token_ticker": { "type": "string", "description": "The ticker symbol of the liquidity pool token" }, "lp_token_num_decimals": { "type": "integer", "description": "The number of decimals for the liquidity pool token" }, "lp_token_name": { "type": "string", "description": "The name of the liquidity pool token" }, "lp_token_value": { "type": "string", "description": "The value of the liquidity pool token" }, "exchange_rate_usd": { "type": "integer", "description": "The exchange rate in USD for the token pair" }, "token_0_address": { "type": "string", "description": "The address of the first token in the pair" }, "token_0_ticker": { "type": "string", "description": "The ticker symbol of the first token" }, "token_0_num_decimals": { "type": "integer", "description": "The number of decimals for the first token" }, "token_0_name": { "type": "string", "description": "The name of the first token" }, "token_1_address": { "type": "string", "description": "The address of the second token in the pair" }, "token_1_ticker": { "type": "string", "description": "The ticker symbol of the second token" }, "token_1_num_decimals": { "type": "integer", "description": "The number of decimals for the second token" }, "token_1_name": { "type": "string", "description": "The name of the second token" }, "token_0_amount": { "type": "string", "description": "The amount of the first token involved in the transaction" }, "token_0_quote_rate": { "type": "integer", "description": "The quote rate for the first token in USD" }, "token_0_usd_quote": { "type": "integer", "description": "The USD equivalent of the first token amount" }, "pretty_token_0_usd_quote": { "type": "string", "description": "A human-readable USD equivalent of the first token amount" }, "token_0_logo_url": { "type": "string", "description": "The URL of the logo for the first token" }, "token_1_amount": { "type": "string", "description": "The amount of the second token involved in the transaction" }, "token_1_quote_rate": { "type": "integer", "description": "The quote rate for the second token in USD" }, "token_1_usd_quote": { "type": "integer", "description": "The USD equivalent of the second token amount" }, "pretty_token_1_usd_quote": { "type": "string", "description": "A human-readable USD equivalent of the second token amount" }, "token_1_logo_url": { "type": "string", "description": "The URL of the logo for the second token" }, "sender": { "type": "string", "description": "The address of the sender in the transaction" }, "recipient": { "type": "string", "description": "The address of the recipient in the transaction" } } }, "description": "(Optional) An array of details about DEX (Decentralized Exchange) activities related to the transaction" }, "nft_sale_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "topic0": { "type": "string", "description": "The first topic of the event log, typically used for event identification" }, "protocol_contract_address": { "type": "string", "description": "The address of the NFT protocol's contract involved in the sale" }, "protocol_name": { "type": "string", "description": "The name of the NFT protocol facilitating the sale" }, "protocol_logo_url": { "type": "string", "description": "The URL of the logo representing the NFT protocol" }, "to": { "type": "string", "description": "The address of the recipient in the NFT sale" }, "from": { "type": "string", "description": "The address of the sender in the NFT sale" }, "maker": { "type": "string", "description": "The address of the maker (order creator) in the NFT trade" }, "taker": { "type": "string", "description": "The address of the taker (order fulfiller) in the NFT trade" }, "token_id": { "type": "string", "description": "The unique identifier of the NFT token involved in the sale" }, "collection_address": { "type": "string", "description": "The address of the NFT collection's contract" }, "collection_name": { "type": "string", "description": "The name of the NFT collection" }, "token_address": { "type": "string", "description": "The address of the token used in the sale" }, "token_name": { "type": "string", "description": "The name of the token used in the sale" }, "ticker_symbol": { "type": "string", "description": "The ticker symbol of the token used in the sale" }, "num_decimals": { "type": "integer", "description": "The number of decimal places used by the token" }, "contract_quote_rate": { "type": "integer", "description": "The exchange rate of the token used in the sale, quoted in USD" }, "nft_token_price": { "type": "integer", "description": "The price of the NFT token in the native token" }, "nft_token_price_usd": { "type": "integer", "description": "The price of the NFT token in USD" }, "pretty_nft_token_price_usd": { "type": "string", "description": "A human-readable string representation of the NFT token price in USD" }, "nft_token_price_native": { "type": "integer", "description": "The price of the NFT token in the native blockchain currency" }, "pretty_nft_token_price_native": { "type": "string", "description": "A human-readable string representation of the NFT token price in the native currency" }, "token_count": { "type": "integer", "description": "The number of tokens involved in the NFT sale" }, "num_token_ids_sold_per_sale": { "type": "integer", "description": "The number of unique token IDs sold in a single sale" }, "num_token_ids_sold_per_tx": { "type": "integer", "description": "The number of unique token IDs sold in a single transaction" }, "num_collections_sold_per_sale": { "type": "integer", "description": "The number of NFT collections involved in a single sale" }, "num_collections_sold_per_tx": { "type": "integer", "description": "The number of NFT collections involved in a single transaction" }, "trade_type": { "type": "string", "description": "The type of trade (e.g., primary sale, secondary sale)" }, "trade_group_type": { "type": "string", "description": "The group type of the trade (e.g., batch, single)" } } }, "description": "(Optional) An array containing details of NFT sales associated with the transaction" }, "lending_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "protocol_name": { "type": "string", "description": "The name of the lending protocol involved in the transaction" }, "protocol_address": { "type": "string", "description": "The address of the lending protocol's contract" }, "protocol_logo_url": { "type": "string", "description": "The URL of the lending protocol's logo" }, "version": { "type": "string", "description": "The version of the lending protocol" }, "fork": { "type": "string", "description": "The fork of the lending protocol, if applicable" }, "fork_version": { "type": "string", "description": "The version of the protocol fork, if applicable" }, "event": { "type": "string", "description": "The specific event type associated with the lending transaction" }, "lp_token_name": { "type": "string", "description": "The name of the liquidity provider token" }, "lp_decimals": { "type": "integer", "description": "The number of decimal places for the liquidity provider token" }, "lp_ticker_symbol": { "type": "string", "description": "The ticker symbol for the liquidity provider token" }, "lp_token_address": { "type": "string", "description": "The address of the liquidity provider token contract" }, "lp_token_amount": { "type": "integer", "description": "The amount of liquidity provider tokens involved in the transaction" }, "lp_token_price": { "type": "integer", "description": "The price of the liquidity provider token" }, "exchange_rate": { "type": "integer", "description": "The exchange rate between the liquidity provider token and the underlying asset" }, "exchange_rate_usd": { "type": "integer", "description": "The exchange rate between the liquidity provider token and USD" }, "token_name_in": { "type": "string", "description": "The name of the input token for the lending transaction" }, "token_decimal_in": { "type": "integer", "description": "The number of decimal places for the input token" }, "token_address_in": { "type": "string", "description": "The address of the input token's contract" }, "token_ticker_in": { "type": "string", "description": "The ticker symbol of the input token" }, "token_logo_in": { "type": "string", "description": "The URL of the logo for the input token" }, "token_amount_in": { "type": "integer", "description": "The amount of input tokens involved in the lending transaction" }, "amount_in_usd": { "type": "integer", "description": "The value of the input tokens in USD" }, "pretty_amount_in_usd": { "type": "string", "description": "A human-readable string representation of the input token value in USD" }, "token_name_out": { "type": "string", "description": "The name of the output token for the lending transaction" }, "token_decimals_out": { "type": "integer", "description": "The number of decimal places for the output token" }, "token_address_out": { "type": "string", "description": "The address of the output token's contract" }, "token_ticker_out": { "type": "string", "description": "The ticker symbol of the output token" }, "token_logo_out": { "type": "string", "description": "The URL of the logo for the output token" }, "token_amount_out": { "type": "integer", "description": "The amount of output tokens involved in the lending transaction" }, "amount_out_usd": { "type": "integer", "description": "The value of the output tokens in USD" }, "pretty_amount_out_usd": { "type": "string", "description": "A human-readable string representation of the output token value in USD" }, "borrow_rate_mode": { "type": "integer", "description": "The mode of the borrowing rate (e.g., stable or variable)" }, "borrow_rate": { "type": "integer", "description": "The borrowing rate for the transaction" }, "on_behalf_of": { "type": "string", "description": "The address of the entity on whose behalf the transaction is performed" }, "liquidator": { "type": "string", "description": "The address of the liquidator involved in the lending transaction, if applicable" }, "user": { "type": "string", "description": "The address of the user initiating the lending transaction" } } }, "description": "(Optional) An array of lending details containing information about lending transactions" }, "log_events": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp at which the block containing the log event was signed" }, "block_height": { "type": "integer", "description": "The height of the block containing the log event" }, "tx_offset": { "type": "integer", "description": "The offset of the transaction in the block" }, "log_offset": { "type": "integer", "description": "The offset of the log event within the transaction" }, "tx_hash": { "type": "string", "description": "The hash of the transaction associated with the log event" }, "raw_log_topics": { "type": "string", "description": "A list of string values representing the raw topics for the log event" }, "sender_contract_decimals": { "type": "integer", "description": "The number of decimal places used by the sender's contract" }, "sender_name": { "type": "string", "description": "The name of the sender's contract, if available" }, "sender_contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the sender's contract, if available" }, "sender_address": { "type": "string", "description": "The address of the sender involved in the log event" }, "sender_address_label": { "type": "string", "description": "The label associated with the sender's address, if available" }, "sender_logo_url": { "type": "string", "description": "The URL of the logo for the sender's contract or address" }, "supports_erc": { "type": "string", "description": "A list of string values indicating the supported ERC standards for the sender's contract" }, "sender_factory_address": { "type": "string", "description": "The address of the factory contract that created the sender's contract, if applicable" }, "raw_log_data": { "type": "string", "description": "The raw data of the log event" }, "decoded": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the event associated with the log" }, "signature": { "type": "string", "description": "The signature of the event associated with the log" }, "params": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the parameter" }, "type": { "type": "string", "description": "The data type of the parameter" }, "indexed": { "type": "boolean", "description": "Indicates whether the parameter is indexed in the log" }, "decoded": { "type": "boolean", "description": "Indicates whether the parameter has been decoded" }, "value": { "type": "string", "description": "The value of the parameter" } } }, "description": "An array of parameters associated with the log event" } }, "description": "The decoded object which contains detailed information about the log event" } } }, "description": "(Optional) An array of log events that detail specific occurrences within a transaction" }, "safe_details": { "type": "array", "items": { "type": "object", "properties": { "owner_address": { "type": "string", "description": "The address of the owner associated with the safe" }, "signature": { "type": "string", "description": "The cryptographic signature provided by the owner for safe operations" }, "signature_type": { "type": "string", "description": "The type of cryptographic signature used for the safe" } } }, "description": "(Optional) An array of safe details providing information about the owners and signatures of the safe" } } }, "description": "An array of items" } }, "description": "The response data containing details of the wallet and its token approvals" } } } } } } } } }, "/v1/{chainName}/block_hash/{blockHash}/transactions_v3": { "get": { "operationId": "get_v1_by_chainName_block_hash_by_blockHash_transactions_v3", "summary": "Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting walle", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-block_hash-blockHash-transactions_v3" }, "description": "Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions", "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name for the blockchain network" }, "required": true, "description": "The chain name for the blockchain network" }, { "name": "blockHash", "in": "path", "schema": { "type": "string", "description": "The hash of the block to query" }, "required": true, "description": "The hash of the block to query" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, { "name": "no-logs", "in": "query", "schema": { "type": "boolean", "description": "Flag to exclude logs from the response" }, "description": "Flag to exclude logs from the response" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp indicating when the data was last updated" }, "chain_id": { "type": "integer", "description": "The unique identifier of the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "items": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "block_height": { "type": "integer", "description": "The height of the block in the blockchain" }, "block_hash": { "type": "string", "description": "The unique hash of the block" }, "tx_hash": { "type": "string", "description": "The unique hash of the transaction" }, "tx_offset": { "type": "integer", "description": "The position of the transaction in the block" }, "successful": { "type": "boolean", "description": "Indicates whether the transaction was successful" }, "from_address": { "type": "string", "description": "The address of the transaction sender" }, "miner_address": { "type": "string", "description": "The address of the miner who mined the block" }, "from_address_label": { "type": "string", "description": "A label or name associated with the sender's address, if available" }, "to_address": { "type": "string", "description": "The address of the transaction recipient" }, "to_address_label": { "type": "string", "description": "The label or description associated with the recipient address" }, "value": { "type": "string", "description": "The amount of cryptocurrency transferred in the transaction, expressed as a raw string value" }, "value_quote": { "type": "integer", "description": "The fiat currency equivalent of the transaction value at the time of execution" }, "pretty_value_quote": { "type": "string", "description": "A human-readable string representation of the fiat currency equivalent of the transaction value" }, "gas_metadata": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimal places used by the contract for token calculations" }, "contract_name": { "type": "string", "description": "The name of the contract associated with the transaction" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol representing the contract's token" }, "contract_address": { "type": "string", "description": "The blockchain address of the contract" }, "supports_erc": { "type": "string", "description": "A list of strings specifying the ERC standards supported by the contract, such as ERC20 or ERC721" }, "logo_url": { "type": "string", "description": "A URL pointing to the logo associated with the contract" } }, "description": "The gas metadata object providing details about the gas contract, including its address, name, and token details" }, "gas_offered": { "type": "integer", "description": "The amount of gas that was initially offered for the transaction" }, "gas_spent": { "type": "integer", "description": "The actual amount of gas consumed during the transaction execution" }, "gas_price": { "type": "integer", "description": "The price per unit of gas offered by the sender, typically measured in Gwei" }, "fees_paid": { "type": "string", "description": "The total transaction fees paid, calculated as gas spent multiplied by gas price" }, "gas_quote": { "type": "integer", "description": "The transaction fee expressed in the quoted currency (e.g., USD)" }, "pretty_gas_quote": { "type": "string", "description": "A human-readable representation of the transaction fee in the quoted currency" }, "gas_quote_rate": { "type": "integer", "description": "The exchange rate used to convert gas fees from the native currency to the quoted currency" }, "explorers": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "The name or label of the explorer" }, "url": { "type": "string", "description": "The URL of the blockchain explorer" } } }, "description": "An array containing information about blockchain explorers related to the transaction" }, "dex_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "protocol_name": { "type": "string", "description": "The name of the DEX protocol involved in the transaction" }, "protocol_address": { "type": "string", "description": "The address of the DEX protocol's smart contract" }, "protocol_logo_url": { "type": "string", "description": "The URL of the logo for the DEX protocol" }, "aggregator_name": { "type": "string", "description": "The name of the aggregator involved in the transaction, if applicable" }, "aggregator_address": { "type": "string", "description": "The address of the aggregator's smart contract" }, "version": { "type": "integer", "description": "The version number of the protocol used" }, "fork_version": { "type": "integer", "description": "The fork version of the protocol, if applicable" }, "fork": { "type": "string", "description": "The name of the blockchain fork, if relevant" }, "event": { "type": "string", "description": "The specific event type that occurred in the transaction" }, "pair_address": { "type": "string", "description": "The address of the token pair involved in the transaction" }, "pair_lp_fee_bps": { "type": "integer", "description": "The liquidity provider fee in basis points (bps)" }, "lp_token_address": { "type": "string", "description": "The address of the liquidity pool token" }, "lp_token_ticker": { "type": "string", "description": "The ticker symbol of the liquidity pool token" }, "lp_token_num_decimals": { "type": "integer", "description": "The number of decimals for the liquidity pool token" }, "lp_token_name": { "type": "string", "description": "The name of the liquidity pool token" }, "lp_token_value": { "type": "string", "description": "The value of the liquidity pool token" }, "exchange_rate_usd": { "type": "integer", "description": "The exchange rate in USD for the token pair" }, "token_0_address": { "type": "string", "description": "The address of the first token in the pair" }, "token_0_ticker": { "type": "string", "description": "The ticker symbol of the first token" }, "token_0_num_decimals": { "type": "integer", "description": "The number of decimals for the first token" }, "token_0_name": { "type": "string", "description": "The name of the first token" }, "token_1_address": { "type": "string", "description": "The address of the second token in the pair" }, "token_1_ticker": { "type": "string", "description": "The ticker symbol of the second token" }, "token_1_num_decimals": { "type": "integer", "description": "The number of decimals for the second token" }, "token_1_name": { "type": "string", "description": "The name of the second token" }, "token_0_amount": { "type": "string", "description": "The amount of the first token involved in the transaction" }, "token_0_quote_rate": { "type": "integer", "description": "The quote rate for the first token in USD" }, "token_0_usd_quote": { "type": "integer", "description": "The USD equivalent of the first token amount" }, "pretty_token_0_usd_quote": { "type": "string", "description": "A human-readable USD equivalent of the first token amount" }, "token_0_logo_url": { "type": "string", "description": "The URL of the logo for the first token" }, "token_1_amount": { "type": "string", "description": "The amount of the second token involved in the transaction" }, "token_1_quote_rate": { "type": "integer", "description": "The quote rate for the second token in USD" }, "token_1_usd_quote": { "type": "integer", "description": "The USD equivalent of the second token amount" }, "pretty_token_1_usd_quote": { "type": "string", "description": "A human-readable USD equivalent of the second token amount" }, "token_1_logo_url": { "type": "string", "description": "The URL of the logo for the second token" }, "sender": { "type": "string", "description": "The address of the sender in the transaction" }, "recipient": { "type": "string", "description": "The address of the recipient in the transaction" } } }, "description": "(Optional) An array of details about DEX (Decentralized Exchange) activities related to the transaction" }, "nft_sale_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "topic0": { "type": "string", "description": "The first topic of the event log, typically used for event identification" }, "protocol_contract_address": { "type": "string", "description": "The address of the NFT protocol's contract involved in the sale" }, "protocol_name": { "type": "string", "description": "The name of the NFT protocol facilitating the sale" }, "protocol_logo_url": { "type": "string", "description": "The URL of the logo representing the NFT protocol" }, "to": { "type": "string", "description": "The address of the recipient in the NFT sale" }, "from": { "type": "string", "description": "The address of the sender in the NFT sale" }, "maker": { "type": "string", "description": "The address of the maker (order creator) in the NFT trade" }, "taker": { "type": "string", "description": "The address of the taker (order fulfiller) in the NFT trade" }, "token_id": { "type": "string", "description": "The unique identifier of the NFT token involved in the sale" }, "collection_address": { "type": "string", "description": "The address of the NFT collection's contract" }, "collection_name": { "type": "string", "description": "The name of the NFT collection" }, "token_address": { "type": "string", "description": "The address of the token used in the sale" }, "token_name": { "type": "string", "description": "The name of the token used in the sale" }, "ticker_symbol": { "type": "string", "description": "The ticker symbol of the token used in the sale" }, "num_decimals": { "type": "integer", "description": "The number of decimal places used by the token" }, "contract_quote_rate": { "type": "integer", "description": "The exchange rate of the token used in the sale, quoted in USD" }, "nft_token_price": { "type": "integer", "description": "The price of the NFT token in the native token" }, "nft_token_price_usd": { "type": "integer", "description": "The price of the NFT token in USD" }, "pretty_nft_token_price_usd": { "type": "string", "description": "A human-readable string representation of the NFT token price in USD" }, "nft_token_price_native": { "type": "integer", "description": "The price of the NFT token in the native blockchain currency" }, "pretty_nft_token_price_native": { "type": "string", "description": "A human-readable string representation of the NFT token price in the native currency" }, "token_count": { "type": "integer", "description": "The number of tokens involved in the NFT sale" }, "num_token_ids_sold_per_sale": { "type": "integer", "description": "The number of unique token IDs sold in a single sale" }, "num_token_ids_sold_per_tx": { "type": "integer", "description": "The number of unique token IDs sold in a single transaction" }, "num_collections_sold_per_sale": { "type": "integer", "description": "The number of NFT collections involved in a single sale" }, "num_collections_sold_per_tx": { "type": "integer", "description": "The number of NFT collections involved in a single transaction" }, "trade_type": { "type": "string", "description": "The type of trade (e.g., primary sale, secondary sale)" }, "trade_group_type": { "type": "string", "description": "The group type of the trade (e.g., batch, single)" } } }, "description": "(Optional) An array containing details of NFT sales associated with the transaction" }, "lending_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "protocol_name": { "type": "string", "description": "The name of the lending protocol involved in the transaction" }, "protocol_address": { "type": "string", "description": "The address of the lending protocol's contract" }, "protocol_logo_url": { "type": "string", "description": "The URL of the lending protocol's logo" }, "version": { "type": "string", "description": "The version of the lending protocol" }, "fork": { "type": "string", "description": "The fork of the lending protocol, if applicable" }, "fork_version": { "type": "string", "description": "The version of the protocol fork, if applicable" }, "event": { "type": "string", "description": "The specific event type associated with the lending transaction" }, "lp_token_name": { "type": "string", "description": "The name of the liquidity provider token" }, "lp_decimals": { "type": "integer", "description": "The number of decimal places for the liquidity provider token" }, "lp_ticker_symbol": { "type": "string", "description": "The ticker symbol for the liquidity provider token" }, "lp_token_address": { "type": "string", "description": "The address of the liquidity provider token contract" }, "lp_token_amount": { "type": "integer", "description": "The amount of liquidity provider tokens involved in the transaction" }, "lp_token_price": { "type": "integer", "description": "The price of the liquidity provider token" }, "exchange_rate": { "type": "integer", "description": "The exchange rate between the liquidity provider token and the underlying asset" }, "exchange_rate_usd": { "type": "integer", "description": "The exchange rate between the liquidity provider token and USD" }, "token_name_in": { "type": "string", "description": "The name of the input token for the lending transaction" }, "token_decimal_in": { "type": "integer", "description": "The number of decimal places for the input token" }, "token_address_in": { "type": "string", "description": "The address of the input token's contract" }, "token_ticker_in": { "type": "string", "description": "The ticker symbol of the input token" }, "token_logo_in": { "type": "string", "description": "The URL of the logo for the input token" }, "token_amount_in": { "type": "integer", "description": "The amount of input tokens involved in the lending transaction" }, "amount_in_usd": { "type": "integer", "description": "The value of the input tokens in USD" }, "pretty_amount_in_usd": { "type": "string", "description": "A human-readable string representation of the input token value in USD" }, "token_name_out": { "type": "string", "description": "The name of the output token for the lending transaction" }, "token_decimals_out": { "type": "integer", "description": "The number of decimal places for the output token" }, "token_address_out": { "type": "string", "description": "The address of the output token's contract" }, "token_ticker_out": { "type": "string", "description": "The ticker symbol of the output token" }, "token_logo_out": { "type": "string", "description": "The URL of the logo for the output token" }, "token_amount_out": { "type": "integer", "description": "The amount of output tokens involved in the lending transaction" }, "amount_out_usd": { "type": "integer", "description": "The value of the output tokens in USD" }, "pretty_amount_out_usd": { "type": "string", "description": "A human-readable string representation of the output token value in USD" }, "borrow_rate_mode": { "type": "integer", "description": "The mode of the borrowing rate (e.g., stable or variable)" }, "borrow_rate": { "type": "integer", "description": "The borrowing rate for the transaction" }, "on_behalf_of": { "type": "string", "description": "The address of the entity on whose behalf the transaction is performed" }, "liquidator": { "type": "string", "description": "The address of the liquidator involved in the lending transaction, if applicable" }, "user": { "type": "string", "description": "The address of the user initiating the lending transaction" } } }, "description": "(Optional) An array of lending details containing information about lending transactions" }, "log_events": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp at which the block containing the log event was signed" }, "block_height": { "type": "integer", "description": "The height of the block containing the log event" }, "tx_offset": { "type": "integer", "description": "The offset of the transaction in the block" }, "log_offset": { "type": "integer", "description": "The offset of the log event within the transaction" }, "tx_hash": { "type": "string", "description": "The hash of the transaction associated with the log event" }, "raw_log_topics": { "type": "string", "description": "A list of string values representing the raw topics for the log event" }, "sender_contract_decimals": { "type": "integer", "description": "The number of decimal places used by the sender's contract" }, "sender_name": { "type": "string", "description": "The name of the sender's contract, if available" }, "sender_contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the sender's contract, if available" }, "sender_address": { "type": "string", "description": "The address of the sender involved in the log event" }, "sender_address_label": { "type": "string", "description": "The label associated with the sender's address, if available" }, "sender_logo_url": { "type": "string", "description": "The URL of the logo for the sender's contract or address" }, "supports_erc": { "type": "string", "description": "A list of string values indicating the supported ERC standards for the sender's contract" }, "sender_factory_address": { "type": "string", "description": "The address of the factory contract that created the sender's contract, if applicable" }, "raw_log_data": { "type": "string", "description": "The raw data of the log event" }, "decoded": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the event associated with the log" }, "signature": { "type": "string", "description": "The signature of the event associated with the log" }, "params": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the parameter" }, "type": { "type": "string", "description": "The data type of the parameter" }, "indexed": { "type": "boolean", "description": "Indicates whether the parameter is indexed in the log" }, "decoded": { "type": "boolean", "description": "Indicates whether the parameter has been decoded" }, "value": { "type": "string", "description": "The value of the parameter" } } }, "description": "An array of parameters associated with the log event" } }, "description": "The decoded object which contains detailed information about the log event" } } }, "description": "(Optional) An array of log events that detail specific occurrences within a transaction" }, "safe_details": { "type": "array", "items": { "type": "object", "properties": { "owner_address": { "type": "string", "description": "The address of the owner associated with the safe" }, "signature": { "type": "string", "description": "The cryptographic signature provided by the owner for safe operations" }, "signature_type": { "type": "string", "description": "The type of cryptographic signature used for the safe" } } }, "description": "(Optional) An array of safe details providing information about the owners and signatures of the safe" } } }, "description": "An array of items" } }, "description": "The response data containing details of the wallet and its token approvals" } } } } } } } } }, "/v1/{chainName}/block_v2/{blockHeight}": { "get": { "operationId": "get_v1_by_chainName_block_v2_by_blockHeight", "summary": "Commonly used to fetch and render a single block for a block explorer", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-block_v2-blockHeight" }, "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The name of the blockchain (e.g., base-mainnet)" }, "required": true, "description": "The name of the blockchain (e.g., base-mainnet)" }, { "name": "blockHeight", "in": "path", "schema": { "type": "string", "description": "The height of the specific block to fetch details for" }, "required": true, "description": "The height of the specific block to fetch details for" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "chain_id": { "type": "integer", "description": "The ID of the blockchain chain" }, "chain_name": { "type": "string", "description": "The name of the blockchain chain" }, "items": { "type": "array", "items": { "type": "object", "properties": { "block_hash": { "type": "string", "description": "The hash of the block" }, "signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "height": { "type": "integer", "description": "The height of the block" }, "block_parent_hash": { "type": "string", "description": "The hash of the parent block" }, "extra_data": { "type": "string", "description": "Additional data included in the block" }, "miner_address": { "type": "string", "description": "The address of the miner that mined the block" }, "mining_cost": { "type": "integer", "description": "The cost of mining the block" }, "gas_used": { "type": "integer", "description": "The total gas used in the block" }, "gas_limit": { "type": "integer", "description": "The gas limit of the block" }, "transactions_link": { "type": "string", "description": "The link to view the transactions in the block" } } }, "description": "The array of block items" } }, "description": "The main data of the response" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred" }, "error_code": { "type": "string", "description": "The error code if an error occurred" } } } } } } } } }, "/v1/{chainName}/block_v2/{startDate}/{endDate}": { "get": { "operationId": "get_v1_by_chainName_block_v2_by_startDate_by_endDate", "summary": "Get all the block heights within a particular date range.", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-block_v2-startDate-endDate" }, "description": "Get all the block heights within a particular date range. Useful for rendering a display where you sort blocks by day", "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The blockchain name to query (e.g., base-mainnet, bsc-mainnet)" }, "required": true, "description": "The blockchain name to query (e.g., base-mainnet, bsc-mainnet)" }, { "name": "startDate", "in": "path", "schema": { "type": "string", "description": "The start date for the block query in YYYY-MM-DD format" }, "required": true, "description": "The start date for the block query in YYYY-MM-DD format" }, { "name": "endDate", "in": "path", "schema": { "type": "string", "description": "The end date for the block query in YYYY-MM-DD format" }, "required": true, "description": "The end date for the block query in YYYY-MM-DD format" }, { "name": "page-size", "in": "query", "schema": { "type": "integer", "description": "The number of results to return per page" }, "description": "The number of results to return per page" }, { "name": "page-number", "in": "query", "schema": { "type": "integer", "description": "The page number to retrieve" }, "description": "The page number to retrieve" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp indicating the last update time of the data" }, "chain_id": { "type": "integer", "description": "The unique identifier for the blockchain" }, "chain_name": { "type": "string", "description": "The name of the blockchain (e.g., 'base-mainnet')" }, "items": { "type": "array", "items": { "type": "object", "properties": { "block_hash": { "type": "string", "description": "The unique hash of the block" }, "signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "height": { "type": "integer", "description": "The block height in the blockchain" }, "block_parent_hash": { "type": "string", "description": "The hash of the parent block" }, "extra_data": { "type": "string", "description": "The additional data stored in the block" }, "miner_address": { "type": "string", "description": "The address of the miner who mined the block" }, "mining_cost": { "type": "integer", "description": "The cost of mining the block" }, "gas_used": { "type": "integer", "description": "The gas used in the block" }, "gas_limit": { "type": "integer", "description": "The maximum gas limit for the block" }, "transactions_link": { "type": "string", "description": "The link to the transactions associated with the block" } } }, "description": "The list of block items" }, "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "The flag indicating if there are more pages of data" }, "page_number": { "type": "integer", "description": "The current page number" }, "page_size": { "type": "integer", "description": "The number of items per page" }, "total_count": { "type": "integer", "description": "The total number of items (nullable)" } }, "description": "The pagination details for the response" } }, "description": "The main response data object" }, "error": { "type": "boolean", "description": "The flag indicating if an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred" }, "error_code": { "type": "integer", "description": "The error code if an error occurred" } } } } } } } } }, "/v1/{chainName}/bulk/transactions/{walletAddress}": { "get": { "operationId": "get_v1_by_chainName_bulk_transactions_by_walletAddress", "summary": "Commonly used to fetch and render the earliest transactions involving an address.", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-bulk-transactions-walletAddress" }, "description": "Commonly used to fetch and render the earliest transactions involving an address. Frequently seen in wallet applications", "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name eg: base-mainnet" }, "required": true, "description": "The chain name eg: base-mainnet" }, { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, "required": true, "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, { "name": "no-logs", "in": "query", "schema": { "type": "boolean", "description": "Flag to exclude logs from the response" }, "description": "Flag to exclude logs from the response" }, { "name": "block-signed-at-asc", "in": "query", "schema": { "type": "boolean", "description": "Sort the transactions in ascending chronological order. By default, it's set to false and returns transactions in descending chronological order" }, "description": "Sort the transactions in ascending chronological order. By default, it's set to false and returns transactions in descending chronological order" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "address": { "type": "string", "description": "The wallet address to fetch transaction details for" }, "updated_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "quote_currency": { "type": "string", "description": "The currency used for quoting transaction values" }, "chain_id": { "type": "integer", "description": "The unique identifier for the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "current_page": { "type": "integer", "description": "The current page of the paginated transactions list" }, "links": { "type": "object", "properties": { "prev": { "type": "string", "description": "The URL link to the previous page of the data. Null if no previous page exists" }, "next": { "type": "string", "description": "The URL link to the next page of the data. Null if no next page exists" } }, "description": "An object containing pagination links for navigating through pages of data" }, "items": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "block_height": { "type": "integer", "description": "The height of the block in the blockchain" }, "block_hash": { "type": "string", "description": "The unique hash of the block" }, "tx_hash": { "type": "string", "description": "The unique hash of the transaction" }, "tx_offset": { "type": "integer", "description": "The position of the transaction in the block" }, "successful": { "type": "boolean", "description": "Indicates whether the transaction was successful" }, "from_address": { "type": "string", "description": "The address of the transaction sender" }, "miner_address": { "type": "string", "description": "The address of the miner who mined the block" }, "from_address_label": { "type": "string", "description": "A label or name associated with the sender's address, if available" }, "to_address": { "type": "string", "description": "The address of the transaction recipient" }, "to_address_label": { "type": "string", "description": "The label or description associated with the recipient address" }, "value": { "type": "string", "description": "The amount of cryptocurrency transferred in the transaction, expressed as a raw string value" }, "value_quote": { "type": "integer", "description": "The fiat currency equivalent of the transaction value at the time of execution" }, "pretty_value_quote": { "type": "string", "description": "A human-readable string representation of the fiat currency equivalent of the transaction value" }, "gas_metadata": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimal places used by the contract for token calculations" }, "contract_name": { "type": "string", "description": "The name of the contract associated with the transaction" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol representing the contract's token" }, "contract_address": { "type": "string", "description": "The blockchain address of the contract" }, "supports_erc": { "type": "string", "description": "A list of strings specifying the ERC standards supported by the contract, such as ERC20 or ERC721" }, "logo_url": { "type": "string", "description": "A URL pointing to the logo associated with the contract" } }, "description": "The gas metadata object providing details about the gas contract, including its address, name, and token details" }, "gas_offered": { "type": "integer", "description": "The amount of gas that was initially offered for the transaction" }, "gas_spent": { "type": "integer", "description": "The actual amount of gas consumed during the transaction execution" }, "gas_price": { "type": "integer", "description": "The price per unit of gas offered by the sender, typically measured in Gwei" }, "fees_paid": { "type": "string", "description": "The total transaction fees paid, calculated as gas spent multiplied by gas price" }, "gas_quote": { "type": "integer", "description": "The transaction fee expressed in the quoted currency (e.g., USD)" }, "pretty_gas_quote": { "type": "string", "description": "A human-readable representation of the transaction fee in the quoted currency" }, "gas_quote_rate": { "type": "integer", "description": "The exchange rate used to convert gas fees from the native currency to the quoted currency" }, "explorers": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "The name or label of the explorer" }, "url": { "type": "string", "description": "The URL of the blockchain explorer" } } }, "description": "An array containing information about blockchain explorers related to the transaction" }, "dex_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "protocol_name": { "type": "string", "description": "The name of the DEX protocol involved in the transaction" }, "protocol_address": { "type": "string", "description": "The address of the DEX protocol's smart contract" }, "protocol_logo_url": { "type": "string", "description": "The URL of the logo for the DEX protocol" }, "aggregator_name": { "type": "string", "description": "The name of the aggregator involved in the transaction, if applicable" }, "aggregator_address": { "type": "string", "description": "The address of the aggregator's smart contract" }, "version": { "type": "integer", "description": "The version number of the protocol used" }, "fork_version": { "type": "integer", "description": "The fork version of the protocol, if applicable" }, "fork": { "type": "string", "description": "The name of the blockchain fork, if relevant" }, "event": { "type": "string", "description": "The specific event type that occurred in the transaction" }, "pair_address": { "type": "string", "description": "The address of the token pair involved in the transaction" }, "pair_lp_fee_bps": { "type": "integer", "description": "The liquidity provider fee in basis points (bps)" }, "lp_token_address": { "type": "string", "description": "The address of the liquidity pool token" }, "lp_token_ticker": { "type": "string", "description": "The ticker symbol of the liquidity pool token" }, "lp_token_num_decimals": { "type": "integer", "description": "The number of decimals for the liquidity pool token" }, "lp_token_name": { "type": "string", "description": "The name of the liquidity pool token" }, "lp_token_value": { "type": "string", "description": "The value of the liquidity pool token" }, "exchange_rate_usd": { "type": "integer", "description": "The exchange rate in USD for the token pair" }, "token_0_address": { "type": "string", "description": "The address of the first token in the pair" }, "token_0_ticker": { "type": "string", "description": "The ticker symbol of the first token" }, "token_0_num_decimals": { "type": "integer", "description": "The number of decimals for the first token" }, "token_0_name": { "type": "string", "description": "The name of the first token" }, "token_1_address": { "type": "string", "description": "The address of the second token in the pair" }, "token_1_ticker": { "type": "string", "description": "The ticker symbol of the second token" }, "token_1_num_decimals": { "type": "integer", "description": "The number of decimals for the second token" }, "token_1_name": { "type": "string", "description": "The name of the second token" }, "token_0_amount": { "type": "string", "description": "The amount of the first token involved in the transaction" }, "token_0_quote_rate": { "type": "integer", "description": "The quote rate for the first token in USD" }, "token_0_usd_quote": { "type": "integer", "description": "The USD equivalent of the first token amount" }, "pretty_token_0_usd_quote": { "type": "string", "description": "A human-readable USD equivalent of the first token amount" }, "token_0_logo_url": { "type": "string", "description": "The URL of the logo for the first token" }, "token_1_amount": { "type": "string", "description": "The amount of the second token involved in the transaction" }, "token_1_quote_rate": { "type": "integer", "description": "The quote rate for the second token in USD" }, "token_1_usd_quote": { "type": "integer", "description": "The USD equivalent of the second token amount" }, "pretty_token_1_usd_quote": { "type": "string", "description": "A human-readable USD equivalent of the second token amount" }, "token_1_logo_url": { "type": "string", "description": "The URL of the logo for the second token" }, "sender": { "type": "string", "description": "The address of the sender in the transaction" }, "recipient": { "type": "string", "description": "The address of the recipient in the transaction" } } }, "description": "(Optional) An array of details about DEX (Decentralized Exchange) activities related to the transaction" }, "nft_sale_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "topic0": { "type": "string", "description": "The first topic of the event log, typically used for event identification" }, "protocol_contract_address": { "type": "string", "description": "The address of the NFT protocol's contract involved in the sale" }, "protocol_name": { "type": "string", "description": "The name of the NFT protocol facilitating the sale" }, "protocol_logo_url": { "type": "string", "description": "The URL of the logo representing the NFT protocol" }, "to": { "type": "string", "description": "The address of the recipient in the NFT sale" }, "from": { "type": "string", "description": "The address of the sender in the NFT sale" }, "maker": { "type": "string", "description": "The address of the maker (order creator) in the NFT trade" }, "taker": { "type": "string", "description": "The address of the taker (order fulfiller) in the NFT trade" }, "token_id": { "type": "string", "description": "The unique identifier of the NFT token involved in the sale" }, "collection_address": { "type": "string", "description": "The address of the NFT collection's contract" }, "collection_name": { "type": "string", "description": "The name of the NFT collection" }, "token_address": { "type": "string", "description": "The address of the token used in the sale" }, "token_name": { "type": "string", "description": "The name of the token used in the sale" }, "ticker_symbol": { "type": "string", "description": "The ticker symbol of the token used in the sale" }, "num_decimals": { "type": "integer", "description": "The number of decimal places used by the token" }, "contract_quote_rate": { "type": "integer", "description": "The exchange rate of the token used in the sale, quoted in USD" }, "nft_token_price": { "type": "integer", "description": "The price of the NFT token in the native token" }, "nft_token_price_usd": { "type": "integer", "description": "The price of the NFT token in USD" }, "pretty_nft_token_price_usd": { "type": "string", "description": "A human-readable string representation of the NFT token price in USD" }, "nft_token_price_native": { "type": "integer", "description": "The price of the NFT token in the native blockchain currency" }, "pretty_nft_token_price_native": { "type": "string", "description": "A human-readable string representation of the NFT token price in the native currency" }, "token_count": { "type": "integer", "description": "The number of tokens involved in the NFT sale" }, "num_token_ids_sold_per_sale": { "type": "integer", "description": "The number of unique token IDs sold in a single sale" }, "num_token_ids_sold_per_tx": { "type": "integer", "description": "The number of unique token IDs sold in a single transaction" }, "num_collections_sold_per_sale": { "type": "integer", "description": "The number of NFT collections involved in a single sale" }, "num_collections_sold_per_tx": { "type": "integer", "description": "The number of NFT collections involved in a single transaction" }, "trade_type": { "type": "string", "description": "The type of trade (e.g., primary sale, secondary sale)" }, "trade_group_type": { "type": "string", "description": "The group type of the trade (e.g., batch, single)" } } }, "description": "(Optional) An array containing details of NFT sales associated with the transaction" }, "lending_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "protocol_name": { "type": "string", "description": "The name of the lending protocol involved in the transaction" }, "protocol_address": { "type": "string", "description": "The address of the lending protocol's contract" }, "protocol_logo_url": { "type": "string", "description": "The URL of the lending protocol's logo" }, "version": { "type": "string", "description": "The version of the lending protocol" }, "fork": { "type": "string", "description": "The fork of the lending protocol, if applicable" }, "fork_version": { "type": "string", "description": "The version of the protocol fork, if applicable" }, "event": { "type": "string", "description": "The specific event type associated with the lending transaction" }, "lp_token_name": { "type": "string", "description": "The name of the liquidity provider token" }, "lp_decimals": { "type": "integer", "description": "The number of decimal places for the liquidity provider token" }, "lp_ticker_symbol": { "type": "string", "description": "The ticker symbol for the liquidity provider token" }, "lp_token_address": { "type": "string", "description": "The address of the liquidity provider token contract" }, "lp_token_amount": { "type": "integer", "description": "The amount of liquidity provider tokens involved in the transaction" }, "lp_token_price": { "type": "integer", "description": "The price of the liquidity provider token" }, "exchange_rate": { "type": "integer", "description": "The exchange rate between the liquidity provider token and the underlying asset" }, "exchange_rate_usd": { "type": "integer", "description": "The exchange rate between the liquidity provider token and USD" }, "token_name_in": { "type": "string", "description": "The name of the input token for the lending transaction" }, "token_decimal_in": { "type": "integer", "description": "The number of decimal places for the input token" }, "token_address_in": { "type": "string", "description": "The address of the input token's contract" }, "token_ticker_in": { "type": "string", "description": "The ticker symbol of the input token" }, "token_logo_in": { "type": "string", "description": "The URL of the logo for the input token" }, "token_amount_in": { "type": "integer", "description": "The amount of input tokens involved in the lending transaction" }, "amount_in_usd": { "type": "integer", "description": "The value of the input tokens in USD" }, "pretty_amount_in_usd": { "type": "string", "description": "A human-readable string representation of the input token value in USD" }, "token_name_out": { "type": "string", "description": "The name of the output token for the lending transaction" }, "token_decimals_out": { "type": "integer", "description": "The number of decimal places for the output token" }, "token_address_out": { "type": "string", "description": "The address of the output token's contract" }, "token_ticker_out": { "type": "string", "description": "The ticker symbol of the output token" }, "token_logo_out": { "type": "string", "description": "The URL of the logo for the output token" }, "token_amount_out": { "type": "integer", "description": "The amount of output tokens involved in the lending transaction" }, "amount_out_usd": { "type": "integer", "description": "The value of the output tokens in USD" }, "pretty_amount_out_usd": { "type": "string", "description": "A human-readable string representation of the output token value in USD" }, "borrow_rate_mode": { "type": "integer", "description": "The mode of the borrowing rate (e.g., stable or variable)" }, "borrow_rate": { "type": "integer", "description": "The borrowing rate for the transaction" }, "on_behalf_of": { "type": "string", "description": "The address of the entity on whose behalf the transaction is performed" }, "liquidator": { "type": "string", "description": "The address of the liquidator involved in the lending transaction, if applicable" }, "user": { "type": "string", "description": "The address of the user initiating the lending transaction" } } }, "description": "(Optional) An array of lending details containing information about lending transactions" }, "log_events": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp at which the block containing the log event was signed" }, "block_height": { "type": "integer", "description": "The height of the block containing the log event" }, "tx_offset": { "type": "integer", "description": "The offset of the transaction in the block" }, "log_offset": { "type": "integer", "description": "The offset of the log event within the transaction" }, "tx_hash": { "type": "string", "description": "The hash of the transaction associated with the log event" }, "raw_log_topics": { "type": "string", "description": "A list of string values representing the raw topics for the log event" }, "sender_contract_decimals": { "type": "integer", "description": "The number of decimal places used by the sender's contract" }, "sender_name": { "type": "string", "description": "The name of the sender's contract, if available" }, "sender_contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the sender's contract, if available" }, "sender_address": { "type": "string", "description": "The address of the sender involved in the log event" }, "sender_address_label": { "type": "string", "description": "The label associated with the sender's address, if available" }, "sender_logo_url": { "type": "string", "description": "The URL of the logo for the sender's contract or address" }, "supports_erc": { "type": "string", "description": "A list of string values indicating the supported ERC standards for the sender's contract" }, "sender_factory_address": { "type": "string", "description": "The address of the factory contract that created the sender's contract, if applicable" }, "raw_log_data": { "type": "string", "description": "The raw data of the log event" }, "decoded": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the event associated with the log" }, "signature": { "type": "string", "description": "The signature of the event associated with the log" }, "params": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the parameter" }, "type": { "type": "string", "description": "The data type of the parameter" }, "indexed": { "type": "boolean", "description": "Indicates whether the parameter is indexed in the log" }, "decoded": { "type": "boolean", "description": "Indicates whether the parameter has been decoded" }, "value": { "type": "string", "description": "The value of the parameter" } } }, "description": "An array of parameters associated with the log event" } }, "description": "The decoded object which contains detailed information about the log event" } } }, "description": "(Optional) An array of log events that detail specific occurrences within a transaction" }, "safe_details": { "type": "array", "items": { "type": "object", "properties": { "owner_address": { "type": "string", "description": "The address of the owner associated with the safe" }, "signature": { "type": "string", "description": "The cryptographic signature provided by the owner for safe operations" }, "signature_type": { "type": "string", "description": "The type of cryptographic signature used for the safe" } } }, "description": "(Optional) An array of safe details providing information about the owners and signatures of the safe" } } }, "description": "An array of items" } }, "description": "The response data containing details of the wallet and its token approvals" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred, or null otherwise" }, "error_code": { "type": "string", "description": "The error code if an error occurred, or null otherwise" } } } } } } } } }, "/v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}": { "get": { "operationId": "get_v1_by_chainName_bulk_transactions_by_walletAddress_by_timeBucket", "summary": "Commonly used to fetch all transactions including their decoded log events in a 15-minute time bucket interval", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-bulk-transactions-walletAddress-timeBucket" }, "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name eg: base-mainnet" }, "required": true, "description": "The chain name eg: base-mainnet" }, { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, "required": true, "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, { "name": "timeBucket", "in": "path", "schema": { "type": "integer", "description": "The 0-indexed 15-minute time bucket. E.g. 27 Feb 2023 05:23 GMT = 1677475383 (Unix time). 1677475383/900=1863861 timeBucket" }, "required": true, "description": "The 0-indexed 15-minute time bucket. E.g. 27 Feb 2023 05:23 GMT = 1677475383 (Unix time). 1677475383/900=1863861 timeBucket" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, { "name": "no-logs", "in": "query", "schema": { "type": "boolean", "description": "Flag to exclude logs from the response" }, "description": "Flag to exclude logs from the response" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp indicating when the data was last updated" }, "chain_id": { "type": "integer", "description": "The unique identifier of the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "links": { "type": "object", "properties": { "prev": { "type": "string", "description": "The URL link to the previous page of the data. Null if no previous page exists" }, "next": { "type": "string", "description": "The URL link to the next page of the data. Null if no next page exists" } }, "description": "An object containing pagination links for navigating through pages of data" }, "items": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "block_height": { "type": "integer", "description": "The height of the block in the blockchain" }, "block_hash": { "type": "string", "description": "The unique hash of the block" }, "tx_hash": { "type": "string", "description": "The unique hash of the transaction" }, "tx_offset": { "type": "integer", "description": "The position of the transaction in the block" }, "successful": { "type": "boolean", "description": "Indicates whether the transaction was successful" }, "from_address": { "type": "string", "description": "The address of the transaction sender" }, "miner_address": { "type": "string", "description": "The address of the miner who mined the block" }, "from_address_label": { "type": "string", "description": "A label or name associated with the sender's address, if available" }, "to_address": { "type": "string", "description": "The address of the transaction recipient" }, "to_address_label": { "type": "string", "description": "The label or description associated with the recipient address" }, "value": { "type": "string", "description": "The amount of cryptocurrency transferred in the transaction, expressed as a raw string value" }, "value_quote": { "type": "integer", "description": "The fiat currency equivalent of the transaction value at the time of execution" }, "pretty_value_quote": { "type": "string", "description": "A human-readable string representation of the fiat currency equivalent of the transaction value" }, "gas_metadata": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimal places used by the contract for token calculations" }, "contract_name": { "type": "string", "description": "The name of the contract associated with the transaction" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol representing the contract's token" }, "contract_address": { "type": "string", "description": "The blockchain address of the contract" }, "supports_erc": { "type": "string", "description": "A list of strings specifying the ERC standards supported by the contract, such as ERC20 or ERC721" }, "logo_url": { "type": "string", "description": "A URL pointing to the logo associated with the contract" } }, "description": "The gas metadata object providing details about the gas contract, including its address, name, and token details" }, "gas_offered": { "type": "integer", "description": "The amount of gas that was initially offered for the transaction" }, "gas_spent": { "type": "integer", "description": "The actual amount of gas consumed during the transaction execution" }, "gas_price": { "type": "integer", "description": "The price per unit of gas offered by the sender, typically measured in Gwei" }, "fees_paid": { "type": "string", "description": "The total transaction fees paid, calculated as gas spent multiplied by gas price" }, "gas_quote": { "type": "integer", "description": "The transaction fee expressed in the quoted currency (e.g., USD)" }, "pretty_gas_quote": { "type": "string", "description": "A human-readable representation of the transaction fee in the quoted currency" }, "gas_quote_rate": { "type": "integer", "description": "The exchange rate used to convert gas fees from the native currency to the quoted currency" }, "explorers": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "The name or label of the explorer" }, "url": { "type": "string", "description": "The URL of the blockchain explorer" } } }, "description": "An array containing information about blockchain explorers related to the transaction" }, "dex_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "protocol_name": { "type": "string", "description": "The name of the DEX protocol involved in the transaction" }, "protocol_address": { "type": "string", "description": "The address of the DEX protocol's smart contract" }, "protocol_logo_url": { "type": "string", "description": "The URL of the logo for the DEX protocol" }, "aggregator_name": { "type": "string", "description": "The name of the aggregator involved in the transaction, if applicable" }, "aggregator_address": { "type": "string", "description": "The address of the aggregator's smart contract" }, "version": { "type": "integer", "description": "The version number of the protocol used" }, "fork_version": { "type": "integer", "description": "The fork version of the protocol, if applicable" }, "fork": { "type": "string", "description": "The name of the blockchain fork, if relevant" }, "event": { "type": "string", "description": "The specific event type that occurred in the transaction" }, "pair_address": { "type": "string", "description": "The address of the token pair involved in the transaction" }, "pair_lp_fee_bps": { "type": "integer", "description": "The liquidity provider fee in basis points (bps)" }, "lp_token_address": { "type": "string", "description": "The address of the liquidity pool token" }, "lp_token_ticker": { "type": "string", "description": "The ticker symbol of the liquidity pool token" }, "lp_token_num_decimals": { "type": "integer", "description": "The number of decimals for the liquidity pool token" }, "lp_token_name": { "type": "string", "description": "The name of the liquidity pool token" }, "lp_token_value": { "type": "string", "description": "The value of the liquidity pool token" }, "exchange_rate_usd": { "type": "integer", "description": "The exchange rate in USD for the token pair" }, "token_0_address": { "type": "string", "description": "The address of the first token in the pair" }, "token_0_ticker": { "type": "string", "description": "The ticker symbol of the first token" }, "token_0_num_decimals": { "type": "integer", "description": "The number of decimals for the first token" }, "token_0_name": { "type": "string", "description": "The name of the first token" }, "token_1_address": { "type": "string", "description": "The address of the second token in the pair" }, "token_1_ticker": { "type": "string", "description": "The ticker symbol of the second token" }, "token_1_num_decimals": { "type": "integer", "description": "The number of decimals for the second token" }, "token_1_name": { "type": "string", "description": "The name of the second token" }, "token_0_amount": { "type": "string", "description": "The amount of the first token involved in the transaction" }, "token_0_quote_rate": { "type": "integer", "description": "The quote rate for the first token in USD" }, "token_0_usd_quote": { "type": "integer", "description": "The USD equivalent of the first token amount" }, "pretty_token_0_usd_quote": { "type": "string", "description": "A human-readable USD equivalent of the first token amount" }, "token_0_logo_url": { "type": "string", "description": "The URL of the logo for the first token" }, "token_1_amount": { "type": "string", "description": "The amount of the second token involved in the transaction" }, "token_1_quote_rate": { "type": "integer", "description": "The quote rate for the second token in USD" }, "token_1_usd_quote": { "type": "integer", "description": "The USD equivalent of the second token amount" }, "pretty_token_1_usd_quote": { "type": "string", "description": "A human-readable USD equivalent of the second token amount" }, "token_1_logo_url": { "type": "string", "description": "The URL of the logo for the second token" }, "sender": { "type": "string", "description": "The address of the sender in the transaction" }, "recipient": { "type": "string", "description": "The address of the recipient in the transaction" } } }, "description": "(Optional) An array of details about DEX (Decentralized Exchange) activities related to the transaction" }, "nft_sale_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "topic0": { "type": "string", "description": "The first topic of the event log, typically used for event identification" }, "protocol_contract_address": { "type": "string", "description": "The address of the NFT protocol's contract involved in the sale" }, "protocol_name": { "type": "string", "description": "The name of the NFT protocol facilitating the sale" }, "protocol_logo_url": { "type": "string", "description": "The URL of the logo representing the NFT protocol" }, "to": { "type": "string", "description": "The address of the recipient in the NFT sale" }, "from": { "type": "string", "description": "The address of the sender in the NFT sale" }, "maker": { "type": "string", "description": "The address of the maker (order creator) in the NFT trade" }, "taker": { "type": "string", "description": "The address of the taker (order fulfiller) in the NFT trade" }, "token_id": { "type": "string", "description": "The unique identifier of the NFT token involved in the sale" }, "collection_address": { "type": "string", "description": "The address of the NFT collection's contract" }, "collection_name": { "type": "string", "description": "The name of the NFT collection" }, "token_address": { "type": "string", "description": "The address of the token used in the sale" }, "token_name": { "type": "string", "description": "The name of the token used in the sale" }, "ticker_symbol": { "type": "string", "description": "The ticker symbol of the token used in the sale" }, "num_decimals": { "type": "integer", "description": "The number of decimal places used by the token" }, "contract_quote_rate": { "type": "integer", "description": "The exchange rate of the token used in the sale, quoted in USD" }, "nft_token_price": { "type": "integer", "description": "The price of the NFT token in the native token" }, "nft_token_price_usd": { "type": "integer", "description": "The price of the NFT token in USD" }, "pretty_nft_token_price_usd": { "type": "string", "description": "A human-readable string representation of the NFT token price in USD" }, "nft_token_price_native": { "type": "integer", "description": "The price of the NFT token in the native blockchain currency" }, "pretty_nft_token_price_native": { "type": "string", "description": "A human-readable string representation of the NFT token price in the native currency" }, "token_count": { "type": "integer", "description": "The number of tokens involved in the NFT sale" }, "num_token_ids_sold_per_sale": { "type": "integer", "description": "The number of unique token IDs sold in a single sale" }, "num_token_ids_sold_per_tx": { "type": "integer", "description": "The number of unique token IDs sold in a single transaction" }, "num_collections_sold_per_sale": { "type": "integer", "description": "The number of NFT collections involved in a single sale" }, "num_collections_sold_per_tx": { "type": "integer", "description": "The number of NFT collections involved in a single transaction" }, "trade_type": { "type": "string", "description": "The type of trade (e.g., primary sale, secondary sale)" }, "trade_group_type": { "type": "string", "description": "The group type of the trade (e.g., batch, single)" } } }, "description": "(Optional) An array containing details of NFT sales associated with the transaction" }, "lending_details": { "type": "array", "items": { "type": "object", "properties": { "log_offset": { "type": "integer", "description": "The offset of the log entry in the block" }, "protocol_name": { "type": "string", "description": "The name of the lending protocol involved in the transaction" }, "protocol_address": { "type": "string", "description": "The address of the lending protocol's contract" }, "protocol_logo_url": { "type": "string", "description": "The URL of the lending protocol's logo" }, "version": { "type": "string", "description": "The version of the lending protocol" }, "fork": { "type": "string", "description": "The fork of the lending protocol, if applicable" }, "fork_version": { "type": "string", "description": "The version of the protocol fork, if applicable" }, "event": { "type": "string", "description": "The specific event type associated with the lending transaction" }, "lp_token_name": { "type": "string", "description": "The name of the liquidity provider token" }, "lp_decimals": { "type": "integer", "description": "The number of decimal places for the liquidity provider token" }, "lp_ticker_symbol": { "type": "string", "description": "The ticker symbol for the liquidity provider token" }, "lp_token_address": { "type": "string", "description": "The address of the liquidity provider token contract" }, "lp_token_amount": { "type": "integer", "description": "The amount of liquidity provider tokens involved in the transaction" }, "lp_token_price": { "type": "integer", "description": "The price of the liquidity provider token" }, "exchange_rate": { "type": "integer", "description": "The exchange rate between the liquidity provider token and the underlying asset" }, "exchange_rate_usd": { "type": "integer", "description": "The exchange rate between the liquidity provider token and USD" }, "token_name_in": { "type": "string", "description": "The name of the input token for the lending transaction" }, "token_decimal_in": { "type": "integer", "description": "The number of decimal places for the input token" }, "token_address_in": { "type": "string", "description": "The address of the input token's contract" }, "token_ticker_in": { "type": "string", "description": "The ticker symbol of the input token" }, "token_logo_in": { "type": "string", "description": "The URL of the logo for the input token" }, "token_amount_in": { "type": "integer", "description": "The amount of input tokens involved in the lending transaction" }, "amount_in_usd": { "type": "integer", "description": "The value of the input tokens in USD" }, "pretty_amount_in_usd": { "type": "string", "description": "A human-readable string representation of the input token value in USD" }, "token_name_out": { "type": "string", "description": "The name of the output token for the lending transaction" }, "token_decimals_out": { "type": "integer", "description": "The number of decimal places for the output token" }, "token_address_out": { "type": "string", "description": "The address of the output token's contract" }, "token_ticker_out": { "type": "string", "description": "The ticker symbol of the output token" }, "token_logo_out": { "type": "string", "description": "The URL of the logo for the output token" }, "token_amount_out": { "type": "integer", "description": "The amount of output tokens involved in the lending transaction" }, "amount_out_usd": { "type": "integer", "description": "The value of the output tokens in USD" }, "pretty_amount_out_usd": { "type": "string", "description": "A human-readable string representation of the output token value in USD" }, "borrow_rate_mode": { "type": "integer", "description": "The mode of the borrowing rate (e.g., stable or variable)" }, "borrow_rate": { "type": "integer", "description": "The borrowing rate for the transaction" }, "on_behalf_of": { "type": "string", "description": "The address of the entity on whose behalf the transaction is performed" }, "liquidator": { "type": "string", "description": "The address of the liquidator involved in the lending transaction, if applicable" }, "user": { "type": "string", "description": "The address of the user initiating the lending transaction" } } }, "description": "(Optional) An array of lending details containing information about lending transactions" }, "log_events": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp at which the block containing the log event was signed" }, "block_height": { "type": "integer", "description": "The height of the block containing the log event" }, "tx_offset": { "type": "integer", "description": "The offset of the transaction in the block" }, "log_offset": { "type": "integer", "description": "The offset of the log event within the transaction" }, "tx_hash": { "type": "string", "description": "The hash of the transaction associated with the log event" }, "raw_log_topics": { "type": "string", "description": "A list of string values representing the raw topics for the log event" }, "sender_contract_decimals": { "type": "integer", "description": "The number of decimal places used by the sender's contract" }, "sender_name": { "type": "string", "description": "The name of the sender's contract, if available" }, "sender_contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the sender's contract, if available" }, "sender_address": { "type": "string", "description": "The address of the sender involved in the log event" }, "sender_address_label": { "type": "string", "description": "The label associated with the sender's address, if available" }, "sender_logo_url": { "type": "string", "description": "The URL of the logo for the sender's contract or address" }, "supports_erc": { "type": "string", "description": "A list of string values indicating the supported ERC standards for the sender's contract" }, "sender_factory_address": { "type": "string", "description": "The address of the factory contract that created the sender's contract, if applicable" }, "raw_log_data": { "type": "string", "description": "The raw data of the log event" }, "decoded": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the event associated with the log" }, "signature": { "type": "string", "description": "The signature of the event associated with the log" }, "params": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the parameter" }, "type": { "type": "string", "description": "The data type of the parameter" }, "indexed": { "type": "boolean", "description": "Indicates whether the parameter is indexed in the log" }, "decoded": { "type": "boolean", "description": "Indicates whether the parameter has been decoded" }, "value": { "type": "string", "description": "The value of the parameter" } } }, "description": "An array of parameters associated with the log event" } }, "description": "The decoded object which contains detailed information about the log event" } } }, "description": "(Optional) An array of log events that detail specific occurrences within a transaction" }, "safe_details": { "type": "array", "items": { "type": "object", "properties": { "owner_address": { "type": "string", "description": "The address of the owner associated with the safe" }, "signature": { "type": "string", "description": "The cryptographic signature provided by the owner for safe operations" }, "signature_type": { "type": "string", "description": "The type of cryptographic signature used for the safe" } } }, "description": "(Optional) An array of safe details providing information about the owners and signatures of the safe" } } }, "description": "An array of items" } }, "description": "The response data containing details of the wallet and its token approvals" } } } } } } } } }, "/v1/{chainName}/event/{eventType}/gas_prices": { "get": { "operationId": "get_v1_by_chainName_event_by_eventType_gas_prices", "summary": "Get real-time gas estimates for different transaction speeds on a specific network, enabling users to optimize transacti", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-event-eventType-gas_prices" }, "description": "Get real-time gas estimates for different transaction speeds on a specific network, enabling users to optimize transaction costs and confirmation times", "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The blockchain name for which data is being queried (e.g., base-mainnet, bsc)" }, "required": true, "description": "The blockchain name for which data is being queried (e.g., base-mainnet, bsc)" }, { "name": "eventType", "in": "path", "schema": { "type": "string", "description": "The type of event being queried. Supports erc20 transfer events, uniswapv3 swap events and nativetokens transfers" }, "required": true, "description": "The type of event being queried. Supports erc20 transfer events, uniswapv3 swap events and nativetokens transfers" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp of the last update in ISO 8601 format" }, "chain_id": { "type": "integer", "description": "The unique identifier for the blockchain (e.g., 1 for Ethereum)" }, "chain_name": { "type": "string", "description": "The name of the blockchain (e.g., base-mainnet)" }, "event_type": { "type": "string", "description": "The type of event queried (e.g., uniswapv3)" }, "gas_quote_rate": { "type": "integer", "description": "The gas price in the quoted currency" }, "quote_currency": { "type": "string", "description": "The currency in which gas prices are quoted (e.g., USD)" }, "base_fee": { "type": "string", "description": "The base fee for gas in wei" }, "items": { "type": "array", "items": { "type": "object", "properties": { "gas_price": { "type": "string", "description": "The gas price in wei for the specific interval" }, "gas_spent": { "type": "string", "description": "The amount of gas spent during the specific interval" }, "gas_quote": { "type": "integer", "description": "The cost of the gas in the quoted currency" }, "other_fees": { "type": "object", "properties": { "l1_gas_quote": { "type": "string", "description": "The Layer 1 gas quote, if applicable" } }, "description": "Additional fees incurred during the transaction" }, "total_gas_quote": { "type": "integer", "description": "The total cost of gas in the quoted currency" }, "pretty_total_gas_quote": { "type": "string", "description": "The total gas cost in a human-readable format" }, "interval": { "type": "string", "description": "The time interval for which the gas price data applies" } } }, "description": "An array of gas price details for specific intervals" } }, "description": "The main response object containing gas price details and metadata" }, "error": { "type": "boolean", "description": "Indicates whether there was an error in the response" }, "error_message": { "type": "string", "description": "The error message, if any" }, "error_code": { "type": "integer", "description": "The error code, if any" } } } } } } } } }, "/v1/{chainName}/events": { "get": { "operationId": "get_v1_by_chainName_events", "summary": "Commonly used to get all the event logs of the latest block, or for a range of blocks.", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-events" }, "description": "Commonly used to get all the event logs of the latest block, or for a range of blocks. Includes sender contract metadata as well as decoded logs", "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The name of the blockchain, e.g., base-mainnet" }, "required": true, "description": "The name of the blockchain, e.g., base-mainnet" }, { "name": "starting-block", "in": "query", "schema": { "type": "integer", "description": "The starting block number for the query" }, "description": "The starting block number for the query" }, { "name": "ending-block", "in": "query", "schema": { "type": "string", "description": "The ending block number for the query" }, "description": "The ending block number for the query" }, { "name": "address", "in": "query", "schema": { "type": "string", "description": "The blockchain address to filter events for" }, "description": "The blockchain address to filter events for" }, { "name": "topics", "in": "query", "schema": { "type": "string", "description": "The event topics to filter the logs" }, "description": "The event topics to filter the logs" }, { "name": "block-hash", "in": "query", "schema": { "type": "string", "description": "The block hash to filter logs by" }, "description": "The block hash to filter logs by" }, { "name": "skip-decode", "in": "query", "schema": { "type": "boolean", "description": "The option to skip decoding the log data" }, "description": "The option to skip decoding the log data" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp of the latest update" }, "chain_id": { "type": "integer", "description": "The unique ID of the blockchain" }, "chain_name": { "type": "string", "description": "The name of the blockchain (e.g., base-mainnet)" }, "items": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "block_height": { "type": "integer", "description": "The height of the block" }, "tx_offset": { "type": "integer", "description": "The transaction offset within the block" }, "log_offset": { "type": "integer", "description": "The log offset within the transaction" }, "tx_hash": { "type": "string", "description": "The transaction hash associated with the log" }, "raw_log_topics": { "type": "array", "items": {}, "description": "The raw log topics of the transaction" }, "sender_contract_decimals": { "type": "integer", "description": "The decimal precision of the sender contract" }, "sender_name": { "type": "string", "description": "The name of the sender contract" }, "sender_contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the sender contract" }, "sender_address": { "type": "string", "description": "The address of the sender" }, "sender_address_label": { "type": "string", "description": "The label associated with the sender address, if any" }, "sender_logo_url": { "type": "string", "description": "The URL of the sender's logo" }, "supports_erc": { "type": "array", "items": {}, "description": "The list of supported ERC standards" }, "sender_factory_address": { "type": "string", "description": "The factory address of the sender, if applicable" }, "raw_log_data": { "type": "string", "description": "The raw data of the log" }, "decoded": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the decoded event" }, "signature": { "type": "string", "description": "The event signature of the decoded log" }, "params": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the parameter" }, "type": { "type": "string", "description": "The data type of the parameter" }, "indexed": { "type": "boolean", "description": "Indicates whether the parameter is indexed" }, "decoded": { "type": "boolean", "description": "Indicates whether the parameter value is decoded" }, "value": { "type": "string", "description": "The value of the parameter" } } }, "description": "The list of parameters in the decoded event" } }, "description": "The decoded log data" } } }, "description": "The list of transaction log items in the block" }, "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "Indicates if there are more pages available" }, "page_number": { "type": "integer", "description": "The current page number" }, "page_size": { "type": "integer", "description": "The number of items per page" }, "total_count": { "type": "integer", "description": "The total number of items, if available" } }, "description": "Pagination details of the response" } }, "description": "The main container for API response data" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred, or null otherwise" }, "error_code": { "type": "string", "description": "The error code if an error occurred, or null otherwise" } } } } } } } } }, "/v1/{chainName}/events/topics/{topicHash}": { "get": { "operationId": "get_v1_by_chainName_events_topics_by_topicHash", "summary": "Commonly used to get all event logs of the same topic hash across all contracts within a particular chain.", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-events-topics-topicHash" }, "description": "Commonly used to get all event logs of the same topic hash across all contracts within a particular chain. Useful for cross-sectional analysis of event logs that are emitted on-chain", "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The name of the blockchain to query" }, "required": true, "description": "The name of the blockchain to query" }, { "name": "topicHash", "in": "path", "schema": { "type": "string", "description": "The topic hash for which to query event logs" }, "required": true, "description": "The topic hash for which to query event logs" }, { "name": "starting-block", "in": "query", "schema": { "type": "integer", "description": "The starting block number for the query" }, "description": "The starting block number for the query" }, { "name": "ending-block", "in": "query", "schema": { "type": "string", "description": "The ending block number for the query" }, "description": "The ending block number for the query" }, { "name": "secondary-topics", "in": "query", "schema": { "type": "string", "description": "The secondary topic hashes to filter the events" }, "description": "The secondary topic hashes to filter the events" }, { "name": "page-size", "in": "query", "schema": { "type": "integer", "description": "The number of items to return per page" }, "description": "The number of items to return per page" }, { "name": "page-number", "in": "query", "schema": { "type": "integer", "description": "The page number to retrieve" }, "description": "The page number to retrieve" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp of the last update for this data" }, "chain_id": { "type": "integer", "description": "The ID of the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain" }, "items": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "block_height": { "type": "integer", "description": "The height of the block" }, "tx_offset": { "type": "integer", "description": "The offset of the transaction in the block" }, "log_offset": { "type": "integer", "description": "The offset of the log within the transaction" }, "tx_hash": { "type": "string", "description": "The transaction hash associated with the log" }, "raw_log_topics": { "type": "array", "items": {}, "description": "The raw log topics for the event" }, "sender_contract_decimals": { "type": "integer", "description": "The number of decimals for the sender contract (if applicable)" }, "sender_name": { "type": "string", "description": "The name of the sender contract" }, "sender_contract_ticker_symbol": { "type": "string", "description": "The ticker symbol for the sender contract" }, "sender_address": { "type": "string", "description": "The blockchain address of the sender" }, "sender_address_label": { "type": "string", "description": "A label or identifier for the sender address" }, "sender_logo_url": { "type": "string", "description": "The URL of the logo associated with the sender address" }, "supports_erc": { "type": "array", "items": {}, "description": "The list of supported ERC standards for the sender contract" }, "sender_factory_address": { "type": "string", "description": "The address of the contract factory that created the sender contract" }, "raw_log_data": { "type": "string", "description": "The raw data of the log" }, "decoded": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the event" }, "signature": { "type": "string", "description": "The event's signature" }, "params": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the parameter" }, "type": { "type": "string", "description": "The data type of the parameter" }, "indexed": { "type": "boolean", "description": "Indicates whether the parameter is indexed" }, "decoded": { "type": "boolean", "description": "Indicates whether the parameter has been decoded" }, "value": { "type": "string", "description": "The value of the parameter" } } }, "description": "An array of parameters for the event" } }, "description": "The decoded log event data" } } }, "description": "An array containing details about the block transactions and logs" }, "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "Indicates whether more results are available" }, "page_number": { "type": "integer", "description": "The current page number" }, "page_size": { "type": "integer", "description": "The number of results per page" }, "total_count": { "type": "integer", "description": "The total number of results available" } }, "description": "Details about the pagination of the response" } }, "description": "The data object which contains the following fields:" } } } } } } } } }, "/v1/{chainName}/nft/approvals/{walletAddress}": { "get": { "operationId": "get_v1_by_chainName_nft_approvals_by_walletAddress", "summary": "Commonly used to get a list of NFT approvals across all token contracts categorized by spenders for a wallet assets", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-nft-approvals-walletAddress" }, "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name eg: base-mainnet" }, "required": true, "description": "The chain name eg: base-mainnet" }, { "name": "walletAddress", "in": "path", "schema": { "type": "string", "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" }, "required": true, "description": "The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp of the last update" }, "chain_id": { "type": "integer", "description": "The ID of the blockchain" }, "chain_name": { "type": "string", "description": "The name of the blockchain" }, "address": { "type": "string", "description": "The address for which data is retrieved" }, "items": { "type": "array", "items": { "type": "object", "properties": { "contract_address": { "type": "string", "description": "The contract address associated with the item" }, "contract_address_label": { "type": "string", "description": "The label for the contract address" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the contract" }, "supports_erc": { "type": "array", "items": {}, "description": "An array of supported ERC tokens" }, "token_balances": { "type": "array", "items": { "type": "object", "properties": { "token_id": { "type": "string", "description": "The ID of the token" }, "token_balance": { "type": "string", "description": "The balance of the token" } } }, "description": "An array of token balances" }, "spenders": { "type": "array", "items": { "type": "object", "properties": { "block_height": { "type": "integer", "description": "The block height at which the spender event occurred" }, "tx_offset": { "type": "integer", "description": "The transaction offset within the block" }, "log_offset": { "type": "integer", "description": "The log offset within the transaction" }, "block_signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "tx_hash": { "type": "string", "description": "The transaction hash associated with the spender" }, "spender_address": { "type": "string", "description": "The address of the spender" }, "spender_address_label": { "type": "string", "description": "The label for the spender address" }, "token_ids_approved": { "type": "string", "description": "The IDs of tokens approved for the spender" }, "allowance": { "type": "string", "description": "The allowance granted to the spender" } } }, "description": "An array of spender details" } } }, "description": "An array of items containing contract and spender details" } }, "description": "The data object which contains the following fields:" } } } } } } } } }, "/v1/{chainName}/transaction_v2/{txHash}": { "get": { "operationId": "get_v1_by_chainName_transaction_v2_by_txHash", "summary": "Commonly used to fetch and render a single transaction including its decoded log events", "tags": [], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chainName-transaction_v2-txHash" }, "parameters": [ { "name": "chainName", "in": "path", "schema": { "type": "string", "description": "The chain name eg: base-mainnet" }, "required": true, "description": "The chain name eg: base-mainnet" }, { "name": "txHash", "in": "path", "schema": { "type": "string", "description": "The transaction hash" }, "required": true, "description": "The transaction hash" }, { "name": "quote-currency", "in": "query", "schema": { "type": "string", "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, { "name": "no-logs", "in": "query", "schema": { "type": "boolean", "description": "It omit log events" }, "description": "It omit log events" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "chain_id": { "type": "integer", "description": "The ID of the blockchain network" }, "chain_name": { "type": "string", "description": "The name of the blockchain network" }, "items": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block was signed" }, "block_height": { "type": "integer", "description": "The height of the block in the blockchain" }, "block_hash": { "type": "string", "description": "The hash of the block containing the transaction" }, "tx_hash": { "type": "string", "description": "The hash of the transaction" }, "tx_offset": { "type": "integer", "description": "The offset of the transaction in the block" }, "successful": { "type": "boolean", "description": "Indicates if the transaction was successful" }, "from_address": { "type": "string", "description": "The address of the sender of the transaction" }, "miner_address": { "type": "string", "description": "The address of the miner who mined the block" }, "from_address_label": { "type": "string", "description": "A label for the sender's address" }, "to_address": { "type": "string", "description": "The address of the recipient of the transaction" }, "to_address_label": { "type": "string", "description": "A label for the recipient's address" }, "value": { "type": "string", "description": "The value transferred in the transaction" }, "value_quote": { "type": "integer", "description": "The value of the transaction in the quoted currency" }, "pretty_value_quote": { "type": "string", "description": "The value of the transaction in quoted currency, formatted as a readable string" }, "gas_metadata": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimals in the contract" }, "contract_name": { "type": "string", "description": "The name of the contract" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the contract" }, "contract_address": { "type": "string", "description": "The address of the contract" }, "supports_erc": { "type": "array", "items": {}, "description": "A list of ERC standards supported by the contract" }, "logo_url": { "type": "string", "description": "The URL of the contract's logo" } }, "description": "Metadata related to gas usage" }, "gas_offered": { "type": "integer", "description": "The gas offered for the transaction" }, "gas_spent": { "type": "integer", "description": "The gas spent in the transaction" }, "gas_price": { "type": "integer", "description": "The gas price for the transaction" }, "fees_paid": { "type": "string", "description": "The total gas fees paid in the transaction" }, "gas_quote": { "type": "integer", "description": "The gas fees in quoted currency" }, "pretty_gas_quote": { "type": "string", "description": "The gas fees in quoted currency, formatted as a readable string" }, "gas_quote_rate": { "type": "integer", "description": "The gas rate in quoted currency" }, "explorers": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "The label for the explorer link" }, "url": { "type": "string", "description": "The URL of the explorer link" } } }, "description": "An array of explorer links" }, "log_events": { "type": "array", "items": { "type": "object", "properties": { "block_signed_at": { "type": "string", "description": "The timestamp when the block containing the log was signed" }, "block_height": { "type": "integer", "description": "The height of the block containing the log" }, "tx_offset": { "type": "integer", "description": "The offset of the transaction in the block" }, "log_offset": { "type": "integer", "description": "The offset of the log in the transaction" }, "tx_hash": { "type": "string", "description": "The hash of the transaction containing the log" }, "raw_log_topics": { "type": "array", "items": {}, "description": "A list of topics associated with the log" }, "decoded": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the event" }, "signature": { "type": "string", "description": "The signature of the event" }, "params": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the parameter" }, "type": { "type": "string", "description": "The data type of the parameter" }, "value": { "type": "string", "description": "The value of the parameter" } } }, "description": "The parameters of the event" } }, "description": "The decoded log data" } } }, "description": "An array of log events associated with the transaction" }, "safe_details": { "type": "array", "items": { "type": "object", "properties": { "owner_address": { "type": "string", "description": "The address of the safe owner" }, "signature": { "type": "string", "description": "The signature used in the safe transaction" }, "signature_type": { "type": "string", "description": "The type of the signature" } } }, "description": "Details of safe transactions" } } }, "description": "An array of transaction items" }, "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "Indicates if there are more pages available" }, "page_number": { "type": "integer", "description": "The current page number" }, "page_size": { "type": "integer", "description": "The number of items per page" }, "total_count": { "type": "integer", "description": "The total number of items, if available" } }, "description": "(Optional) Pagination details of the response" } }, "description": "The response data containing following fields:" }, "error": { "type": "boolean", "description": "Indicates whether an error occurred" }, "error_message": { "type": "string", "description": "The error message if an error occurred, or null otherwise" }, "error_code": { "type": "string", "description": "The error code if an error occurred, or null otherwise" } } } } } } } } }, "/v1/chains": { "get": { "operationId": "get_v1_chains", "summary": "Commonly used to build internal dashboards for all supported chains on Covalent.", "tags": [ "chains" ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chains" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp when the data was last updated." }, "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the blockchain network." }, "chain_id": { "type": "string", "description": "The unique identifier for the blockchain network." }, "is_testnet": { "type": "boolean", "description": "Indicates if the network is a testnet." }, "db_schema_name": { "type": "string", "description": "The name of the database schema used for this network." }, "label": { "type": "string", "description": "The label of the network." }, "category_label": { "type": "string", "description": "The category label of the network." }, "logo_url": { "type": "string", "description": "The URL of the network's logo." }, "black_logo_url": { "type": "string", "description": "The URL of the network's black-themed logo." }, "white_logo_url": { "type": "string", "description": "The URL of the network's white-themed logo." }, "color_theme": { "type": "object", "properties": { "red": { "type": "integer", "description": "The red component of the color theme (0-255)." }, "green": { "type": "integer", "description": "The green component of the color theme (0-255)." }, "blue": { "type": "integer", "description": "The blue component of the color theme (0-255)." }, "alpha": { "type": "integer", "description": "The alpha transparency value of the color theme (0-255)." }, "hex": { "type": "string", "description": "The hex code of the color theme." }, "css_rgb": { "type": "string", "description": "The CSS RGB representation of the color theme." } }, "description": "Details of the color theme associated with the network." }, "is_appchain": { "type": "boolean", "description": "Indicates if the network is an appchain." }, "appchain_of": { "type": "object", "description": "Details about the parent network if this network is an appchain." } } }, "description": "An array of network details." }, "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "The flag indicating if there are more pages of data" }, "page_number": { "type": "integer", "description": "The current page number" }, "page_size": { "type": "integer", "description": "The number of items per page" }, "total_count": { "type": "integer", "description": "The total number of items (nullable)" } }, "description": "The pagination details for the response" } }, "description": "The main response object containing blockchain status and metadata" }, "error": { "type": "boolean", "description": "Indicates whether there was an error in the response" }, "error_message": { "type": "string", "description": "The error message, if any" }, "error_code": { "type": "string", "description": "The error code, if any" } } } } } } } } }, "/v1/chains/status": { "get": { "operationId": "get_v1_chains_status", "summary": "Used to build internal status dashboards of all supported chains", "tags": [ "chains" ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-chains-status" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp of the last update in ISO 8601 format" }, "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the blockchain (e.g., base-mainnet)" }, "chain_id": { "type": "string", "description": "The unique identifier of the blockchain" }, "is_testnet": { "type": "boolean", "description": "Indicates whether the blockchain is a testnet" }, "priority_label": { "type": "string", "description": "The priority label assigned to the blockchain (e.g., Foundational)" }, "logo_url": { "type": "string", "description": "The URL for the blockchain's logo" }, "black_logo_url": { "type": "string", "description": "The URL for the blockchain's logo with a black theme" }, "white_logo_url": { "type": "string", "description": "The URL for the blockchain's logo with a white theme" }, "color_theme": { "type": "object", "properties": { "red": { "type": "integer", "description": "The red component of the color" }, "green": { "type": "integer", "description": "The green component of the color" }, "blue": { "type": "integer", "description": "The blue component of the color" }, "alpha": { "type": "integer", "description": "The alpha (transparency) component of the color" }, "hex": { "type": "string", "description": "The hex code of the color" }, "css_rgb": { "type": "string", "description": "The CSS RGB representation of the color" } }, "description": "The color theme details of the blockchain" }, "appchain_of": { "type": "string", "description": "The parent blockchain of the appchain, if applicable" }, "synced_block_height": { "type": "integer", "description": "The height of the last synced block" }, "synced_blocked_signed_at": { "type": "string", "description": "The timestamp when the last block was signed" }, "has_data": { "type": "boolean", "description": "Indicates whether the blockchain has data available" } } }, "description": "An array of blockchain status details" }, "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "The flag indicating if there are more pages of data" }, "page_number": { "type": "integer", "description": "The current page number" }, "page_size": { "type": "integer", "description": "The number of items per page" }, "total_count": { "type": "integer", "description": "The total number of items (nullable)" } }, "description": "The pagination details for the response" } }, "description": "The main response object containing blockchain status and metadata" }, "error": { "type": "boolean", "description": "Indicates whether there was an error in the response" }, "error_message": { "type": "string", "description": "The error message, if any" }, "error_code": { "type": "string", "description": "The error code, if any" } } } } } } } } }, "/v1/cq/covalent/app/bitcoin/transactions": { "get": { "operationId": "get_v1_cq_covalent_app_bitcoin_transactions", "summary": "Fetch the full transaction history of a Bitcoin wallet", "tags": [ "cq" ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-cq-covalent-app-bitcoin-transactions" }, "parameters": [ { "name": "address", "in": "query", "schema": { "type": "string", "description": "The address to query transactions for" }, "required": true, "description": "The address to query transactions for" }, { "name": "page-size", "in": "query", "schema": { "type": "integer", "description": "The number of results to display per page" }, "description": "The number of results to display per page" }, { "name": "page-number", "in": "query", "schema": { "type": "integer", "description": "The page number to retrieve for paginated results" }, "description": "The page number to retrieve for paginated results" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "updated_at": { "type": "string", "description": "The timestamp of when the data was last updated" }, "items": { "type": "array", "items": { "type": "object", "properties": { "chain_id": { "type": "string", "description": "The ID of the blockchain" }, "chain_name": { "type": "string", "description": "The name of the blockchain" }, "contract_decimals": { "type": "integer", "description": "The number of decimal places used by the token contract" }, "block_hash": { "type": "string", "description": "The hash of the block" }, "block_signed_at": { "type": "string", "description": "The timestamp of when the block was signed" }, "block_height": { "type": "string", "description": "The height of the block" }, "tx_hash": { "type": "string", "description": "The hash of the transaction" }, "tx_idx": { "type": "string", "description": "The index of the transaction within the block" }, "type": { "type": "string", "description": "The type of transaction (e.g., input or output)" }, "address": { "type": "string", "description": "The address associated with the transaction" }, "value": { "type": "string", "description": "The value of the transaction" }, "quote_rate": { "type": "number", "description": "The exchange rate at the time of the transaction" }, "quote": { "type": "number", "description": "The quoted value in USD" }, "fees_paid": { "type": "string", "description": "The fees paid for the transaction" }, "gas_quote": { "type": "number", "description": "The gas quote for the transaction" }, "gas_quote_rate": { "type": "number", "description": "The gas quote rate at the time of the transaction" }, "coinbase": { "type": "boolean", "description": "Indicates if the transaction was a coinbase transaction" }, "locktime": { "type": "string", "description": "The locktime of the transaction" }, "weight": { "type": "string", "description": "The weight of the transaction" } } }, "description": "An array of transaction details" }, "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "Indicates if there are more pages available" }, "page_number": { "type": "integer", "description": "The current page number" }, "page_size": { "type": "integer", "description": "The number of items per page" }, "total_count": { "type": "string", "description": "The total number of items" } }, "description": "Pagination details for the response" }, "metadata": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the metadata field" }, "type": { "type": "string", "description": "The type of the metadata field" } } }, "description": "Additional metadata for the response" } }, "description": "The main response object containing the data" } } } } } } } } }, "/v1/pricing/historical_by_addresses_v2/eth/{quoteCurrency}/{contractAddress}": { "get": { "operationId": "get_v1_pricing_historical_by_addresses_v2_eth_by_quoteCurrency_by_contractAddress", "summary": "Get historic prices of a token between date ranges.", "tags": [ "pricing" ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/goldrush-wallet-api/v1-pricing-historical_by_addresses_v2-eth-quoteCurrency-contractAddress" }, "description": "Get historic prices of a token between date ranges. Supports native tokens", "parameters": [ { "name": "quoteCurrency", "in": "path", "schema": { "type": "string", "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, "required": true, "description": "The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP" }, { "name": "contractAddress", "in": "path", "schema": { "type": "string", "description": "The contract address of the token being queried" }, "required": true, "description": "The contract address of the token being queried" }, { "name": "from", "in": "query", "schema": { "type": "string", "description": "The start date for fetching historical prices in YYYY-MM-DD format" }, "description": "The start date for fetching historical prices in YYYY-MM-DD format" }, { "name": "to", "in": "query", "schema": { "type": "string", "description": "The end date for fetching historical prices in YYYY-MM-DD format" }, "description": "The end date for fetching historical prices in YYYY-MM-DD format" }, { "name": "prices-at-asc", "in": "query", "schema": { "type": "boolean", "description": "Whether to sort the prices in ascending order by timestamp" }, "description": "Whether to sort the prices in ascending order by timestamp" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimals the token uses" }, "contract_name": { "type": "string", "description": "The name of the token contract" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the token" }, "contract_address": { "type": "string", "description": "The address of the token contract" }, "supports_erc": { "type": "array", "items": {}, "description": "The supported ERC standards for the token (e.g., ERC20)" }, "logo_url": { "type": "string", "description": "The URL for the token's logo" }, "update_at": { "type": "string", "description": "The timestamp when the data was last updated" }, "quote_currency": { "type": "string", "description": "The currency in which the prices are quoted" }, "logo_urls": { "type": "object", "properties": { "token_logo_url": { "type": "string", "description": "The URL for the token's logo" }, "protocol_logo_url": { "type": "string", "description": "The URL for the protocol's logo (if available)" }, "chain_logo_url": { "type": "string", "description": "The URL for the chain's logo" } }, "description": "An object containing various logo URLs" }, "prices": { "type": "array", "items": { "type": "object", "properties": { "contract_metadata": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimals the token uses" }, "contract_name": { "type": "string", "description": "The name of the token contract" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the token" }, "contract_address": { "type": "string", "description": "The address of the token contract" }, "supports_erc": { "type": "array", "items": {}, "description": "The supported ERC standards for the token (e.g., ERC20)" }, "logo_url": { "type": "string", "description": "The URL for the token's logo" } }, "description": "Metadata of the token contract" }, "date": { "type": "string", "description": "The date for the price data" }, "price": { "type": "integer", "description": "The price of the token on the specified date" }, "pretty_price": { "type": "string", "description": "A human-readable representation of the token price" } } }, "description": "An array of price data for the token" }, "items": { "type": "array", "items": { "type": "object", "properties": { "contract_metadata": { "type": "object", "properties": { "contract_decimals": { "type": "integer", "description": "The number of decimals the token uses" }, "contract_name": { "type": "string", "description": "The name of the token contract" }, "contract_ticker_symbol": { "type": "string", "description": "The ticker symbol of the token" }, "contract_address": { "type": "string", "description": "The address of the token contract" }, "supports_erc": { "type": "array", "items": {}, "description": "The supported ERC standards for the token (e.g., ERC20)" }, "logo_url": { "type": "string", "description": "The URL for the token's logo" } }, "description": "Metadata of the token contract" }, "date": { "type": "string", "description": "The date for the item data" }, "price": { "type": "integer", "description": "The price of the token on the specified date" }, "pretty_price": { "type": "string", "description": "A human-readable representation of the token price" } } }, "description": "An array of item data related to the token" } } }, "description": "The array containing token contract details and price information" }, "error": { "type": "boolean", "description": "Indicates whether there was an error in the response" }, "error_message": { "type": "string", "description": "The error message, if any" }, "error_code": { "type": "integer", "description": "The error code, if any" } } } } } } } } } }, "servers": [ { "url": "https://api.covalenthq.com", "description": "Quicknode Base" } ] }