Skip to main content
Glama

Token API by The Graph

Server Details

Query real-time blockchain token data across EVM and Solana networks. Access token balances, transfers, prices, holders, NFT ownership, DEX swaps, and liquidity pools. Supports Ethereum, Base, Arbitrum, BSC, Polygon, Solana, and more.

Status
Unhealthy
Last Tested
Transport
Streamable HTTP
URL

See and control every tool call

Log every tool call with full inputs and outputs
Control which tools are enabled per connector
Manage credentials once, use from any MCP client
Monitor uptime and get alerted when servers go down

Available Tools

41 tools
getV1EvmBalancesTry in Inspector

Returns ERC-20 token balances for a wallet address.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • address (Required): Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • contract: Filter by contract addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • include_null_balances: Include zero/null balances in results

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "last_update": "string", "last_update_block_num": 1.5, "last_update_timestamp": 1.5, "decimals": "unknown_type", "amount": "string", "symbol": "unknown_type", "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "value": 1.5, "name": "unknown_type", "network": "arbitrum-one", "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
addressYesFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
contractNoFilter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
include_null_balancesNoInclude zero/null balances in results
getV1EvmBalancesHistoricalTry in Inspector

Returns wallet ERC-20 token balance changes over time in OHLCV format.

OHLCV historical depth is subject to plan restrictions.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • address (Required): Filter by address

  • contract: Filter by contract addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • interval: The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).*Plan restricted.

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "datetime": "string", "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "close": 1.5, "decimals": 1.5, "open": 1.5, "low": 1.5, "symbol": "string", "name": "string", "network": "arbitrum-one", "high": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
addressYesFilter by address
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
contractNoFilter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
intervalNoThe interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).<br>*Plan restricted.1d
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2015-01-01
getV1EvmBalancesHistoricalNativeTry in Inspector

Returns wallet Native balance changes over time in OHLCV format.

OHLCV historical depth is subject to plan restrictions.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • address (Required): Filter by address

  • interval: The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).*Plan restricted.

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "datetime": "string", "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "close": 1.5, "decimals": 1.5, "open": 1.5, "low": 1.5, "symbol": "string", "name": "string", "network": "arbitrum-one", "high": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
addressYesFilter by address
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
intervalNoThe interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).<br>*Plan restricted.1d
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2015-01-01
getV1EvmBalancesNativeTry in Inspector

Returns EVM native balances for wallet addresses.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • address (Required): Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "last_update": "string", "last_update_block_num": 1.5, "last_update_timestamp": 1.5, "decimals": "unknown_type", "amount": "string", "symbol": "unknown_type", "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "value": 1.5, "name": "unknown_type", "network": "arbitrum-one" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
addressYesFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
getV1EvmDexesTry in Inspector

Returns all supported EVM DEXs.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "factory": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "protocol": "uniswap_v1", "uaw": 1.5, "transactions": 1.5, "network": "arbitrum-one", "last_activity": "string" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
getV1EvmHoldersTry in Inspector

Returns top token holders ranked by ERC-20 balance.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • contract (Required): Filter by contract address

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "last_update": "string", "last_update_block_num": 1.5, "last_update_timestamp": 1.5, "decimals": "unknown_type", "amount": "string", "symbol": "unknown_type", "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "value": 1.5, "name": "unknown_type", "network": "arbitrum-one", "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
contractYesFilter by contract address
getV1EvmHoldersNativeTry in Inspector

Returns top token holders ranked by Native balance.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "last_update": "string", "last_update_block_num": 1.5, "last_update_timestamp": 1.5, "decimals": "unknown_type", "amount": "string", "symbol": "unknown_type", "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "value": 1.5, "name": "unknown_type", "network": "arbitrum-one" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
getV1EvmNftCollectionsTry in Inspector

Returns NFT collection metadata, supply stats, owner count, and transfer history.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • contract (Required): Filter by contract address

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "contract_creation": "string", "contract_creator": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "total_unique_supply": 1.5, "symbol": "unknown_type", "name": "unknown_type", "owners": 1.5, "network": "arbitrum-one", "total_supply": 1.5, "total_transfers": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
contractYesFilter by contract address
getV1EvmNftHoldersTry in Inspector

