Web3Map read-only API reference

Understand available read operations and the access they require.

Web3Map compares crypto markets across exchanges, perpetual futures and DEX pools. The OpenAPI specification describes a selected set of existing read-only operations. It is a discovery reference, not an anonymous market-data feed or a promise of unrestricted API access.

Authentication and access

The subscription-plan endpoint below accepts anonymous reads. Market endpoints require a valid Web3Map Bearer session. They enforce account restrictions, venue visibility and request limits. A Free account receives the Free view; publishing this reference does not unlock other tiers.

This reference does not provide a long-lived developer key or an automated login flow. Use only a session you are authorized to use, and do not publish session tokens or include them in URLs. For product access, see the account guide.

GET endpointPurposeAccess
/api/billing/public-plansCurrent subscription plansAnonymous
/api/graphFree graph overview with restricted fieldsValid session
/api/opportunitiesFree spot opportunity viewValid session
/api/opportunities/perpFree perpetual opportunity viewValid session

Base URL: https://api.web3map.ink. The specification intentionally describes response objects conservatively; inspect actual authorized responses before depending on a field.

Try an anonymous read

curl --fail --show-error https://api.web3map.ink/api/billing/public-plans

Interpret responses correctly

  • A price difference is a monitoring signal. It does not prove that an order, transfer or profitable round trip can execute.
  • Check observation times and data availability. Static app introductions are product descriptions and contain no live quotes.
  • An authentication error, access denial, rate limit or unavailable response must not be interpreted as an empty successful result. Respect Retry-After when returned.
  • The reference includes no trading, payment, account mutation or operational endpoints.

For reading and citation, start with the arbitrage guide, cross-chain arbitrage use case, and crypto hack, depeg and price-crash alerts. The Cronos and AGIX first-detection cases preserve historical alerts and their sources.