API 문서

v1.0.0엔드포인트 80개, 실시간 스키마에서 읽음

Arc Testnet（체인 5042002） 위의 두 REST 표면이며, 둘 다 같은 노드에서 제공됩니다. 아직 어느 쪽도 전용 공개 주소가 없습니다.

아직 전용 API 주소가 없습니다

이 페이지는 계약이지 초대장이 아닙니다. 아래의 모든 엔드포인트는 존재하며 응답합니다. 오늘 그것들을 제공하는 유일한 주소는 이 사이트의 페이지가 렌더링될 때 쓰는 경로이며, 그것은 공개된 API 주소가 아닙니다. API 호스트명은 공지되지 않았고, API 키 시스템도 존재하지 않습니다.

제대로 개방될 것입니다. 날짜는 없으며 이 페이지가 지어내지도 않습니다. 전용 API 호스트명이 공개되면 기본 URL이 이 카드에 나타나고 이 안내는 사라집니다.

Arcscan에서 읽는 어떤 것도 여기에 의존하지 않습니다. 페이지는 저희 서버가 앞서 말한 사설 주소를 통해 그리므로, 공개 API가 열려 있든 아니든 모든 페이지는 똑같이 동작합니다.

표면은 둘, 노드는 하나

타입이 정의된 API는 /v1 아래에 있습니다. 이 사이트 자체가 이 표면에서 렌더링되므로, 페이지에서 볼 수 있는 것은 무엇이든 같은 형태의 JSON으로도 읽을 수 있습니다.

호환 API는 /api?module=…&action=…에 있습니다. 지갑, 인덱서, 배포 스크립트, 봇이 이미 사용하는 사실상 표준인 탐색기 REST 계약을 그대로 재현하므로, 기존 도구는 base URL 하나만 바꾸면 Arc를 가리킬 수 있습니다. result 안의 모든 스칼라 값은 그 계약이 요구하는 대로 문자열입니다.

GET /v1/blocks/latest
GET /api?module=proxy&action=eth_blockNumber
GET /api?module=account&action=balance&address=0x…

위의 예시는 메서드와 경로이며 앞에 호스트가 없습니다. 아직 공개된 API 기본 URL이 없어 적을 수 없습니다 — 이 페이지 상단의 안내를 보십시오.

규약

대소문자:: JSON 키는 snake_case입니다. 전송되는 주소와 해시는 소문자이며, 표시용 형태는 checksum 필드가 담습니다. 입력은 어떤 대소문자든 허용합니다.
큰 정수:: 2⁵³을 넘을 수 있는 모든 값 — 금액, 가스, 공급량 — 은 10진 문자열입니다. 블록 높이는 JSON 숫자입니다. 금액을 JavaScript number로 파싱하면 조용히 값이 손상됩니다.
금액:: 금액은 Money 객체로 전송됩니다. raw(정수 문자열), decimals, formatted(정확한 전체 정밀도), usd, symbol입니다. 소수 자릿수는 항상 계약에서 읽습니다. 심볼로 스케일을 추정하지 마십시오.
시간:: Unix 초이며 미리 포맷하지 않습니다. 블록 타임스탬프의 해상도는 1초인데 블록은 초당 약 두 개씩 도착하므로, 타임스탬프는 전순서를 이루지 않습니다. 이를 기준으로 정렬하거나 페이지를 나누지 마십시오.
페이지네이션:: 페이지 번호가 아니라 불투명 커서입니다. Arc에는 재구성이 없으므로 커서는 영구히 유효합니다. 윈도우 기반 엔드포인트는 실제로 스캔한 블록 범위도 함께 반환합니다.
오류:: {"error":{"code":"NOT_FOUND","message":"…","detail":null}}
코드: INVALID_INPUT(400), NOT_FOUND(404), RATE_LIMITED(429), CAPABILITY_UNAVAILABLE(501), UPSTREAM_ERROR(502), UPSTREAM_TIMEOUT(504).
캐싱:: 커밋된 블록 높이나 채굴된 트랜잭션 해시를 키로 하는 것은 모두 불변이며 Cache-Control: public, max-age=31536000, immutable과 함께 제공됩니다. 확률적 체인이 줄 수 없는 더 강한 보장이며, 이를 전제로 만들 가치가 있습니다.

