Bitquery

bitquery

Bitquery provides historical and real-time indexed data for over 40 blockchains through GraphQL APIs, Websockets, SQL, and cloud providers.

Analytics Developer Tools Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

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ón

Tool 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

querystringObligatorio
GraphQL query string using aliases to disambiguate fields in the response
variablesobject
Optional mapping of GraphQL variables if your query uses `$variable` placeholders.

Parámetros de salida

dataobject
GraphQL response data structured by provided aliases.
errorstring
Error if any occurred during the execution of the action
errorsobject[]
List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Archive Database QueryBITQUERY_ARCHIVE_DATABASE_QUERYAcción

Tool to query the archive database. use when you need full historical blockchain data (delayed by tens of minutes to hours).

Parámetros de entrada

querystringObligatorio
GraphQL query string to execute against the Archive Database
variablesobject
Optional mapping of GraphQL variables for parameterized queries
operationNamestring
Optional operation name if the query document contains multiple operations

Parámetros de salida

dataobject
Data returned by the GraphQL query; structure depends on the query
errorstring
Error if any occurred during the execution of the action
errorsobject[]
List of GraphQL errors if the query failed or was malformed
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Combined Database QueryBITQUERY_COMBINED_DATABASE_QUERYAcción

Tool 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

querystringObligatorio
The GraphQL query string to execute against the Combined Database.
variablesobject
Optional map of variables referenced in the GraphQL query.
operationNamestring
Optional operation name if the query document contains multiple operations.

Parámetros de salida

dataobject
Data returned by the GraphQL query; structure depends on the provided query.
errorstring
Error if any occurred during the execution of the action
errorsobject[]
List of errors returned by the GraphQL API, if any.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Conditional Metrics SnippetBITQUERY_CONDITIONAL_METRICSAcción

Tool 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

ifobjectObligatorio
Filter object to apply to the metric execution, using GraphQL filter structure.
aliasstring
GraphQL alias name for the metric.
fieldstringObligatorio
The field to aggregate, e.g., 'Block_GasUsed'.
operationstringObligatorioenum
Type of metric operation to apply.
countsumavgminmax
select_whereobject
HAVING-style filter after aggregation (applies to operations other than count).
distinct_fieldstring
Field name for distinct operator (only valid for 'count' operation). E.g., 'Block_Number'.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Count Distinct MetricBITQUERY_COUNT_DISTINCT_METRICAcción

Tool 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

querystringObligatorio
GraphQL query string specifying the distinct count aggregation. For example: '{ ethereum(network: bsc) { transfers(date: {since: "2023-01-01"}) { count: count(distinct: sender) } } }'.
variablesobject
Optional mapping of GraphQL variables if your query uses `$variable` placeholders.

Parámetros de salida

dataobject
GraphQL data payload containing the distinct count results.
errorstring
Error if any occurred during the execution of the action
errorsobject[]
List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Count MetricBITQUERY_COUNT_METRICAcción

Tool 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

querystringObligatorio
GraphQL query string specifying the count aggregation. For example: '{ bitcoin { blocks(options: {limit: 1}) { count } } }'.
variablesobject
Optional GraphQL variables map if your query uses `$variable` placeholders.

Parámetros de salida

dataobject
GraphQL data payload containing the count results.
errorstring
Error if any occurred during the execution of the action
errorsobject[]
List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Database SelectionBITQUERY_DATABASE_SELECTIONAcción

Tool 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

datasetstringObligatorioenum
Determines which Bitquery GraphQL dataset to use: realtime (latest blocks), archive (historical data), combined (merge both).
realtimearchivecombined

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Early Access Program QueryBITQUERY_EARLY_ACCESS_PROGRAM_QUERYAcción

Tool 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

querystringObligatorio
GraphQL query or subscription string conforming to the EAP schema. For example: subscription { Solana { DEXTrades { Block { Time Slot } Trade { Price } } } }
variablesobject
Optional variables for GraphQL queries

Parámetros de salida

dataobjectObligatorio
Data field from the GraphQL response
errorstring
Error if any occurred during the execution of the action
errorsobject[]
Errors returned by the GraphQL API, if any
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Mempool SubscriptionBITQUERY_MEMPOOL_SUBSCRIPTIONAcción

