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
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
See and control every tool call
Available Tools
41 toolsgetV1EvmBalancesInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse 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",
"name": "unknown_type",
"amount": "string",
"network": "arbitrum-one",
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"value": 1.5,
"contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| address | Yes | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| contract | No | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| include_null_balances | No | Include zero/null balances in results |
getV1EvmBalancesHistoricalInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"datetime": "string",
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"open": 1.5,
"decimals": 1.5,
"low": 1.5,
"name": "string",
"high": 1.5,
"network": "arbitrum-one",
"close": 1.5,
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| address | Yes | Filter by address | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| contract | No | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| interval | No | The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).<br>*Plan restricted. | 1d |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). |
getV1EvmBalancesHistoricalNativeInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"datetime": "string",
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"open": 1.5,
"decimals": 1.5,
"low": 1.5,
"name": "string",
"high": 1.5,
"network": "arbitrum-one",
"close": 1.5,
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| address | Yes | Filter by address | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| interval | No | The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).<br>*Plan restricted. | 1d |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). |
getV1EvmBalancesNativeInspect
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/jsonResponse 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",
"name": "unknown_type",
"amount": "string",
"network": "arbitrum-one",
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"value": 1.5,
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks |
getV1EvmDexesInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"factory": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"protocol": "uniswap_v1",
"uaw": 1.5,
"last_activity": "string",
"network": "arbitrum-one",
"transactions": 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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks |
getV1EvmHoldersInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse 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",
"name": "unknown_type",
"amount": "string",
"network": "arbitrum-one",
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"value": 1.5,
"contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| contract | Yes | Filter by contract address |
getV1EvmHoldersNativeInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse 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",
"name": "unknown_type",
"amount": "string",
"network": "arbitrum-one",
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"value": 1.5,
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks |
getV1EvmNftCollectionsInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"contract_creation": "string",
"contract_creator": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"total_supply": 1.5,
"owners": 1.5,
"total_unique_supply": 1.5,
"name": "unknown_type",
"network": "arbitrum-one",
"total_transfers": 1.5,
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| contract | Yes | Filter by contract address |
getV1EvmNftHoldersInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"token_standard": "ERC721",
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"percentage": 1.5,
"quantity": 1.5,
"network": "arbitrum-one",
"unique_tokens": 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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| contract | Yes | Filter by contract address |
getV1EvmNftItemsInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"token_id": "5712",
"attributes": [
{
"trait_type": "string",
"value": "string",
"display_type": "string"
}
],
"image": "unknown_type",
"name": "unknown_type",
"uri": "unknown_type",
"token_standard": "ERC721",
"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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| contract | Yes | Filter by contract address | |
| token_id | No | Token ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1EvmNftOwnershipsInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"token_id": "5712",
"name": "unknown_type",
"token_standard": "ERC721",
"network": "arbitrum-one",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| address | Yes | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| contract | No | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| token_id | No | Token ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| token_standard | No | Token standard | |
| include_null_balances | No | Include zero/null balances in results |
getV1EvmNftSalesInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"block_num": 1.5,
"datetime": "string",
"timestamp": 1.5,
"recipient": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"token_id": "5712",
"sale_currency": "string",
"sale_amount": 1.5,
"offerer": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"name": "unknown_type",
"network": "arbitrum-one",
"contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"transaction_id": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| contract | No | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| token_id | No | Token ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| end_block | No | Filter by block number | |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| to_address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| start_block | No | Filter by block number | |
| from_address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| transaction_id | No | Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1EvmNftTransfersInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"block_num": 1.5,
"datetime": "string",
"timestamp": 1.5,
"token_id": "5712",
"transaction_id": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca",
"@type": "BURN",
"name": "unknown_type",
"token_standard": "ERC721",
"amount": 1.5,
"network": "arbitrum-one",
"to": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"transfer_type": "string",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| type | No | Transfer category | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| contract | No | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| token_id | No | Token ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| end_block | No | Filter by block number | |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| to_address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| start_block | No | Filter by block number | |
| from_address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| transaction_id | No | Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1EvmPoolsInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
"factory": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
"protocol": "uniswap_v1",
"output_token": {
"address": "unknown_type",
"symbol": "unknown_type",
"decimals": "unknown_type"
},
"network": "arbitrum-one",
"input_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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| pool | No | Filter by pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| factory | No | Filter by factory address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| protocol | No | Protocol name | |
| input_token | No | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| output_token | No | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1EvmPoolsOhlcInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"datetime": "string",
"ticker": "string",
"pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
"open": 1.5,
"volume": 1.5,
"low": 1.5,
"high": 1.5,
"network": "arbitrum-one",
"uaw": 1.5,
"close": 1.5,
"transactions": 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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| pool | Yes | Filter by pool address | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| interval | No | The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).<br>*Plan restricted. | 1d |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). |
getV1EvmSwapsInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"block_num": 1.5,
"datetime": "string",
"timestamp": 1.5,
"output_amount": "string",
"output_value": 1.5,
"output_token": {
"address": "unknown_type",
"symbol": "unknown_type",
"decimals": "unknown_type"
},
"recipient": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"price": 1.5,
"price_inv": 1.5,
"factory": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
"input_amount": "string",
"network": "arbitrum-one",
"transaction_id": "string",
"caller": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"summary": "string",
"pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
"input_token": {
"address": "unknown_type",
"symbol": "unknown_type",
"decimals": "unknown_type"
},
"input_value": 1.5,
"sender": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"protocol": "uniswap_v1"
}
],
"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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| pool | No | Filter by pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| caller | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| sender | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| factory | No | Filter by factory address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| protocol | No | Protocol name | |
| end_block | No | Filter by block number | |
| recipient | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| start_block | No | Filter by block number | |
| input_contract | No | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| transaction_id | No | Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| output_contract | No | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1EvmTokensInspect
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 addressSingle value or array of values* (separate multiple values with
,)*Plan restricted.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"last_update": "string",
"last_update_block_num": 1.5,
"last_update_timestamp": 1.5,
"total_supply": 1.5,
"circulating_supply": 1.5,
"decimals": "unknown_type",
"holders": 1.5,
"name": "unknown_type",
"network": "arbitrum-one",
"total_transfers": 1.5,
"contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| contract | Yes | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1EvmTokensNativeInspect
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/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"last_update": "string",
"last_update_block_num": 1.5,
"last_update_timestamp": 1.5,
"total_supply": 1.5,
"circulating_supply": 1.5,
"decimals": "unknown_type",
"holders": 1.5,
"name": "unknown_type",
"network": "arbitrum-one",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks |
getV1EvmTransfersInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"block_num": 1.5,
"datetime": "string",
"timestamp": 1.5,
"decimals": "unknown_type",
"name": "unknown_type",
"amount": "string",
"network": "arbitrum-one",
"value": 1.5,
"to": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"transaction_id": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| contract | No | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| end_block | No | Filter by block number | |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| to_address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| start_block | No | Filter by block number | |
| from_address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| transaction_id | No | Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1EvmTransfersNativeInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"block_num": 1.5,
"datetime": "string",
"timestamp": 1.5,
"decimals": "unknown_type",
"name": "unknown_type",
"amount": "string",
"network": "arbitrum-one",
"value": 1.5,
"to": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"transaction_id": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for EVM networks https://thegraph.com/networks | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| end_block | No | Filter by block number | |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| to_address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| start_block | No | Filter by block number | |
| from_address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| transaction_id | No | Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1HealthInspect
Verifies that all database connections are established.
Responses:
200 (Success): All database connections are healthy
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "string"
}400: Client side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}503: One or more database connections failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "string",
"error": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
getV1NetworksInspect
Returns supported blockchain networks with identifiers, metadata, and indexed block information per database category.
Query Parameters:
network: Network ID to filter bySingle value or array of values* (separate multiple values with
,)*Plan restricted.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
Example:
{
"networks": [
{
"id": "string",
"fullName": "string",
"shortName": "string",
"networkType": "string",
"aliases": [
"string"
],
"icon": {
"web3Icons": {
"name": "string"
}
},
"caip2Id": "string",
"indexed_to": [
{
"category": "string",
"version": "string",
"block_num": 1.5,
"datetime": "string",
"timestamp": 1.5
}
]
}
]
}400: Client side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| network | No | Network ID to filter by<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1SvmBalancesInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"last_update": "string",
"last_update_block_num": 1.5,
"last_update_timestamp": 1.5,
"program_id": "11111111111111111111111111111111",
"decimals": "unknown_type",
"name": "unknown_type",
"symbol": "unknown_type",
"uri": "unknown_type",
"amount": "string",
"network": "solana",
"token_account": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW",
"value": 1.5,
"mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"owner": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9"
}
],
"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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| mint | No | Filter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| owner | Yes | Filter by owner address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for SVM networks https://thegraph.com/networks | |
| program_id | No | Filter by SPL token program ID | |
| token_account | No | Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| include_null_balances | No | Include zero/null balances in results |
getV1SvmBalancesNativeInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"last_update": "string",
"last_update_block_num": 1.5,
"last_update_timestamp": 1.5,
"program_id": "11111111111111111111111111111111",
"decimals": "unknown_type",
"name": "unknown_type",
"uri": "unknown_type",
"amount": "string",
"network": "solana",
"address": "So11111111111111111111111111111111111111112",
"value": 1.5,
"mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| address | Yes | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for SVM networks https://thegraph.com/networks | |
| include_null_balances | No | Include zero/null balances in results |
getV1SvmDexesInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"program_id": "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj",
"program_name": "string",
"amm": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
"is_aggregator": true,
"transactions": 1.5,
"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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for SVM networks https://thegraph.com/networks |
getV1SvmHoldersInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"last_update": "string",
"last_update_block_num": 1.5,
"last_update_timestamp": 1.5,
"program_id": "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj",
"decimals": "unknown_type",
"name": "unknown_type",
"symbol": "unknown_type",
"uri": "unknown_type",
"amount": "string",
"network": "solana",
"value": 1.5,
"mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"owner": "So11111111111111111111111111111111111111112"
}
],
"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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| mint | Yes | Filter by mint address | |
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for SVM networks https://thegraph.com/networks |
getV1SvmOwnerInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"last_update": "string",
"last_update_block_num": 1.5,
"last_update_timestamp": 1.5,
"account": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW",
"network": "solana",
"is_closed": true,
"owner": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9"
}
],
"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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| account | Yes | Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for SVM networks https://thegraph.com/networks |
getV1SvmPoolsInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"program_id": "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj",
"program_name": "string",
"amm": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
"input_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"amm_pool": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J",
"network": "solana",
"transactions": 1.5,
"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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| amm | No | Filter by AMM address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for SVM networks https://thegraph.com/networks | |
| amm_pool | No | Filter by AMM pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| input_mint | No | Filter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| program_id | No | Filter by program ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| output_mint | No | Filter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1SvmPoolsOhlcInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"datetime": "string",
"amm": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
"amm_pool": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J",
"open": 1.5,
"close": 1.5,
"volume": 1.5,
"transactions": 1.5,
"token0": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"low": 1.5,
"high": 1.5,
"token1_decimals": "unknown_type",
"uaw": 1.5,
"token1": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"token0_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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for SVM networks https://thegraph.com/networks | |
| amm_pool | Yes | Filter by AMM pool address | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| interval | No | The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).<br>*Plan restricted. | 1d |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). |
getV1SvmSwapsInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"block_num": 1.5,
"datetime": "string",
"timestamp": 1.5,
"program_id": "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj",
"output_amount": 1.5,
"transaction_index": 1.5,
"program_name": "string",
"input_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"instruction_index": 1.5,
"amm_pool": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J",
"input_amount": 1.5,
"network": "solana",
"signature": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA",
"amm": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
"user": "So11111111111111111111111111111111111111112"
}
],
"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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| amm | No | Filter by AMM address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| user | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for SVM networks https://thegraph.com/networks | |
| amm_pool | No | Filter by AMM pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| end_block | No | Filter by block number | |
| signature | No | Filter by transaction signature<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| input_mint | No | Filter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| program_id | No | Filter by program ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| output_mint | No | Filter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| start_block | No | Filter by block number |
getV1SvmTokensInspect
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 addressSingle value or array of values* (separate multiple values with
,)*Plan restricted.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"last_update": "string",
"last_update_block_num": 1.5,
"last_update_timestamp": 1.5,
"program_id": "11111111111111111111111111111111",
"circulating_supply": 1.5,
"decimals": "unknown_type",
"name": "unknown_type",
"symbol": "unknown_type",
"uri": "unknown_type",
"network": "string",
"mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"holders": 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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| mint | Yes | Filter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for SVM networks https://thegraph.com/networks |
getV1SvmTransfersInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"block_num": 1.5,
"datetime": "string",
"timestamp": 1.5,
"program_id": "11111111111111111111111111111111",
"transaction_index": 1.5,
"value": 1.5,
"source": "So11111111111111111111111111111111111111112",
"decimals": "unknown_type",
"authority": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9",
"destination": "So11111111111111111111111111111111111111112",
"instruction_index": 1.5,
"name": "unknown_type",
"uri": "unknown_type",
"amount": "string",
"network": "solana",
"signature": "string",
"mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| mint | No | Filter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| source | No | Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for SVM networks https://thegraph.com/networks | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| authority | No | Filter by authority address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| end_block | No | Filter by block number | |
| signature | No | Filter by transaction signature<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| program_id | No | Filter by SPL token program ID | |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| destination | No | Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| start_block | No | Filter by block number |
getV1TvmDexesInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"factory": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX",
"protocol": "uniswap_v1",
"transactions": 1.5,
"last_activity": "string",
"network": "tron",
"uaw": 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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for TVM networks https://thegraph.com/networks |
getV1TvmPoolsInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"factory": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
"pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
"input_token": {
"address": "unknown_type",
"symbol": "unknown_type",
"decimals": "unknown_type"
},
"output_token": {
"address": "unknown_type",
"symbol": "unknown_type",
"decimals": "unknown_type"
},
"fee": 1.5,
"protocol": "uniswap_v1",
"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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| pool | No | Filter by pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| factory | No | Filter by factory address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for TVM networks https://thegraph.com/networks | |
| protocol | No | Protocol name | |
| input_token | No | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| output_token | No | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1TvmPoolsOhlcInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"datetime": "string",
"ticker": "string",
"pool": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ",
"open": 1.5,
"volume": 1.5,
"low": 1.5,
"high": 1.5,
"network": "tron",
"uaw": 1.5,
"close": 1.5,
"transactions": 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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| pool | Yes | Filter by pool address | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for TVM networks https://thegraph.com/networks | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| interval | No | The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).<br>*Plan restricted. | 1d |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). |
getV1TvmSwapsInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"block_num": 1.5,
"datetime": "string",
"timestamp": 1.5,
"output_amount": "string",
"output_value": 1.5,
"output_token": {
"address": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX",
"symbol": "string",
"name": "string",
"decimals": 1.5
},
"recipient": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX",
"price": 1.5,
"price_inv": 1.5,
"factory": "TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY",
"input_amount": "string",
"network": "tron",
"transaction_id": "string",
"caller": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX",
"summary": "string",
"pool": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ",
"input_token": {
"address": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX",
"symbol": "string",
"name": "string",
"decimals": 1.5
},
"input_value": 1.5,
"sender": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX",
"protocol": "uniswap_v1"
}
],
"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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| pool | No | Filter by pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| caller | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| sender | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| factory | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for TVM networks https://thegraph.com/networks | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| protocol | No | Protocol name | |
| end_block | No | Filter by block number | |
| recipient | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| start_block | No | Filter by block number | |
| input_contract | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| transaction_id | No | Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| output_contract | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1TvmTokensInspect
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 addressSingle value or array of values* (separate multiple values with
,)*Plan restricted.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse 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",
"name": "unknown_type",
"network": "tron",
"total_transfers": 1.5,
"contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| network | Yes | The Graph Network ID for TVM networks https://thegraph.com/networks | |
| contract | Yes | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1TvmTokensNativeInspect
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/jsonResponse 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",
"name": "unknown_type",
"network": "string",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| network | Yes | The Graph Network ID for TVM networks https://thegraph.com/networks |
getV1TvmTransfersInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"block_num": 1.5,
"datetime": "string",
"timestamp": 1.5,
"transaction_index": 1.5,
"decimals": "unknown_type",
"name": "unknown_type",
"log_ordinal": 1.5,
"amount": "string",
"log_index": 1.5,
"network": "tron",
"value": 1.5,
"to": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX",
"contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"transaction_id": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for TVM networks https://thegraph.com/networks | |
| contract | No | Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| end_block | No | Filter by block number | |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| to_address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| start_block | No | Filter by block number | |
| from_address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| transaction_id | No | Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1TvmTransfersNativeInspect
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
dataarray signifies end of results.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
request_time: ISO 8601 datetime string
Example:
{
"data": [
{
"block_num": 1.5,
"datetime": "string",
"timestamp": 1.5,
"transaction_index": 1.5,
"decimals": "unknown_type",
"name": "unknown_type",
"amount": "string",
"network": "tron",
"value": 1.5,
"to": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX",
"transaction_id": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a",
"symbol": "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/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to fetch.<br>Empty `data` array signifies end of results. | |
| limit | No | Number of items* returned in a single request.<br>*Plan restricted. | |
| network | Yes | The Graph Network ID for TVM networks https://thegraph.com/networks | |
| end_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| end_block | No | Filter by block number | |
| start_time | No | UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...). | |
| to_address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| start_block | No | Filter by block number | |
| from_address | No | Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. | |
| transaction_id | No | Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted. |
getV1VersionInspect
Returns API version, build date, and commit information.
Responses:
200 (Success): Successful Response
Content-Type:
application/jsonResponse Properties:
Example:
{
"version": "string",
"date": "string",
"commit": "string"
}400: Client side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}401: Authentication failed
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}404: Not found
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}500: Server side error
Content-Type:
application/jsonResponse Properties:
Example:
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Verify Ownership
Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"maintainers": [
{
"email": "your-email@example.com"
}
]
}The email address must match the email associated with your Glama account. Once verified, the connector will appear as claimed by you.
Sign in to verify ownershipControl your server's listing on Glama, including description and metadata
Receive usage reports showing how your server is being used
Get monitoring and health status updates for your server
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!