타입이 정의된 API — /v1

/openapi.json에서 생성됨

메서드	경로	파라미터	반환	캐시
GET	/v1/chain	—	Chain identity, native and ERC-20 decimals, the live node capability map (including internal_transactions), and index coverage with its own plain-language summary	60s
GET	/v1/home	blocks?, txs?	Everything the home page renders: head, stats, latest blocks and transactions	no-store
GET	/v1/stats/summary	—	Latest height, measured block time, throughput and average fee	no-store
GET	/v1/stats/gas	—	Base fee, priority-fee percentiles, and the true cost of a transfer and a swap	no-store
GET	/v1/stream/head	—	Server-sent events — one `head` event per committed block, carrying `server_now`	stream
GET	/v1/blocks	cursor?, limit?	Paged block summaries, newest first	1s
GET	/v1/blocks/{ref}	ref	Full block detail. `ref` is a height, a 0x-hash or `latest`	immutable
GET	/v1/blocks/{ref}/txs	ref, cursor?, limit?	Transactions in one block	immutable
GET	/v1/txs	cursor?, limit?	Paged transaction summaries, newest first	1s
GET	/v1/txs/{tx_hash}	tx_hash	Transaction detail with decoded transfers and logs	immutable
GET	/v1/txs/{tx_hash}/trace	tx_hash, format?, cursor?, limit?	Call tree. Heavy — runs on a dedicated pool with a wall-clock budget	immutable
GET	/v1/txs/{tx_hash}/state	tx_hash, cursor?, limit?	Balance, nonce and storage diff. Needs pre-block state, so bounded by pruning	immutable
GET	/v1/txs/{tx_hash}/raw	tx_hash	Verbatim node JSON for the transaction and its receipt	immutable
GET	/v1/address/{addr}	addr	Balance at a pinned height, nonce, code, proxy probe and creation record	5s
GET	/v1/address/{addr}/activity	addr, cursor?, limit?, kind?, token?	Value flow reconstructed from logs over an explicitly stated block window	5s
GET	/v1/address/{addr}/logs	addr, cursor?, limit?, topic0?	Logs emitted by or referencing the address	5s
GET	/v1/address/{addr}/tokens	addr, sort?	Token balances observed in the scanned window	5s
GET	/v1/address/{addr}/contract	addr	Bytecode, proxy probe and creation record	30s
GET	/v1/address/{addr}/txs	addr, cursor?, limit?	501 CAPABILITY_UNAVAILABLE — an address's transaction history is not listable here	—
GET	/v1/tokens/{addr}	addr	Token metadata read from the contract, plus supply	30s
GET	/v1/tokens/{addr}/transfers	addr, cursor?, limit?	Transfers over an explicitly stated block window	5s
GET	/v1/tokens/{addr}/holders	addr, cursor?, limit?	501 CAPABILITY_UNAVAILABLE — a complete holder list is not available here	—
GET	/v1/search	q	Exact resolution to a destination, or a disambiguation list	5s
GET	/v1/search/suggest	q?, limit?	Partial and name-prefix matches, for type-ahead	5s
POST	/v1/decode	—	Selector and, where the signature is known, the decoded call	—
GET	/v1/export/limits	—	The export row cap, block-span cap and rate limit, plus the indexed range	—
GET	/v1/export/resolve	from_date?, to_date?, from_block?, to_block?	A date range mapped onto blocks, with `exact` false where a bound was clamped rather than resolved	—
GET	/v1/export/{dataset}/csv	dataset, address, from_block?, to_block?, from_date?, to_date?, order?	Streamed `text/csv` for one address — capped, rate limited separately, and self-describing when a cap bites	no-store
GET	/v1/actions/categories	include_signatures?	The category dictionary and the signature table behind it	명시되지 않음
GET	/v1/address/{addr}/facts	addr	Funded By, first and latest transaction	명시되지 않음
GET	/v1/ads/click/{creative_id}	creative_id	First-party redirect for a sponsored link	명시되지 않음
GET	/v1/ads/slots	—	Sponsorship slots and creatives	명시되지 않음
GET	/v1/agents	cursor?, limit?, sort?	ERC-8004 agents on Arc, with their latest score and who reported it	명시되지 않음
GET	/v1/agents/{agent_id}	agent_id	One agent: identity, score per subject, and full feedback history	명시되지 않음
GET	/v1/agents/reporters	cursor?, limit?	Every address that has submitted ERC-8004 feedback, ranked	명시되지 않음
GET	/v1/approvals/{addr}	addr, cursor?, limit?, live?	Outstanding ERC-20/721/1155 approvals granted by an address	명시되지 않음
GET	/v1/blocks/{ref}/actions	ref	What the transactions in this block did	명시되지 않음
GET	/v1/charts	granularity?	Charts index — catalogue and thumbnails	명시되지 않음
GET	/v1/charts/{metric}	metric, granularity?, days?, from?, to?, limit?	One chart series	명시되지 않음
GET	/v1/charts/{metric}/csv	metric, granularity?, days?, from?, to?, limit?	One chart series as CSV	명시되지 않음
GET	/v1/charts/overview	—	Overview stat grid	명시되지 않음
GET	/v1/charts/top	panel?, cursor?, limit?	Top Statistics — ranked panels	명시되지 않음
POST	/v1/contracts/{addr}/encode	addr	Encode a state-changing call to calldata for a wallet to sign	명시되지 않음
POST	/v1/contracts/{addr}/read	addr	Execute one view function through eth_call	명시되지 않음
GET	/v1/contracts/{addr}/source	addr	Verified source, ABI and compiler settings	명시되지 않음
GET	/v1/contracts/verified	limit?, cursor?	Recently verified contracts on this chain	명시되지 않음
GET	/v1/explore/accounts	cursor?, limit?	Top accounts by native USDC balance	명시되지 않음
GET	/v1/explore/contracts	cursor?, limit?, filter?	Deployed contracts, newest first, with verification state	명시되지 않음
GET	/v1/explore/directory	q?, kind?, cursor?, limit?	Directory of named on-chain entities	명시되지 않음
GET	/v1/explore/internal-txs	cursor?, limit?, address?, type?, block?	Contract internal transactions (value-carrying frames)	명시되지 않음
GET	/v1/explore/labels	—	Label cloud	명시되지 않음
GET	/v1/explore/labels/{slug}	slug, cursor?, limit?	Addresses carrying one label	명시되지 않음
GET	/v1/explore/token-transfers	cursor?, limit?, token?, standard?, kind?	Token transfers across the chain, newest first	명시되지 않음
GET	/v1/explore/tokens	cursor?, limit?, standard?	Token tracker — ERC-20 / 721 / 1155 by transfer activity	명시되지 않음
GET	/v1/explore/top-stats	window?, size?, panel?, cursor?	Top Statistics — leaderboards over a chosen block window	명시되지 않음
GET	/v1/export/filter/{dataset}/csv	dataset, address?, role?, counterparty?, token?, method?, min_value_raw?, max_value_raw?, status?, creations_only?, standard?, kind?, from_block?, to_block?, order?	Stream an Advanced Filter result as CSV	명시되지 않음
GET	/v1/filter/limits	—	Advanced Filter bounds	명시되지 않음
GET	/v1/filter/token-transfers	address?, role?, counterparty?, token?, method?, min_value?, max_value?, status?, creations_only?, standard?, kind?, from_block?, to_block?, from_date?, to_date?, cursor?, limit?	Token transfers matching a composed query	명시되지 않음
GET	/v1/filter/transactions	address?, role?, counterparty?, token?, method?, min_value?, max_value?, status?, creations_only?, standard?, kind?, from_block?, to_block?, from_date?, to_date?, cursor?, limit?	Transactions matching a composed query	명시되지 않음
GET	/v1/network/status	—	What Arcscan is currently serving	명시되지 않음
GET	/v1/network/validators	—	The Arc proposer set, with the measured rotation schedule	명시되지 않음
GET	/v1/signatures	keys	Resolve 4-byte selectors and event topic0s	명시되지 않음
GET	/v1/signatures/resolve	keys, address?, registry?	Resolve selectors and topic0s with provenance and collisions	명시되지 않음
GET	/v1/stats/tx-history	days?	Transactions per complete UTC day	명시되지 않음
GET	/v1/tokens/{addr}/concentration	addr	Token Concentration	명시되지 않음
GET	/v1/tokens/{addr}/info	addr	Curated token information	명시되지 않음
POST	/v1/tokens/{addr}/info/submit	addr	Propose token information, behind a verified proof of ownership	명시되지 않음
GET	/v1/tokens/{addr}/logo	addr	The token logo, if one has been published	명시되지 않음
GET	/v1/tokens/{addr}/ownership	addr	Whether ownership of this contract can be proved, and against what	명시되지 않음
POST	/v1/tokens/{addr}/ownership/challenge	addr	Issue a one-time message to sign	명시되지 않음
POST	/v1/tokens/{addr}/ownership/verify	addr	Check a signature against the contract's creator or owner	명시되지 않음
GET	/v1/txs/{tx_hash}/actions	tx_hash	What this transaction did	명시되지 않음
POST	/v1/verify/{addr}	addr	Submit source for verification	명시되지 않음
GET	/v1/verify/compilers	—	Solidity compiler builds, newest first	명시되지 않음
GET	/v1/verify/jobs/{job_id}	job_id	Poll a verification job	명시되지 않음
GET	/v1/verify/options	—	What the verification form needs to render	명시되지 않음

