{"EVM(network: arc)"}{". Arc mainnet's chain ID is "}{"5042"}{"."} },
+ { q: "Are USD fields available?", id: "are-usd-fields-available", a: "Yes. AmountInUSD, PriceInUSD, CostInUSD and fee USD fields returned populated values in production checks on 16 September 2026.",
+ answer: {"Yes. "}{"AmountInUSD"}{", "}{"PriceInUSD"}{", "}{"CostInUSD"}{" and fee USD fields returned populated values in production checks on 16 September 2026."}
{"The realtime dataset was live at launch. Combined and archive were not ready during the 16 September check. Run the "}{"dataset probe"}{" before assuming a time range."}
}, + { q: "Can I use Trading.Trades for Arc?", id: "can-i-use-trading-trades-for-arc", a: "Yes. Filter Pair.Market.Network by Arc. Arc token IDs use the bid:arc: prefix.", + answer:{"Yes. Filter "}{"Pair.Market.Network"}{" by "}{"Arc"}{". Arc token IDs use the "}{"bid:arc:"}{" prefix."}
{"No. Bitquery is an indexed data API. Use Arc's RPC for state calls and transaction submission; use Bitquery for indexed queries and streams."}
}, + ]} +/> diff --git a/docs/blockchain/arc-testnet/arc-testnet-balances-api.md b/docs/blockchain/arc-testnet/arc-testnet-balances-api.md index abe05b072..712247751 100644 --- a/docs/blockchain/arc-testnet/arc-testnet-balances-api.md +++ b/docs/blockchain/arc-testnet/arc-testnet-balances-api.md @@ -16,6 +16,10 @@ keywords: --- # Arc Testnet Balances & Token Supply API +:::tip Arc mainnet is live +Most production integrations should use the [Arc Mainnet Balances & Token Supply API](/docs/blockchain/arc-mainnet/arc-mainnet-balances-api/) with `EVM(network: arc)`. Use this page only for Arc testnet data. +::: + Query **wallet balances and token supply on Arc testnet** with Bitquery GraphQL. Three cubes on `network: arc_testnet` cover it: | Cube | What it returns | @@ -356,7 +360,7 @@ subscription { ## FAQ **Why is the `Holders` cube missing?** -`Holders` is built from the archive dataset, and the testnet has none. Rank holders by summing `BalanceUpdates` per address within the realtime window, as shown above. Arc mainnet will have the full cube. +`Holders` is built from the archive dataset, and the testnet has none. Rank holders by summing `BalanceUpdates` per address within the realtime window, as shown above. The [Arc mainnet balances guide](/docs/blockchain/arc-mainnet/arc-mainnet-balances-api/) uses the full `Holders` cube. **Why does the same wallet show USDC twice?** Native USDC (`Native: true`, 18 decimals) and the ERC-20 USDC interface (`0x3600...`, 6 decimals) are tracked as two currencies. Sum them yourself if you want one USDC figure. A third row with contract `0xfff...fffe` and no symbol is a system ledger mirror and can be ignored. diff --git a/docs/blockchain/arc-testnet/arc-testnet-calls-api.md b/docs/blockchain/arc-testnet/arc-testnet-calls-api.md index 45eb76f3f..57cdd7a6e 100644 --- a/docs/blockchain/arc-testnet/arc-testnet-calls-api.md +++ b/docs/blockchain/arc-testnet/arc-testnet-calls-api.md @@ -15,6 +15,10 @@ keywords: --- # Arc Testnet Calls & Traces API +:::tip Arc mainnet is live +Most production integrations should use the [Arc Mainnet Calls & Traces API](/docs/blockchain/arc-mainnet/arc-mainnet-calls-api/) with `EVM(network: arc)`. Use this page only for Arc testnet data. +::: + Query and stream **smart contract calls on Arc testnet** with Bitquery GraphQL. The `EVM.Calls` cube on `network: arc_testnet` holds every call in every transaction, including internal calls, with the decoded method signature, the call path, value, gas, success and revert flags, and the enclosing transaction. It returns what `debug_traceTransaction` and `trace_filter` return, without running a node, and the same query runs as a subscription. Every query on this page was executed against the production endpoint before publishing. Change `query` to `subscription` on any of them to stream the same rows. diff --git a/docs/blockchain/arc-testnet/arc-testnet-events-api.md b/docs/blockchain/arc-testnet/arc-testnet-events-api.md index 119cd205f..b489a3383 100644 --- a/docs/blockchain/arc-testnet/arc-testnet-events-api.md +++ b/docs/blockchain/arc-testnet/arc-testnet-events-api.md @@ -16,6 +16,10 @@ keywords: --- # Arc Testnet Events API & WebSocket Streams +:::tip Arc mainnet is live +Most production integrations should use the [Arc Mainnet Events API](/docs/blockchain/arc-mainnet/arc-mainnet-events-api/) with `EVM(network: arc)`. Use this page only for Arc testnet data. +::: + Stream **every smart contract event on Arc testnet** with Bitquery GraphQL. The `EVM.Events` cube on `network: arc_testnet` returns each log with decoded, typed arguments for known signatures, the raw topics, and the transaction, internal call and receipt that produced it. It covers what `eth_getLogs` and `eth_subscribe("logs")` return, and adds server-side filtering on decoded values. Every query on this page was executed against the production endpoint before publishing. Change `query` to `subscription` on any of them to stream the same rows. diff --git a/docs/blockchain/arc-testnet/arc-testnet-trades-api.md b/docs/blockchain/arc-testnet/arc-testnet-trades-api.md index d696c8d44..9076c7863 100644 --- a/docs/blockchain/arc-testnet/arc-testnet-trades-api.md +++ b/docs/blockchain/arc-testnet/arc-testnet-trades-api.md @@ -17,6 +17,10 @@ keywords: --- # Arc Testnet DEX Trades API & Streams +:::tip Arc mainnet is live +Most production integrations should use the [Arc Mainnet DEX Trades API](/docs/blockchain/arc-mainnet/arc-mainnet-trades-api/) with `EVM(network: arc)`. Use this page only for Arc testnet data. +::: + Query and stream **DEX trades on Arc testnet** with Bitquery GraphQL. Arc is Circle's EVM Layer 1 for stablecoin finance, and its testnet is exposed as `EVM(network: arc_testnet)`. The `DEXTrades` and `DEXTradeByTokens` cubes carry every swap on **Uniswap v4, v3 and v2, Curve and Aerodrome** with buy and sell sides, native-unit prices, the DEX contract, the trader and the transaction. Every query on this page was executed against the production endpoint before publishing. Change `query` to `subscription` on any of them to stream the same rows over WebSocket. @@ -26,7 +30,7 @@ Every query on this page was executed against the production endpoint before pub - The multi-chain `Trading` cubes (`Trading.Trades`, `Tokens`, `Pairs`) do **not** include Arc testnet. Use the chain-level `DEXTrades` and `DEXTradeByTokens` cubes on this page. - Only `dataset: realtime` (the default) is served. There is no archive for the testnet, so leave the `dataset` argument out. -USD pricing and an archive dataset are planned for Arc **mainnet** once it is indexed. +For live data with USD pricing, use the [Arc Mainnet DEX Trades API](/docs/blockchain/arc-mainnet/arc-mainnet-trades-api/). The mainnet `archive` and `combined` datasets are not enabled yet. ::: :::note API Key Required diff --git a/docs/blockchain/arc-testnet/arc-testnet-transactions-api.md b/docs/blockchain/arc-testnet/arc-testnet-transactions-api.md index cde4b6aac..41598b8b5 100644 --- a/docs/blockchain/arc-testnet/arc-testnet-transactions-api.md +++ b/docs/blockchain/arc-testnet/arc-testnet-transactions-api.md @@ -16,6 +16,10 @@ keywords: --- # Arc Testnet Transactions, Blocks & Fees API +:::tip Arc mainnet is live +Most production integrations should use the [Arc Mainnet Transactions, Blocks & Fees API](/docs/blockchain/arc-mainnet/arc-mainnet-transactions-api/) with `EVM(network: arc)`. Use this page only for Arc testnet data. +::: + Query and stream **transactions, receipts and blocks on Arc testnet** with Bitquery GraphQL. The `EVM.Transactions` and `EVM.Blocks` cubes on `network: arc_testnet` cover what a block explorer shows for a hash, an address or a block, with fees in **USDC** because USDC is the chain's gas token. Every query on this page was executed against the production endpoint before publishing. Change `query` to `subscription` on any of them to stream the same rows. diff --git a/docs/blockchain/arc-testnet/arc-testnet-transfers-api.md b/docs/blockchain/arc-testnet/arc-testnet-transfers-api.md index 16c6f42ff..702858c19 100644 --- a/docs/blockchain/arc-testnet/arc-testnet-transfers-api.md +++ b/docs/blockchain/arc-testnet/arc-testnet-transfers-api.md @@ -15,6 +15,10 @@ keywords: --- # Arc Testnet Transfers API & Streams +:::tip Arc mainnet is live +Most production integrations should use the [Arc Mainnet Transfers API](/docs/blockchain/arc-mainnet/arc-mainnet-transfers-api/) with `EVM(network: arc)`. Use this page only for Arc testnet data. +::: + Query and stream **token transfers on Arc testnet** with Bitquery GraphQL. This is the shared **EVM `Transfers`** cube scoped to `network: arc_testnet`, so a query written for Ethereum or Base runs here by changing the network name. Arc's native gas token is **USDC**, and the chain carries an ERC-20 USDC interface, **EURC**, a testnet **USDT** and thousands of test tokens. Every query on this page was executed against the production endpoint before publishing. Change `query` to `subscription` on any of them to stream the same rows over WebSocket. diff --git a/docs/blockchain/arc-testnet/index.md b/docs/blockchain/arc-testnet/index.md index ccc536deb..9d6e7c4a8 100644 --- a/docs/blockchain/arc-testnet/index.md +++ b/docs/blockchain/arc-testnet/index.md @@ -24,7 +24,11 @@ import FAQ from "@site/src/components/FAQ"; # Arc Testnet API: Circle's Stablecoin L1 via GraphQL, WebSocket and Kafka -**Arc** is Circle's EVM-compatible Layer 1 built for stablecoin finance: **USDC is the native gas token**, blocks finalize in well under a second on the Malachite BFT consensus, and the chain carries USDC, EURC and a growing set of DeFi deployments led by Uniswap v4. Bitquery indexes the **Arc testnet** as `EVM(network: arc_testnet)` and publishes it as Kafka topics under `arc-testnet.*`, so you can build and test against the chain before mainnet with the same queries you already use on Ethereum, Base or Robinhood Chain. +:::tip Arc mainnet is live +Most production integrations should use the [Arc Mainnet API](/docs/blockchain/arc-mainnet/) with `EVM(network: arc)`. Use this page only for Arc testnet data. +::: + +**Arc** is Circle's EVM-compatible Layer 1 built for stablecoin finance: **USDC is the native gas token**, blocks finalize in well under a second on the Malachite BFT consensus, and the chain carries USDC, EURC and a growing set of DeFi deployments led by Uniswap v4. Bitquery indexes the **Arc testnet** as `EVM(network: arc_testnet)` and publishes it as Kafka topics under `arc-testnet.*`, so you can test before deploying the same queries to mainnet, Ethereum, Base or Robinhood Chain. This page is the map. Use it to pick the cube that answers your question, then jump to the linked guide. @@ -64,7 +68,7 @@ Arc testnet is indexed with the same EVM schema as every other chain, with four | **No `Trading` cubes** | `Trading.Trades`, `Tokens` and `Pairs` cover mainnet chains with USD pricing. Use the chain-level `DEXTrades` and `DEXTradeByTokens` cubes. | | **Some cubes are unavailable** | `Holders` needs the archive and is not served. `DEXPoolEvents` and `DEXPoolSlippages` have no data yet. `Balances`, `BalanceUpdates` and `TransactionBalances` work. | -Arc **mainnet** will be indexed with USD pricing from the token price index and an archive dataset. +Arc **mainnet** is indexed with USD pricing, the `Trading` cubes and the `Holders` cube. Use the [Arc Mainnet API](/docs/blockchain/arc-mainnet/) for production data. Its `archive` and `combined` datasets are not enabled yet. --- @@ -192,7 +196,7 @@ Only the **`realtime`** dataset exists for Arc testnet. It holds a rolling windo } ``` -`dataset: archive` and `dataset: combined` return errors on the testnet. The archive dataset, and with it the `Holders` cube and long time ranges, will be available for Arc mainnet. +`dataset: archive` and `dataset: combined` return errors on the testnet. Arc mainnet serves the `Holders` cube, but its `archive` and `combined` datasets are not enabled yet. --- @@ -201,8 +205,8 @@ Only the **`realtime`** dataset exists for Arc testnet. It holds a rolling windo items={[ { q: "What is Arc and what is its chain ID?", id: "what-is-arc-and-what-is-its-chain-id", a: "Arc is Circle's EVM-compatible Layer 1 for stablecoin finance, with USDC as the native gas token and sub-second finality on the Malachite BFT consensus. The testnet chain ID is 5042002. In Bitquery it is EVM(network: arc_testnet). Solidity ABIs, topic0 hashes and 4-byte selectors work exactly as they do on Ethereum.", answer:{"Arc is Circle's EVM-compatible Layer 1 for stablecoin finance, with USDC as the native gas token and sub-second finality on the Malachite BFT consensus. The testnet chain ID is "}{"5042002"}{". In Bitquery it is "}{"EVM(network: arc_testnet)"}{". Solidity ABIs, topic0 hashes and 4-byte selectors work exactly as they do on Ethereum."}
{"There is no token price index for a testnet, so every "}{"...InUSD"}{" field is 0. Native prices such as "}{"Trade.Price"}{" are correct, and because most pairs quote in USDC they are effectively dollar prices. Arc mainnet will carry USD values from the price index."}
{"There is no token price index for a testnet, so every "}{"...InUSD"}{" field is 0. Native prices such as "}{"Trade.Price"}{" are correct, and because most pairs quote in USDC they are effectively dollar prices. Arc mainnet carries USD values from the price index."}
{"Only the "}{"realtime"}{" dataset exists, holding a rolling window of recent blocks. There is no archive for the testnet, so "}{"dataset: archive"}{" and "}{"dataset: combined"}{" return errors. Measure the window with the "}{"dataset probe"}{" before assuming a range."}