Returns wallet addresses holding NFT collection tokens with quantity and percentage distribution.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • contract (Required): Filter by contract address

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "token_standard": "ERC721", "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "unique_tokens": 1.5, "percentage": 1.5, "network": "arbitrum-one", "quantity": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
contractYesFilter by contract address
getV1EvmNftItemsTry in Inspector

Returns NFT token metadata, attributes, current owner, and media URIs.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • contract (Required): Filter by contract address

  • token_id: Token IDSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "token_id": "5712", "image": "unknown_type", "name": "unknown_type", "token_standard": "ERC721", "uri": "unknown_type", "attributes": [ { "trait_type": "string", "value": "string", "display_type": "string" } ], "network": "arbitrum-one", "description": "unknown_type" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
contractYesFilter by contract address
token_idNoToken ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
getV1EvmNftOwnershipsTry in Inspector

Returns NFT tokens owned by a wallet address with metadata and ownership information.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • address (Required): Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • contract: Filter by contract addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • token_id: Token IDSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • token_standard: Token standard

  • include_null_balances: Include zero/null balances in results

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "token_id": "5712", "symbol": "unknown_type", "name": "unknown_type", "token_standard": "ERC721", "network": "arbitrum-one" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
addressYesFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
contractNoFilter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
token_idNoToken ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
token_standardNoToken standard
include_null_balancesNoInclude zero/null balances in results
getV1EvmNftSalesTry in Inspector

Returns NFT marketplace sales with price, buyer, seller, and transaction data.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • transaction_id: Filter by transaction hashSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • contract: Filter by contract addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • token_id: Token IDSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • from_address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • to_address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • start_block: Filter by block number

  • end_block: Filter by block number

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "block_num": 1.5, "datetime": "string", "timestamp": 1.5, "offerer": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "symbol": "unknown_type", "recipient": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "token_id": "5712", "transaction_id": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca", "name": "unknown_type", "sale_amount": 1.5, "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "network": "arbitrum-one", "sale_currency": "string" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
contractNoFilter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
token_idNoToken ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
end_blockNoFilter by block number
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2025-01-01
to_addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
start_blockNoFilter by block number
from_addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
transaction_idNoFilter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
getV1EvmNftTransfersTry in Inspector

Returns NFT transfer events including mints, burns, and ownership changes.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • type: Transfer category

  • transaction_id: Filter by transaction hashSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • contract: Filter by contract addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • token_id: Token IDSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • from_address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • to_address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • start_block: Filter by block number

  • end_block: Filter by block number

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "block_num": 1.5, "datetime": "string", "timestamp": 1.5, "symbol": "unknown_type", "amount": 1.5, "token_id": "5712", "transaction_id": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca", "name": "unknown_type", "transfer_type": "string", "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "token_standard": "ERC721", "to": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "network": "arbitrum-one", "@type": "BURN" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
typeNoTransfer category
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
contractNoFilter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
token_idNoToken ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
end_blockNoFilter by block number
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2025-01-01
to_addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
start_blockNoFilter by block number
from_addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
transaction_idNoFilter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
getV1EvmPoolsTry in Inspector

Returns DEX pool metadata including tokens, fees and protocol.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • factory: Filter by factory addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • pool: Filter by pool addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • input_token: Filter by contract addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • output_token: Filter by contract addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • protocol: Protocol name

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "factory": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f", "protocol": "uniswap_v1", "input_token": { "address": "unknown_type", "symbol": "unknown_type", "decimals": "unknown_type" }, "network": "arbitrum-one", "output_token": { "address": "unknown_type", "symbol": "unknown_type", "decimals": "unknown_type" } } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
poolNoFilter by pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
factoryNoFilter by factory address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
protocolNoProtocol name
input_tokenNoFilter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
output_tokenNoFilter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
getV1EvmPoolsOhlcTry in Inspector

Returns OHLCV price data for liquidity pools.