Tool 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

querystringObligatorio
GraphQL subscription query string defining mempool feed and filters.
variablesobject
GraphQL variables map for the subscription query.

Parámetros de salida

dataobjectObligatorio
GraphQL data payload containing mempool feed.
errorstring
Error if any occurred during the execution of the action
errorsobject[]
List of GraphQL errors, if any.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Network SelectionBITQUERY_NETWORK_SELECTIONAcción

Tool 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

networkstringObligatorioenum
Blockchain 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

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Options QueryBITQUERY_OPTIONS_QUERYAcción

Tool 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

dataobjectObligatorio
Introspection data for dataset options
errorstring
Error if any occurred during the execution of the action
errorsobject[]
GraphQL errors, if any
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Price Asymmetry MetricBITQUERY_PRICE_ASYMMETRY_METRICAcción

Tool to generate graphql priceasymmetry filter snippet. use when you need to filter trades based on price asymmetry metric.

Parámetros de entrada

genumber
Price asymmetry greater than or equal to this value.
gtnumber
Price asymmetry greater than this value.
lenumber
Price asymmetry less than or equal to this value.
ltnumber
Price asymmetry less than this value.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Quantile MetricBITQUERY_QUANTILE_METRICAcción

Tool 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

querystringObligatorio
GraphQL 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) } } }'.
variablesobject
Optional GraphQL variables map if your query uses `$variable` placeholders.

Parámetros de salida

dataobject
GraphQL data payload containing the quantile result.
errorstring
Error if any occurred during the execution of the action
errorsobject[]
List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Realtime Database QueryBITQUERY_REALTIME_DATABASE_QUERYAcción

Realtime database query

Parámetros de entrada

querystringObligatorio
GraphQL query string to execute against the Realtime Database.
variablesobject
Optional mapping of GraphQL variables for parameterized queries
operationNamestring
Optional operation name if the query document contains multiple operations

Parámetros de salida

dataobject
Data returned by the GraphQL query; structure depends on the query
errorstring
Error if any occurred during the execution of the action
errorsobject[]
List of GraphQL errors if the query failed or was malformed
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Select By MetricBITQUERY_SELECT_BY_METRICAcción

Tool 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

ofstringObligatorio
The metric field to aggregate, e.g., 'BalanceUpdate_Amount'
aliasstring
Optional GraphQL alias for the metric snippet
operationstringObligatorioenum
Aggregation operation supporting selectWhere (e.g., sum, avg, min, max)
sumavgminmax
selectWhereobjectObligatorio
Filter expression for the metric values using selectWhere

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Statistics MetricBITQUERY_STATISTICS_METRICAcción

Tool 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

querystringObligatorio
GraphQL query string invoking statistical metric functions such as average, median, quantile, correlation, etc.
variablesobject
Optional mapping of GraphQL variables if the query uses `$` placeholders.

Parámetros de salida

dataobject
GraphQL data payload containing statistical metric results.
errorstring
Error if any occurred during the execution of the action
errorsobject[]
List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Sum MetricBITQUERY_SUM_METRICAcción

Tool 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

querystringObligatorio
GraphQL query string specifying the sum metric. For example: '{ EVM(dataset: archive, network: bsc) { MinerRewards { sum: sum(of: Reward_Total) } } }'.
variablesobject
Optional GraphQL variables map if your query uses `$variable` placeholders.

Parámetros de salida

dataobject
GraphQL data payload containing the sum result.
errorstring
Error if any occurred during the execution of the action
errorsobject[]
List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Uniq MetricBITQUERY_UNIQ_METRICAcción

Tool 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

querystringObligatorio
GraphQL 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) } } }'.
variablesobject
Optional GraphQL variables map if your query uses `$variable` placeholders.

Parámetros de salida

dataobject
GraphQL data payload containing the uniq metric result.
errorstring
Error if any occurred during the execution of the action
errorsobject[]
List of GraphQL errors if the query failed or was malformed.
successfulbooleanObligatorio
Whether or not the action execution was successful or not