'반환' 열은 영어로만 제공합니다. API 자체의 계약 텍스트이기 때문입니다.

헤드 스트림

/v1/stream/head는 커밋된 블록마다 head 이벤트를 하나씩 내보내는 server-sent event 스트림입니다. 페이로드에 server_now가 들어 있어, 클라이언트는 브라우저 시계를 믿는 대신 시계 오차를 보정할 수 있습니다.

event: head
data: {"height":54190133,"hash":"0x…","timestamp":1785345456,"tx_count":11,"server_now":1785345456}

대기 트랜잭션 스트림은 없습니다. 이 체인에서는 mempool 네임스페이스가 비활성화되어 있고, 0.5초 블록 시간에서는 대기 화면이 트랜잭션을 보여 주는 시간이 그것을 읽는 시간보다 짧습니다.

호환 API — /api

그대로 교체 가능

봉투: {"status":"1","message":"OK","result":…}. 비어 있지만 유효한 응답은 {"status":"0","message":"No transactions found","result":[]}를 반환하고, 오류는 {"status":"0","message":"NOTOK","result":"Error! …"}를 반환합니다. module=proxy는 대신 순수 JSON-RPC 봉투를 반환합니다. GET과 form-encoded POST를 모두 허용합니다.

메서드	경로	파라미터	반환	캐시
GET	/api	—	Etherscan-compatible REST surface — `?module=…&action=…`, see the table below	varies
POST	/api	—	The same surface, form-encoded, for clients that POST	varies
GET	/mcp	—	MCP endpoint discovery	명시되지 않음
POST	/mcp	—	Model Context Protocol endpoint (JSON-RPC 2.0)	명시되지 않음