OHLCV historical depth is subject to plan restrictions.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • pool (Required): Filter by pool address

  • interval: The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).*Plan restricted.

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "datetime": "string", "ticker": "string", "pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "close": 1.5, "low": 1.5, "open": 1.5, "volume": 1.5, "transactions": 1.5, "network": "arbitrum-one", "uaw": 1.5, "high": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
poolYesFilter by pool address
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
intervalNoThe interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).<br>*Plan restricted.1d
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2015-01-01
getV1EvmSwapsTry in Inspector

Returns DEX swaps events with input & output token amounts.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • transaction_id: Filter by transaction hashSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • factory: Filter by factory addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • pool: Filter by pool addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • caller: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • sender: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • recipient: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • input_contract: Filter by contract addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • output_contract: Filter by contract addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • protocol: Protocol name

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • start_block: Filter by block number

  • end_block: Filter by block number

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "block_num": 1.5, "datetime": "string", "timestamp": 1.5, "price": 1.5, "summary": "string", "output_amount": "string", "transaction_id": "string", "sender": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "input_token": { "address": "unknown_type", "symbol": "unknown_type", "decimals": "unknown_type" }, "protocol": "uniswap_v1", "input_value": 1.5, "network": "arbitrum-one", "factory": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f", "output_token": { "address": "unknown_type", "symbol": "unknown_type", "decimals": "unknown_type" }, "pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "recipient": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "input_amount": "string", "output_value": 1.5, "caller": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "price_inv": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
poolNoFilter by pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
callerNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
senderNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
factoryNoFilter by factory address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
protocolNoProtocol name
end_blockNoFilter by block number
recipientNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2015-01-01
start_blockNoFilter by block number
input_contractNoFilter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
transaction_idNoFilter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
output_contractNoFilter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
getV1EvmTokensTry in Inspector

Returns ERC-20 token metadata including supply and holder count.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • contract (Required): Filter by contract address

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "last_update": "string", "last_update_block_num": 1.5, "last_update_timestamp": 1.5, "circulating_supply": 1.5, "decimals": "unknown_type", "symbol": "unknown_type", "holders": 1.5, "name": "unknown_type", "network": "arbitrum-one", "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "total_supply": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
contractYesFilter by contract address
getV1EvmTokensNativeTry in Inspector

Returns Native metadata including supply and holder count.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "last_update": "string", "last_update_block_num": 1.5, "last_update_timestamp": 1.5, "circulating_supply": 1.5, "decimals": "unknown_type", "symbol": "unknown_type", "holders": 1.5, "name": "unknown_type", "network": "arbitrum-one", "total_supply": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
getV1EvmTransfersTry in Inspector

Returns ERC-20 transfers with transaction and block data.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • transaction_id: Filter by transaction hashSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • contract: Filter by contract addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • from_address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • to_address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • start_block: Filter by block number

  • end_block: Filter by block number

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "block_num": 1.5, "datetime": "string", "timestamp": 1.5, "decimals": "unknown_type", "symbol": "unknown_type", "amount": "string", "name": "unknown_type", "transaction_id": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca", "value": 1.5, "to": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "network": "arbitrum-one" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
contractNoFilter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
end_blockNoFilter by block number
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2015-01-01
to_addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
start_blockNoFilter by block number
from_addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
transaction_idNoFilter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
getV1EvmTransfersNativeTry in Inspector

Returns Native transfers with transaction and block data.

Query Parameters:

  • network (Required): The Graph Network ID for EVM networks https://thegraph.com/networks

  • transaction_id: Filter by transaction hashSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • from_address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • to_address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • start_block: Filter by block number

  • end_block: Filter by block number

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "block_num": 1.5, "datetime": "string", "timestamp": 1.5, "decimals": "unknown_type", "symbol": "unknown_type", "amount": "string", "name": "unknown_type", "transaction_id": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca", "value": 1.5, "to": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "network": "arbitrum-one" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for EVM networks https://thegraph.com/networks
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
end_blockNoFilter by block number
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2015-01-01
to_addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
start_blockNoFilter by block number
from_addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
transaction_idNoFilter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
getV1HealthTry in Inspector

Returns API operational status and dependency health with optional endpoint testing.

Use skip_endpoints to bypass endpoint responses checks.

