Advanced API Overview

The Advanced API reference documents W3API JSON-RPC methods for indexed blockchain data retrieval across supported chains. Use it when your application needs normalized token, NFT, block, log, transaction, or chain statistics data without building and maintaining its own indexer.

The generated method reference is built from the OpenRPC specification at fern/openrpc/advanced-api/openrpc.json. The spec is the source of truth for method names, parameters, response schemas, examples, and grouping.


Endpoint

Advanced API requests use JSON-RPC 2.0 over HTTPS:

https://rpc.ankr.com/multichain/<apiKey>

Replace <apiKey> with your project API key. Request bodies include the JSON-RPC version, method name, params object, and request ID:

The interactive Try it playground uses a docs proxy to make sample requests without exposing a project API key. Production applications should call the multichain endpoint above with their own project API key.

1{
2 "jsonrpc": "2.0",
3 "method": "ankr_getTokenPrice",
4 "params": {
5 "blockchain": "eth",
6 "contractAddress": "0x990f341946a3fdb507ae7e52d17851b87168017c"
7 },
8 "id": 1
9}

Successful JSON-RPC responses include a result object. Failed JSON-RPC responses include an error object with error details. Advanced API can return HTTP 200 with a JSON-RPC error, so clients should inspect the response body before treating a request as successful.


Errors

Advanced API follows JSON-RPC 2.0 response semantics and can also return implementation-specific server errors.

CodeMessageMeaning
-32602Invalid paramsThe request contains invalid method parameters, such as an invalid address, blockchain, or page token.
-32603Internal errorThe upstream JSON-RPC service hit an internal error while processing the request.
-32000Server errorImplementation-defined upstream error, such as a missing transaction or backend parsing failure.
-32075Method disabledThe method is restricted by the active project or blockchain schema.
-32090Too many requestsThe upstream rate limit is exhausted. Retry after the delay in the error message, if provided.

The interactive Try it proxy can also return HTTP errors before a request reaches Advanced API.

HTTP statusMeaning
400Invalid JSON body or missing JSON-RPC method.
403Request origin is not allowed, or the method is not enabled in the docs proxy.
405Only POST requests are accepted.
413Request body exceeds the proxy size limit.
415Content-Type must be application/json.
429The docs proxy rate limit is exhausted.
500The docs proxy is not configured with an upstream Advanced API key.

Method Groups

The generated reference includes 12 methods grouped by use case:

  • Query API: blocks, logs, address interactions, and transaction lookups.
  • Token API: balances, currencies, token prices, token holders, and token holder counts.
  • NFT API: NFT ownership, NFT metadata, and NFT holder queries.

Use Quickstart to make a first request, then open Methods for the generated method list, request parameters, response schemas, and examples.