PUBLIC READ API

API reference

The Arc Systems HTTP API is read-only. It exposes normalized market and account state for dashboards, analytics, partner integrations and monitoring. Transaction submission remains wallet-to-contract.

RESTJSONOpenAPI 3.1Version v1

Quickstart

The read API is served under the same origin at /api; Nginx proxies those requests to the local Node service. All values reflect live onchain state on chain 5042002.

curl -s https://arcc.systems/api/v1/market | jq

OpenAPI YAML OpenAPI JSON

GET/health

Service and Arc chain connectivity health. Does not expose the configured RPC URL.

200	API can reach Arc and chain ID matches 5042002.
502	Upstream RPC error.

GET/v1/meta

Protocol API version, chain, release version and configured Pool identity.

GET/v1/assets

Canonical assets known to the API, including token address, decimals and protocol role.

GET/v1/market

Current aggregate market state.

totalAssetsUsdc	Supplier assets plus receivable interest, normalized to decimal USDC.
availableLiquidityUsdc	USDC currently available for withdrawal or borrowing.
utilization	Decimal ratio, e.g. `0.72` = 72%.
supplyApr / borrowApr	Decimal annualized rates, e.g. `0.051` = 5.1%.
paused	Whether new-risk actions are paused.
liquidationsPaused	Whether liquidation emergency mode is active.

GET/v1/account/:address

Read an account’s supplied USDC, debt, borrow power, health factor and collateral balances.

{
  "address": "0x…",
  "supplyUsdc": "12500.0",
  "debtUsdc": "4200.0",
  "healthFactor": "1.84",
  "maxBorrowUsd": "7700.0",
}

Error format

{
  "error": "human-readable message",
  "code": "OPTIONAL_MACHINE_CODE",
  "requestId": "optional request id"
}

400 is used for invalid addresses or parameters, 429 for rate limits, 503 when the Pool is not configured, and 502 for upstream RPC failures.

Try the API

Choose an endpoint to send a live request.