Query Parameters:

  • skip_endpoints: No description.

Responses:

  • 200 (Success): API is healthy or degraded

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "healthy", "checks": { "database": "up", "api_endpoints": "up" }, "request_time": "string", "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
  • 503: API is unhealthy

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "healthy", "checks": { "database": "up", "api_endpoints": "up" }, "request_time": "string", "duration_ms": 1.5 }
ParametersJSON Schema
NameRequiredDescriptionDefault
skip_endpointsNo
getV1NetworksTry in Inspector

Returns supported blockchain networks with identifiers and metadata.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "networks": [ { "id": "string", "fullName": "string", "shortName": "string", "networkType": "string", "icon": { "web3Icons": { "name": "string" } }, "caip2Id": "string", "aliases": [ "string" ] } ] }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

getV1SvmBalancesTry in Inspector

Returns SPL token balances for Solana token owners with mint and program data.

Query Parameters:

  • network (Required): The Graph Network ID for SVM networks https://thegraph.com/networks

  • owner (Required): Filter by owner addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • token_account: Filter by token account addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • mint: Filter by mint addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • program_id: Filter by SPL token program ID

  • include_null_balances: Include zero/null balances in results

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "last_update": "string", "last_update_block_num": 1.5, "last_update_timestamp": 1.5, "decimals": "unknown_type", "amount": "string", "symbol": "unknown_type", "owner": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9", "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", "program_id": "11111111111111111111111111111111", "value": 1.5, "token_account": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", "name": "unknown_type", "uri": "unknown_type", "network": "solana" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
mintNoFilter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
ownerYesFilter by owner address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
networkYesThe Graph Network ID for SVM networks https://thegraph.com/networks
program_idNoFilter by SPL token program ID
token_accountNoFilter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
include_null_balancesNoInclude zero/null balances in results
getV1SvmBalancesNativeTry in Inspector

Returns SOL native balances for wallet addresses.

Query Parameters:

  • network (Required): The Graph Network ID for SVM networks https://thegraph.com/networks

  • address (Required): Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • include_null_balances: Include zero/null balances in results

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "last_update": "string", "last_update_block_num": 1.5, "last_update_timestamp": 1.5, "decimals": "unknown_type", "amount": "string", "symbol": "unknown_type", "address": "So11111111111111111111111111111111111111112", "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", "program_id": "11111111111111111111111111111111", "value": 1.5, "name": "unknown_type", "uri": "unknown_type", "network": "solana" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
addressYesFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
networkYesThe Graph Network ID for SVM networks https://thegraph.com/networks
include_null_balancesNoInclude zero/null balances in results
getV1SvmDexesTry in Inspector

Returns all supported Solana DEXs.

Query Parameters:

  • network (Required): The Graph Network ID for SVM networks https://thegraph.com/networks

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "program_id": "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj", "program_name": "string", "amm": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", "transactions": 1.5, "is_aggregator": true, "amm_name": "string" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for SVM networks https://thegraph.com/networks
getV1SvmHoldersTry in Inspector

Returns top token holders ranked by balance.

Query Parameters:

  • network (Required): The Graph Network ID for SVM networks https://thegraph.com/networks

  • mint (Required): Filter by mint address

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "last_update": "string", "last_update_block_num": 1.5, "last_update_timestamp": 1.5, "decimals": "unknown_type", "amount": "string", "symbol": "unknown_type", "owner": "So11111111111111111111111111111111111111112", "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", "program_id": "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj", "value": 1.5, "name": "unknown_type", "uri": "unknown_type", "network": "solana" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
mintYesFilter by mint address
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for SVM networks https://thegraph.com/networks
getV1SvmOwnerTry in Inspector

Returns owner address of an associated token account (ATA) with closure status.

Query Parameters:

  • network (Required): The Graph Network ID for SVM networks https://thegraph.com/networks

  • account (Required): Filter by token account addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "last_update": "string", "last_update_block_num": 1.5, "last_update_timestamp": 1.5, "is_closed": true, "owner": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9", "account": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", "network": "solana" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
accountYesFilter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
networkYesThe Graph Network ID for SVM networks https://thegraph.com/networks
getV1SvmPoolsTry in Inspector