스키마가 기술하는 경로는 하나뿐입니다. 이 표면은 라우트가 아니라 쿼리 문자열의 module과 action으로 분기하기 때문입니다. 이 값들은 OpenAPI로 열거할 수 없어 아래에 나열합니다.

module	action	비고
account	balance	네이티브 잔액, 소수점 18자리 정수 문자열
account	balancemulti	호출당 최대 20개 주소
account	tokenbalance	진짜 ERC-20 조회. 계약 자신의 소수 스케일을 반환합니다
account	tokentx	스캔된 구간에서 제공. startblock과 endblock이 필요합니다
account	txlist	한 주소가 보내거나 받은 트랜잭션. 색인에서 읽습니다
account	txlistinternal	가치를 옮기는 내부 프레임. 주소별 또는 트랜잭션별
account	addresstokenbalance	한 주소가 보유한 모든 토큰 잔액
block	getblockreward	blockReward는 트랜잭션 수수료의 합계입니다. 발행도 엉클 보상도 없습니다
block	getblocknobytime	높이에 대한 이진 탐색. 불변이며 영구 캐시됩니다
block	getblockcountdown	상수가 아니라 실측 블록 시간을 사용합니다
transaction	getstatus	실행 상태
transaction	gettxreceiptstatus	영수증 상태
logs	getLogs	범위 제한 있음. 범위를 넘는 요청에는 최대 폭을 명시해 응답합니다
proxy	eth_* passthrough	블록, 트랜잭션, call, code, storage, gas 및 raw 전송 메서드
contract	getabi	Arcscan에서 검증된 컨트랙트의 ABI
contract	getsourcecode	검증된 소스, 컴파일러 설정, ABI
contract	getcontractcreation	쉼표로 구분한 최대 5개 주소
token	tokenholderlist	토큰 하나의 보유자와 잔액
stats	ethsupply	네이티브 공급량, 소수점 18자리 정수 문자열
stats	ethprice	가스 토큰은 구조상 달러이므로 1.00을 보고합니다
stats	tokensupply	총 공급량. 컨트랙트에서 직접 읽습니다
stats	dailytxnfee	완전한 UTC 하루 단위의 트랜잭션 수수료 합계
stats	dailynewaddress	완전한 UTC 하루 단위로 처음 나타난 주소

