NAiOS IconNAiOS Logo
Volver al catálogo

Bitquery

bitquery

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

Acciones
18
Triggers
0
Autenticación
OAuth gestionado
No
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