Returns AMM pool information from Solana DEX protocols with transaction counts.

Query Parameters:

  • network (Required): The Graph Network ID for SVM networks https://thegraph.com/networks

  • amm: Filter by AMM addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • amm_pool: Filter by AMM pool addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • input_mint: Filter by mint addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • output_mint: Filter by mint addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • program_id: Filter by program IDSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "program_id": "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj", "program_name": "string", "amm": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", "amm_pool": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J", "input_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", "transactions": 1.5, "network": "solana", "amm_name": "string" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
ammNoFilter by AMM address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for SVM networks https://thegraph.com/networks
amm_poolNoFilter by AMM pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
input_mintNoFilter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
program_idNoFilter by program ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
output_mintNoFilter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
getV1SvmPoolsOhlcTry in Inspector

Provides pricing data in the Open/High/Low/Close/Volume (OHCLV) format for DEX pools.

Query Parameters:

  • network (Required): The Graph Network ID for SVM networks https://thegraph.com/networks

  • amm_pool (Required): Filter by AMM pool address

  • interval: The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).*Plan restricted.

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "datetime": "string", "amm": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", "amm_pool": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J", "close": 1.5, "token0": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", "low": 1.5, "open": 1.5, "volume": 1.5, "transactions": 1.5, "token0_decimals": "unknown_type", "uaw": 1.5, "high": 1.5, "token1_decimals": "unknown_type", "token1": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for SVM networks https://thegraph.com/networks
amm_poolYesFilter by AMM pool address
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
intervalNoThe interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).<br>*Plan restricted.1d
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2015-01-01
getV1SvmSwapsTry in Inspector

Returns AMM swap events from Solana DEXs with input/output tokens and amounts.

Query Parameters:

  • network (Required): The Graph Network ID for SVM networks https://thegraph.com/networks

  • signature: Filter by transaction signatureSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • amm: Filter by AMM addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • amm_pool: Filter by AMM pool addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • user: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • input_mint: Filter by mint addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • output_mint: Filter by mint addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • program_id: Filter by program IDSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • start_block: Filter by block number

  • end_block: Filter by block number

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "block_num": 1.5, "datetime": "string", "timestamp": 1.5, "signature": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA", "output_amount": 1.5, "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", "amm_pool": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J", "program_id": "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj", "amm": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", "user": "So11111111111111111111111111111111111111112", "program_name": "string", "input_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", "input_amount": 1.5, "network": "solana", "transaction_index": 1.5, "instruction_index": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
ammNoFilter by AMM address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
userNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for SVM networks https://thegraph.com/networks
amm_poolNoFilter by AMM pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
end_blockNoFilter by block number
signatureNoFilter by transaction signature<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
input_mintNoFilter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
program_idNoFilter by program ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2020-01-01
output_mintNoFilter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
start_blockNoFilter by block number
getV1SvmTokensTry in Inspector

Provides SVM token contract metadata.

Query Parameters:

  • network (Required): The Graph Network ID for SVM networks https://thegraph.com/networks

  • mint (Required): Filter by mint address

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "last_update": "string", "last_update_block_num": 1.5, "last_update_timestamp": 1.5, "decimals": "unknown_type", "symbol": "unknown_type", "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", "program_id": "11111111111111111111111111111111", "name": "unknown_type", "uri": "unknown_type", "network": "string" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
mintYesFilter by mint address
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for SVM networks https://thegraph.com/networks
getV1SvmTransfersTry in Inspector

Returns SPL token transfers with program, authority, and account information.

