Bitquery
bitqueryBitquery provides historical and real-time indexed data for over 40 blockchains through GraphQL APIs, Websockets, SQL, and cloud providers.
Acciones disponibles (18)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Aliases MetricBITQUERY_ALIASES_METRICAcciónTool to use graphql aliases to rename fields in the response for clarity and disambiguation. use when you need to query multiple metrics with identical field names in one call.
BITQUERY_ALIASES_METRICAcciónTool to use graphql aliases to rename fields in the response for clarity and disambiguation. use when you need to query multiple metrics with identical field names in one call.
Parámetros de entrada
querystringObligatorioGraphQL query string using aliases to disambiguate fields in the response
variablesobjectOptional mapping of GraphQL variables if your query uses `$variable` placeholders.
Parámetros de salida
dataobjectGraphQL response data structured by provided aliases.
errorstringError if any occurred during the execution of the action
errorsobject[]List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorioWhether or not the action execution was successful or not
Archive Database QueryBITQUERY_ARCHIVE_DATABASE_QUERYAcciónTool to query the archive database. use when you need full historical blockchain data (delayed by tens of minutes to hours).
BITQUERY_ARCHIVE_DATABASE_QUERYAcciónTool to query the archive database. use when you need full historical blockchain data (delayed by tens of minutes to hours).
Parámetros de entrada
querystringObligatorioGraphQL query string to execute against the Archive Database
variablesobjectOptional mapping of GraphQL variables for parameterized queries
operationNamestringOptional operation name if the query document contains multiple operations
Parámetros de salida
dataobjectData returned by the GraphQL query; structure depends on the query
errorstringError if any occurred during the execution of the action
errorsobject[]List of GraphQL errors if the query failed or was malformed
successfulbooleanObligatorioWhether or not the action execution was successful or not
Combined Database QueryBITQUERY_COMBINED_DATABASE_QUERYAcciónTool to query the combined database, which merges archive and real-time databases. use when you need both historical and up-to-the-second blockchain data in one request.
BITQUERY_COMBINED_DATABASE_QUERYAcciónTool to query the combined database, which merges archive and real-time databases. use when you need both historical and up-to-the-second blockchain data in one request.
Parámetros de entrada
querystringObligatorioThe GraphQL query string to execute against the Combined Database.
variablesobjectOptional map of variables referenced in the GraphQL query.
operationNamestringOptional operation name if the query document contains multiple operations.
Parámetros de salida
dataobjectData returned by the GraphQL query; structure depends on the provided query.
errorstringError if any occurred during the execution of the action
errorsobject[]List of errors returned by the GraphQL API, if any.
successfulbooleanObligatorioWhether or not the action execution was successful or not
Conditional Metrics SnippetBITQUERY_CONDITIONAL_METRICSAcciónTool to generate a graphql metric snippet with conditional logic. use when you need to apply filters directly on metric calculations via the `if` attribute.
BITQUERY_CONDITIONAL_METRICSAcciónTool to generate a graphql metric snippet with conditional logic. use when you need to apply filters directly on metric calculations via the `if` attribute.
Parámetros de entrada
ifobjectObligatorioFilter object to apply to the metric execution, using GraphQL filter structure.
aliasstringGraphQL alias name for the metric.
fieldstringObligatorioThe field to aggregate, e.g., 'Block_GasUsed'.
operationstringObligatorioenumType of metric operation to apply.
countsumavgminmaxselect_whereobjectHAVING-style filter after aggregation (applies to operations other than count).
distinct_fieldstringField name for distinct operator (only valid for 'count' operation). E.g., 'Block_Number'.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Count Distinct MetricBITQUERY_COUNT_DISTINCT_METRICAcciónTool to use the count distinct metric to aggregate unique values for a field. use when you need to count the number of unique occurrences in a dataset.
BITQUERY_COUNT_DISTINCT_METRICAcciónTool to use the count distinct metric to aggregate unique values for a field. use when you need to count the number of unique occurrences in a dataset.
Parámetros de entrada
querystringObligatorioGraphQL query string specifying the distinct count aggregation. For example: '{ ethereum(network: bsc) { transfers(date: {since: "2023-01-01"}) { count: count(distinct: sender) } } }'.
variablesobjectOptional mapping of GraphQL variables if your query uses `$variable` placeholders.
Parámetros de salida
dataobjectGraphQL data payload containing the distinct count results.
errorstringError if any occurred during the execution of the action
errorsobject[]List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorioWhether or not the action execution was successful or not
Count MetricBITQUERY_COUNT_METRICAcciónTool to use the count metric to aggregate the number of records matching a graphql query. use when you need simple record counts.
BITQUERY_COUNT_METRICAcciónTool to use the count metric to aggregate the number of records matching a graphql query. use when you need simple record counts.
Parámetros de entrada
querystringObligatorioGraphQL query string specifying the count aggregation. For example: '{ bitcoin { blocks(options: {limit: 1}) { count } } }'.
variablesobjectOptional GraphQL variables map if your query uses `$variable` placeholders.
Parámetros de salida
dataobjectGraphQL data payload containing the count results.
errorstringError if any occurred during the execution of the action
errorsobject[]List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorioWhether or not the action execution was successful or not
Database SelectionBITQUERY_DATABASE_SELECTIONAcciónTool to select the database (archive, realtime, combined) to query at the top level of a graphql request. use after determining whether you need live, historical, or combined blockchain data.
BITQUERY_DATABASE_SELECTIONAcciónTool to select the database (archive, realtime, combined) to query at the top level of a graphql request. use after determining whether you need live, historical, or combined blockchain data.
Parámetros de entrada
datasetstringObligatorioenumDetermines which Bitquery GraphQL dataset to use: realtime (latest blocks), archive (historical data), combined (merge both).
realtimearchivecombined
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Early Access Program QueryBITQUERY_EARLY_ACCESS_PROGRAM_QUERYAcciónTool to access streaming data across various blockchain networks for evaluation purposes. use when querying chains not available via the v2 endpoint; limited to real-time data only.
BITQUERY_EARLY_ACCESS_PROGRAM_QUERYAcciónTool to access streaming data across various blockchain networks for evaluation purposes. use when querying chains not available via the v2 endpoint; limited to real-time data only.
Parámetros de entrada
querystringObligatorioGraphQL query or subscription string conforming to the EAP schema. For example: subscription { Solana { DEXTrades { Block { Time Slot } Trade { Price } } } }
variablesobjectOptional variables for GraphQL queries
Parámetros de salida
dataobjectObligatorioData field from the GraphQL response
errorstringError if any occurred during the execution of the action
errorsobject[]Errors returned by the GraphQL API, if any
successfulbooleanObligatorioWhether or not the action execution was successful or not
Mempool SubscriptionBITQUERY_MEMPOOL_SUBSCRIPTIONAcciónTool to subscribe to real-time mempool updates for evm chains (ethereum, bnb, etc.). use after constructing your graphql subscription to stream pending transactions live.
BITQUERY_MEMPOOL_SUBSCRIPTIONAcciónTool to subscribe to real-time mempool updates for evm chains (ethereum, bnb, etc.). use after constructing your graphql subscription to stream pending transactions live.
Parámetros de entrada
querystringObligatorioGraphQL subscription query string defining mempool feed and filters.
variablesobjectGraphQL variables map for the subscription query.
Parámetros de salida
dataobjectObligatorioGraphQL data payload containing mempool feed.
errorstringError if any occurred during the execution of the action
errorsobject[]List of GraphQL errors, if any.
successfulbooleanObligatorioWhether or not the action execution was successful or not
Network SelectionBITQUERY_NETWORK_SELECTIONAcciónTool to select the blockchain network for graphql queries. use before constructing dataset or metric queries to ensure the correct chain is targeted.
BITQUERY_NETWORK_SELECTIONAcciónTool to select the blockchain network for graphql queries. use before constructing dataset or metric queries to ensure the correct chain is targeted.
Parámetros de entrada
networkstringObligatorioenumBlockchain network to query. If omitted, GraphQL defaults to eth. Supported networks: eth, bsc, bsc_testnet, goerli, rinkeby, ropsten, sepolia, classic, mordor, kotti, astor, polygon, arbitrum, avalanche, optimism, fantom, cronos, klaytn, fusion, huobi, moonbeam, celo, canto, aurora.
ethbscbsc_testnetgoerlirinkebyropstensepoliaclassicmordorkottiastorpolygon+12
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Options QueryBITQUERY_OPTIONS_QUERYAcciónTool to fetch graphql dataset options via schema introspection. use when you need to discover root-level query fields and their arguments before building queries.
BITQUERY_OPTIONS_QUERYAcciónTool to fetch graphql dataset options via schema introspection. use when you need to discover root-level query fields and their arguments before building queries.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioIntrospection data for dataset options
errorstringError if any occurred during the execution of the action
errorsobject[]GraphQL errors, if any
successfulbooleanObligatorioWhether or not the action execution was successful or not
Price Asymmetry MetricBITQUERY_PRICE_ASYMMETRY_METRICAcciónTool to generate graphql priceasymmetry filter snippet. use when you need to filter trades based on price asymmetry metric.
BITQUERY_PRICE_ASYMMETRY_METRICAcciónTool to generate graphql priceasymmetry filter snippet. use when you need to filter trades based on price asymmetry metric.
Parámetros de entrada
genumberPrice asymmetry greater than or equal to this value.
gtnumberPrice asymmetry greater than this value.
lenumberPrice asymmetry less than or equal to this value.
ltnumberPrice asymmetry less than this value.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Quantile MetricBITQUERY_QUANTILE_METRICAcciónTool to calculate quantiles to understand the distribution of numerical data. use when you need percentile metrics (e.g., median or quartiles) of a numerical field in a dataset.
BITQUERY_QUANTILE_METRICAcciónTool to calculate quantiles to understand the distribution of numerical data. use when you need percentile metrics (e.g., median or quartiles) of a numerical field in a dataset.
Parámetros de entrada
querystringObligatorioGraphQL query string specifying the quantile metric. For example: '{ EVM(dataset: archive, network: bsc) { Calls(limit: {count: 1}) { quantile_value: quantile(of: Call_Gas, level: 0.5) } } }'.
variablesobjectOptional GraphQL variables map if your query uses `$variable` placeholders.
Parámetros de salida
dataobjectGraphQL data payload containing the quantile result.
errorstringError if any occurred during the execution of the action
errorsobject[]List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorioWhether or not the action execution was successful or not
Realtime Database QueryBITQUERY_REALTIME_DATABASE_QUERYAcciónRealtime database query
BITQUERY_REALTIME_DATABASE_QUERYAcciónRealtime database query
Parámetros de entrada
querystringObligatorioGraphQL query string to execute against the Realtime Database.
variablesobjectOptional mapping of GraphQL variables for parameterized queries
operationNamestringOptional operation name if the query document contains multiple operations
Parámetros de salida
dataobjectData returned by the GraphQL query; structure depends on the query
errorstringError if any occurred during the execution of the action
errorsobject[]List of GraphQL errors if the query failed or was malformed
successfulbooleanObligatorioWhether or not the action execution was successful or not
Select By MetricBITQUERY_SELECT_BY_METRICAcciónTool to generate a graphql metric snippet filtering by its value using selectwhere. use when you need to include only metrics meeting specific value conditions (e.g., only positive sums).
BITQUERY_SELECT_BY_METRICAcciónTool to generate a graphql metric snippet filtering by its value using selectwhere. use when you need to include only metrics meeting specific value conditions (e.g., only positive sums).
Parámetros de entrada
ofstringObligatorioThe metric field to aggregate, e.g., 'BalanceUpdate_Amount'
aliasstringOptional GraphQL alias for the metric snippet
operationstringObligatorioenumAggregation operation supporting selectWhere (e.g., sum, avg, min, max)
sumavgminmaxselectWhereobjectObligatorioFilter expression for the metric values using selectWhere
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Statistics MetricBITQUERY_STATISTICS_METRICAcciónTool to compute statistical metrics (mean, median, etc.) over one variable in a dataset. use when you need precise summary statistics in your graphql query.
BITQUERY_STATISTICS_METRICAcciónTool to compute statistical metrics (mean, median, etc.) over one variable in a dataset. use when you need precise summary statistics in your graphql query.
Parámetros de entrada
querystringObligatorioGraphQL query string invoking statistical metric functions such as average, median, quantile, correlation, etc.
variablesobjectOptional mapping of GraphQL variables if the query uses `$` placeholders.
Parámetros de salida
dataobjectGraphQL data payload containing statistical metric results.
errorstringError if any occurred during the execution of the action
errorsobject[]List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorioWhether or not the action execution was successful or not
Sum MetricBITQUERY_SUM_METRICAcciónTool to calculate the sum of a specified field's values across defined dimensions. use when you need to aggregate total values in a dataset.
BITQUERY_SUM_METRICAcciónTool to calculate the sum of a specified field's values across defined dimensions. use when you need to aggregate total values in a dataset.
Parámetros de entrada
querystringObligatorioGraphQL query string specifying the sum metric. For example: '{ EVM(dataset: archive, network: bsc) { MinerRewards { sum: sum(of: Reward_Total) } } }'.
variablesobjectOptional GraphQL variables map if your query uses `$variable` placeholders.
Parámetros de salida
dataobjectGraphQL data payload containing the sum result.
errorstringError if any occurred during the execution of the action
errorsobject[]List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorioWhether or not the action execution was successful or not
Uniq MetricBITQUERY_UNIQ_METRICAcciónTool to estimate the count of unique values using the uniq metric. use when you need approximate or exact unique counts for analytics on blockchain datasets.
BITQUERY_UNIQ_METRICAcciónTool to estimate the count of unique values using the uniq metric. use when you need approximate or exact unique counts for analytics on blockchain datasets.
Parámetros de entrada
querystringObligatorioGraphQL query string specifying the uniq metric. For example: '{ EVM(dataset: archive, network: eth) { TokenHolders(limit:{count:1}) { uniq_value: uniq(of: Holder_Address, method: approximate) } } }'.
variablesobjectOptional GraphQL variables map if your query uses `$variable` placeholders.
Parámetros de salida
dataobjectGraphQL data payload containing the uniq metric result.
errorstringError if any occurred during the execution of the action
errorsobject[]List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorioWhether or not the action execution was successful or not