반드시 알아야 할 Arc 고유 동작

가스는 달러로 지불합니다:: 가스 토큰은 USDC입니다. 수수료, 잔액, 트랜잭션 금액이 모두 달러로 표시되며, Arcscan은 오라클 없이 정확한 달러 값을 보고합니다.
호환 API에서 값은 소수점 18자리로 유지됩니다:: value, gasPrice, gasUsed, cumulativeGasUsed는 소수점 18자리 정수 문자열 그대로입니다. 10¹⁸으로 나누면 올바른 달러 값이 나옵니다. 저희가 “친절하게” 스케일을 바꿔 주는 일은 결코 없습니다. 그렇게 하면 연동된 모든 봇이 1조 배 어긋납니다.
하나의 달러, 두 가지 표현:: 네이티브 잔액은 소수 18자리이고, 같은 자산의 ERC-20 인터페이스는 6자리입니다. 프리컴파일이 둘을 동등하게 유지하므로 erc20 = native / 10^12이 정확히 성립합니다. account.balance는 네이티브 값을, account.tokenbalance는 ERC-20 값을 반환합니다. 둘 다 맞습니다. 더하면 같은 달러를 두 번 세게 됩니다.
토큰 소수 자릿수는 절대 가정하지 않습니다:: tokenDecimal은 언제나 계약에서 읽습니다. 이 체인에서는 두 계약이 같은 심볼을 쓰면서 다른 스케일을 사용할 수 있으므로, 심볼–소수 자릿수 대응표는 구조적으로 틀립니다.
최종성은 결정적입니다:: confirmations는 호환을 위해 함께 내보내며, 그 옆에 추가로 isFinalized를 내보냅니다. 확률적 안전 구간은 없습니다. 커밋된 블록은 최종입니다. Arcscan은 자체 화면에서 확인 수를 표시하지 않습니다.
필드 이름의 철자는 그대로입니다:: 호환 표면의 메서드명과 필드명은 프로토콜 식별자이므로 그대로 재현되며, 덕분에 기존 클라이언트가 계속 동작합니다. Arc의 것은 값뿐입니다.

Arcscan이 응답하지 않는 액션

이들은 HTTP 200과 함께 표준 오류 봉투를 반환합니다. 클라이언트 라이브러리가 그대로 죽지 않도록 404는 쓰지 않습니다. 하나의 상투적인 문장 대신 각자 자기만의 이유를 담습니다 — 저희가 만들지 않는 색인, Arc 자체의 구조적 성질, 또는 다른 이름으로 동작하는 엔드포인트.

account.getminedblocks
account.tokennfttx
account.token1155tx
account.addresstokennftbalance
token.tokeninfo
contract.verifysourcecode

NFT 이력 관련 두 액션이 가장 많이 요청되지만, 둘 다 주소 기준으로는 답할 수 없습니다. ERC-20 형태인 account.tokentx는 답할 수 있으며, startblock과 endblock을 명시해야 합니다.

제한