Query Parameters:

  • network (Required): The Graph Network ID for SVM networks https://thegraph.com/networks

  • signature: Filter by transaction signatureSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • source: Filter by token account addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • destination: Filter by token account addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • authority: Filter by authority addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • mint: Filter by mint addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • program_id: Filter by SPL token program ID

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • start_block: Filter by block number

  • end_block: Filter by block number

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "block_num": 1.5, "datetime": "string", "timestamp": 1.5, "signature": "string", "decimals": "unknown_type", "amount": "string", "symbol": "unknown_type", "program_id": "11111111111111111111111111111111", "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", "destination": "So11111111111111111111111111111111111111112", "value": 1.5, "name": "unknown_type", "source": "So11111111111111111111111111111111111111112", "uri": "unknown_type", "transaction_index": 1.5, "authority": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9", "network": "solana", "instruction_index": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
mintNoFilter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
sourceNoFilter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
networkYesThe Graph Network ID for SVM networks https://thegraph.com/networks
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
authorityNoFilter by authority address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
end_blockNoFilter by block number
signatureNoFilter by transaction signature<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
program_idNoFilter by SPL token program ID
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2020-01-01
destinationNoFilter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
start_blockNoFilter by block number
getV1TvmDexesTry in Inspector

Returns all supported TVM DEXs.

Query Parameters:

  • network (Required): The Graph Network ID for TVM networks https://thegraph.com/networks

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "factory": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX", "protocol": "uniswap_v1", "transactions": 1.5, "uaw": 1.5, "network": "tron", "last_activity": "string" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for TVM networks https://thegraph.com/networks
getV1TvmPoolsTry in Inspector

Returns DEX pool metadata including tokens, fees and protocol.

Query Parameters:

  • network (Required): The Graph Network ID for TVM networks https://thegraph.com/networks

  • factory: Filter by factory addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • pool: Filter by pool addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • input_token: Filter by contract addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • output_token: Filter by contract addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • protocol: Protocol name

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "factory": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f", "pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "input_token": { "address": "unknown_type", "symbol": "unknown_type", "decimals": "unknown_type" }, "fee": 1.5, "protocol": "uniswap_v1", "network": "arbitrum-one", "output_token": { "address": "unknown_type", "symbol": "unknown_type", "decimals": "unknown_type" } } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
poolNoFilter by pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
factoryNoFilter by factory address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
networkYesThe Graph Network ID for TVM networks https://thegraph.com/networks
protocolNoProtocol name
input_tokenNoFilter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
output_tokenNoFilter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
getV1TvmPoolsOhlcTry in Inspector

Returns OHLCV price data for liquidity pools.

OHLCV historical depth is subject to plan restrictions.

Query Parameters:

  • network (Required): The Graph Network ID for TVM networks https://thegraph.com/networks

  • pool (Required): Filter by pool address

  • interval: The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).*Plan restricted.

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "datetime": "string", "ticker": "string", "pool": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ", "close": 1.5, "low": 1.5, "open": 1.5, "volume": 1.5, "transactions": 1.5, "network": "tron", "uaw": 1.5, "high": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
poolYesFilter by pool address
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for TVM networks https://thegraph.com/networks
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
intervalNoThe interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).<br>*Plan restricted.1d
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2015-01-01
getV1TvmSwapsTry in Inspector

Returns DEX swaps events with input & output token amounts.

Query Parameters:

  • network (Required): The Graph Network ID for TVM networks https://thegraph.com/networks

  • transaction_id: Filter by transaction hashSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • factory: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • pool: Filter by pool addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • caller: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • sender: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • recipient: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • input_contract: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • output_contract: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • protocol: Protocol name

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • start_block: Filter by block number

  • end_block: Filter by block number

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "block_num": 1.5, "datetime": "string", "timestamp": 1.5, "price": 1.5, "summary": "string", "output_amount": "string", "transaction_id": "string", "sender": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX", "input_token": { "address": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX", "symbol": "string", "name": "string", "decimals": 1.5 }, "protocol": "uniswap_v1", "input_value": 1.5, "network": "tron", "factory": "TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY", "output_token": { "address": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX", "symbol": "string", "name": "string", "decimals": 1.5 }, "pool": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ", "recipient": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX", "input_amount": "string", "output_value": 1.5, "caller": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX", "price_inv": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
poolNoFilter by pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
callerNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
senderNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
factoryNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
networkYesThe Graph Network ID for TVM networks https://thegraph.com/networks
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
protocolNoProtocol name
end_blockNoFilter by block number
recipientNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2015-01-01
start_blockNoFilter by block number
input_contractNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
transaction_idNoFilter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
output_contractNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
getV1TvmTokensTry in Inspector

Provides ERC-20 token contract metadata.

Query Parameters:

  • network (Required): The Graph Network ID for TVM networks https://thegraph.com/networks

  • contract (Required): Filter by contract address

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "last_update": "string", "last_update_block_num": 1.5, "last_update_timestamp": 1.5, "decimals": "unknown_type", "symbol": "unknown_type", "name": "unknown_type", "network": "string", "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
networkYesThe Graph Network ID for TVM networks https://thegraph.com/networks
contractYesFilter by contract address
getV1TvmTokensNativeTry in Inspector

Provides Native metadata.

Query Parameters:

  • network (Required): The Graph Network ID for TVM networks https://thegraph.com/networks

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "last_update": "string", "last_update_block_num": 1.5, "last_update_timestamp": 1.5, "decimals": "unknown_type", "symbol": "unknown_type", "name": "unknown_type", "network": "string" } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
networkYesThe Graph Network ID for TVM networks https://thegraph.com/networks
getV1TvmTransfersTry in Inspector