요청 제한:: IP별 토큰 버킷이며, 애플리케이션이 아니라 엣지에서 적용됩니다. 외부 호출자에게 적용될 한도는 아직 정해지지 않았으므로 여기에 숫자를 적지 않습니다. API가 열릴 때 이 페이지에 싣겠습니다.
로그 범위:: 로그 질의는 최대 블록 폭으로 제한됩니다. 범위를 넘는 요청은 조용히 잘리지 않고, 메시지에 최대치를 명시하여 거부됩니다.
무거운 엔드포인트:: trace 및 state-diff 엔드포인트는 실시간 예산과 응답 크기 상한을 가진 작은 전용 풀에서 실행되며, 멈추는 대신 truncated: true를 보고합니다.

메서드

경로

파라미터

반환

캐시

GET

/v1/chain

—

Chain identity, native and ERC-20 decimals, the live node capability map (including internal_transactions), and index coverage with its own plain-language summary

60s

GET

/v1/home

blocks?, txs?

Everything the home page renders: head, stats, latest blocks and transactions

no-store

GET

/v1/stats/summary

—

Latest height, measured block time, throughput and average fee

no-store

GET

/v1/stats/gas

—

Base fee, priority-fee percentiles, and the true cost of a transfer and a swap

no-store

GET

/v1/stream/head

—

Server-sent events — one `head` event per committed block, carrying `server_now`

stream

GET

/v1/blocks

cursor?, limit?

Paged block summaries, newest first

GET

/v1/blocks/{ref}

ref

Full block detail. `ref` is a height, a 0x-hash or `latest`

immutable

GET

/v1/blocks/{ref}/txs

ref, cursor?, limit?

Transactions in one block

immutable

GET

/v1/txs

cursor?, limit?

Paged transaction summaries, newest first

GET

/v1/txs/{tx_hash}

tx_hash

Transaction detail with decoded transfers and logs

immutable

GET

/v1/txs/{tx_hash}/trace

tx_hash, format?, cursor?, limit?

Call tree. Heavy — runs on a dedicated pool with a wall-clock budget

immutable

GET

/v1/txs/{tx_hash}/state

tx_hash, cursor?, limit?

Balance, nonce and storage diff. Needs pre-block state, so bounded by pruning

immutable

GET

/v1/txs/{tx_hash}/raw

tx_hash

Verbatim node JSON for the transaction and its receipt

immutable

GET

/v1/address/{addr}

addr

Balance at a pinned height, nonce, code, proxy probe and creation record

GET

/v1/address/{addr}/activity

addr, cursor?, limit?, kind?, token?

Value flow reconstructed from logs over an explicitly stated block window

GET

/v1/address/{addr}/logs

addr, cursor?, limit?, topic0?

Logs emitted by or referencing the address

GET

/v1/address/{addr}/tokens

addr, sort?

Token balances observed in the scanned window

GET

/v1/address/{addr}/contract

addr

Bytecode, proxy probe and creation record

30s

GET

/v1/address/{addr}/txs

addr, cursor?, limit?

501 CAPABILITY_UNAVAILABLE — an address's transaction history is not listable here

—

GET

/v1/tokens/{addr}

addr

Token metadata read from the contract, plus supply

30s

GET

/v1/tokens/{addr}/transfers

addr, cursor?, limit?

Transfers over an explicitly stated block window

GET

/v1/tokens/{addr}/holders

addr, cursor?, limit?

501 CAPABILITY_UNAVAILABLE — a complete holder list is not available here

—

GET

/v1/search

Exact resolution to a destination, or a disambiguation list

GET

/v1/search/suggest

q?, limit?

Partial and name-prefix matches, for type-ahead

POST

/v1/decode

—

Selector and, where the signature is known, the decoded call

—

GET

/v1/export/limits

—

The export row cap, block-span cap and rate limit, plus the indexed range

—

GET

/v1/export/resolve

from_date?, to_date?, from_block?, to_block?

A date range mapped onto blocks, with `exact` false where a bound was clamped rather than resolved

—

GET

/v1/export/{dataset}/csv

dataset, address, from_block?, to_block?, from_date?, to_date?, order?

Streamed `text/csv` for one address — capped, rate limited separately, and self-describing when a cap bites

no-store

GET

/v1/actions/categories

include_signatures?

The category dictionary and the signature table behind it

명시되지 않음

GET

/v1/address/{addr}/facts

addr

Funded By, first and latest transaction

명시되지 않음

GET

/v1/ads/click/{creative_id}

creative_id

First-party redirect for a sponsored link

명시되지 않음

GET

/v1/ads/slots

—

Sponsorship slots and creatives

명시되지 않음

GET

/v1/agents

cursor?, limit?, sort?

ERC-8004 agents on Arc, with their latest score and who reported it

명시되지 않음

GET

/v1/agents/{agent_id}

agent_id

One agent: identity, score per subject, and full feedback history

명시되지 않음

GET

/v1/agents/reporters

cursor?, limit?

Every address that has submitted ERC-8004 feedback, ranked

명시되지 않음

GET

/v1/approvals/{addr}

addr, cursor?, limit?, live?

Outstanding ERC-20/721/1155 approvals granted by an address

명시되지 않음

GET

/v1/blocks/{ref}/actions

ref

What the transactions in this block did

명시되지 않음

GET

/v1/charts

granularity?

Charts index — catalogue and thumbnails

명시되지 않음

GET

/v1/charts/{metric}

metric, granularity?, days?, from?, to?, limit?

One chart series

명시되지 않음

GET

/v1/charts/{metric}/csv

metric, granularity?, days?, from?, to?, limit?

One chart series as CSV

명시되지 않음

GET

/v1/charts/overview

—

Overview stat grid

명시되지 않음

GET

/v1/charts/top

panel?, cursor?, limit?

Top Statistics — ranked panels

명시되지 않음

POST

/v1/contracts/{addr}/encode

addr

Encode a state-changing call to calldata for a wallet to sign

명시되지 않음

POST

/v1/contracts/{addr}/read

addr

Execute one view function through eth_call

명시되지 않음

GET

/v1/contracts/{addr}/source

addr

Verified source, ABI and compiler settings

명시되지 않음

GET

/v1/contracts/verified

limit?, cursor?

Recently verified contracts on this chain

명시되지 않음

GET

/v1/explore/accounts

cursor?, limit?

Top accounts by native USDC balance

명시되지 않음

GET

/v1/explore/contracts

cursor?, limit?, filter?

Deployed contracts, newest first, with verification state

명시되지 않음

GET

/v1/explore/directory

q?, kind?, cursor?, limit?

Directory of named on-chain entities

명시되지 않음

GET

/v1/explore/internal-txs

cursor?, limit?, address?, type?, block?

Contract internal transactions (value-carrying frames)

명시되지 않음

GET

/v1/explore/labels

—

Label cloud

명시되지 않음

GET

/v1/explore/labels/{slug}

slug, cursor?, limit?

Addresses carrying one label

명시되지 않음

GET

/v1/explore/token-transfers

cursor?, limit?, token?, standard?, kind?

Token transfers across the chain, newest first

명시되지 않음

GET

/v1/explore/tokens

cursor?, limit?, standard?

Token tracker — ERC-20 / 721 / 1155 by transfer activity

명시되지 않음

GET

/v1/explore/top-stats

window?, size?, panel?, cursor?

Top Statistics — leaderboards over a chosen block window

명시되지 않음

GET

/v1/export/filter/{dataset}/csv

dataset, address?, role?, counterparty?, token?, method?, min_value_raw?, max_value_raw?, status?, creations_only?, standard?, kind?, from_block?, to_block?, order?

Stream an Advanced Filter result as CSV

명시되지 않음

GET

/v1/filter/limits

—

Advanced Filter bounds

명시되지 않음

GET

/v1/filter/token-transfers

address?, role?, counterparty?, token?, method?, min_value?, max_value?, status?, creations_only?, standard?, kind?, from_block?, to_block?, from_date?, to_date?, cursor?, limit?

Token transfers matching a composed query

명시되지 않음

GET

/v1/filter/transactions

address?, role?, counterparty?, token?, method?, min_value?, max_value?, status?, creations_only?, standard?, kind?, from_block?, to_block?, from_date?, to_date?, cursor?, limit?

Transactions matching a composed query

명시되지 않음

GET

/v1/network/status

—