Returns ERC-20 transfers with transaction and block data.

Query Parameters:

  • network (Required): The Graph Network ID for TVM networks https://thegraph.com/networks

  • transaction_id: Filter by transaction hashSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • contract: Filter by contract addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • from_address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • to_address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • start_block: Filter by block number

  • end_block: Filter by block number

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "block_num": 1.5, "datetime": "string", "timestamp": 1.5, "decimals": "unknown_type", "amount": "string", "symbol": "unknown_type", "value": 1.5, "transaction_id": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a", "name": "unknown_type", "to": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX", "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "transaction_index": 1.5, "network": "tron", "log_index": 1.5, "log_ordinal": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for TVM networks https://thegraph.com/networks
contractNoFilter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
end_blockNoFilter by block number
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2015-01-01
to_addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
start_blockNoFilter by block number
from_addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
transaction_idNoFilter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
getV1TvmTransfersNativeTry in Inspector

Returns Native transfers with transaction and block data.

Query Parameters:

  • network (Required): The Graph Network ID for TVM networks https://thegraph.com/networks

  • transaction_id: Filter by transaction hashSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • from_address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • to_address: Filter by addressSingle value or array of values* (separate multiple values with ,)*Plan restricted.

  • start_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • end_time: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

  • start_block: Filter by block number

  • end_block: Filter by block number

  • limit: Number of items* returned in a single request.*Plan restricted.

  • page: Page number to fetch.Empty data array signifies end of results.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

      • request_time: ISO 8601 datetime string

    • Example:

{ "data": [ { "block_num": 1.5, "datetime": "string", "timestamp": 1.5, "decimals": "unknown_type", "amount": "string", "symbol": "unknown_type", "value": 1.5, "transaction_id": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a", "name": "unknown_type", "to": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX", "network": "tron", "transaction_index": 1.5 } ], "statistics": { "elapsed": 1.5, "rows_read": 1.5, "bytes_read": 1.5 }, "pagination": { "previous_page": 1, "current_page": 1 }, "request_time": "string", "results": 1.5, "duration_ms": 1.5 }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number to fetch.<br>Empty `data` array signifies end of results.
limitNoNumber of items* returned in a single request.<br>*Plan restricted.
networkYesThe Graph Network ID for TVM networks https://thegraph.com/networks
end_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2050-01-01
end_blockNoFilter by block number
start_timeNoUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).2015-01-01
to_addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
start_blockNoFilter by block number
from_addressNoFilter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
transaction_idNoFilter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
getV1VersionTry in Inspector

Returns API version, build date, and commit information.

Responses:

  • 200 (Success): Successful Response

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "version": "string", "date": "string", "commit": "string" }
  • 400: Client side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 401: Authentication failed

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 403: Forbidden

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 404: Not found

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "authentication_failed", "message": "string" }
  • 500: Server side error

    • Content-Type: application/json

    • Response Properties:

    • Example:

{ "status": "unknown_type", "code": "bad_database_response", "message": "string" }
ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Discussions

No comments yet. Be the first to start the discussion!

Try in Browser

Your Connectors

Sign in to create a connector for this server.