What Arcscan is currently serving

명시되지 않음

GET

/v1/network/validators

—

The Arc proposer set, with the measured rotation schedule

명시되지 않음

GET

/v1/signatures

keys

Resolve 4-byte selectors and event topic0s

명시되지 않음

GET

/v1/signatures/resolve

keys, address?, registry?

Resolve selectors and topic0s with provenance and collisions

명시되지 않음

GET

/v1/stats/tx-history

days?

Transactions per complete UTC day

명시되지 않음

GET

/v1/tokens/{addr}/concentration

addr

Token Concentration

명시되지 않음

GET

/v1/tokens/{addr}/info

addr

Curated token information

명시되지 않음

POST

/v1/tokens/{addr}/info/submit

addr

Propose token information, behind a verified proof of ownership

명시되지 않음

GET

/v1/tokens/{addr}/logo

addr

The token logo, if one has been published

명시되지 않음

GET

/v1/tokens/{addr}/ownership

addr

Whether ownership of this contract can be proved, and against what

명시되지 않음

POST

/v1/tokens/{addr}/ownership/challenge

addr

Issue a one-time message to sign

명시되지 않음

POST

/v1/tokens/{addr}/ownership/verify

addr

Check a signature against the contract's creator or owner

명시되지 않음

GET

/v1/txs/{tx_hash}/actions

tx_hash

What this transaction did

명시되지 않음

POST

/v1/verify/{addr}

addr

Submit source for verification

명시되지 않음

GET

/v1/verify/compilers

—

Solidity compiler builds, newest first

명시되지 않음

GET

/v1/verify/jobs/{job_id}

job_id

Poll a verification job

명시되지 않음

GET

/v1/verify/options

—

What the verification form needs to render

명시되지 않음

메서드

경로

파라미터

반환

캐시

GET

/api

—

Etherscan-compatible REST surface — `?module=…&action=…`, see the table below

varies

POST

/api

—

The same surface, form-encoded, for clients that POST

varies

GET

/mcp

—

MCP endpoint discovery

명시되지 않음

POST

/mcp

—

Model Context Protocol endpoint (JSON-RPC 2.0)

명시되지 않음

module

action

비고

account

balance

네이티브 잔액, 소수점 18자리 정수 문자열

account

balancemulti

호출당 최대 20개 주소

account

tokenbalance

진짜 ERC-20 조회. 계약 자신의 소수 스케일을 반환합니다

account

tokentx

스캔된 구간에서 제공. startblock과 endblock이 필요합니다

account

txlist

한 주소가 보내거나 받은 트랜잭션. 색인에서 읽습니다

account

txlistinternal

가치를 옮기는 내부 프레임. 주소별 또는 트랜잭션별

account

addresstokenbalance

한 주소가 보유한 모든 토큰 잔액

block

getblockreward

blockReward는 트랜잭션 수수료의 합계입니다. 발행도 엉클 보상도 없습니다

block

getblocknobytime

높이에 대한 이진 탐색. 불변이며 영구 캐시됩니다

block

getblockcountdown

상수가 아니라 실측 블록 시간을 사용합니다

transaction

getstatus

실행 상태

transaction

gettxreceiptstatus

영수증 상태

logs

getLogs

범위 제한 있음. 범위를 넘는 요청에는 최대 폭을 명시해 응답합니다

proxy

eth_* passthrough

블록, 트랜잭션, call, code, storage, gas 및 raw 전송 메서드

contract

getabi

Arcscan에서 검증된 컨트랙트의 ABI

contract

getsourcecode

검증된 소스, 컴파일러 설정, ABI

contract

getcontractcreation

쉼표로 구분한 최대 5개 주소

token

tokenholderlist

토큰 하나의 보유자와 잔액

stats

ethsupply

네이티브 공급량, 소수점 18자리 정수 문자열

stats

ethprice

가스 토큰은 구조상 달러이므로 1.00을 보고합니다

stats

tokensupply

총 공급량. 컨트랙트에서 직접 읽습니다

stats

dailytxnfee

완전한 UTC 하루 단위의 트랜잭션 수수료 합계

stats

dailynewaddress

완전한 UTC 하루 단위로 처음 나타난 주소