# Wallets

## GET /v2/address/pnl

> wallet profit and loss data on one token (5 CU)

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/v2/address/pnl":{"get":{"summary":"wallet profit and loss data on one token (5 CU)","parameters":[{"name":"wallet_address","in":"query","required":true,"description":"wallet address","schema":{"type":"string"}},{"name":"chain","in":"query","required":true,"description":"chain name (e.g. 'solana')","schema":{"type":"string"}},{"name":"token_address","in":"query","required":true,"description":"token address (e.g. '6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN')","schema":{"type":"string"}},{"name":"from_time","in":"query","required":false,"description":"unix epoch seconds for start time (earliest 15 days ago)","schema":{"type":"integer"}},{"name":"to_time","in":"query","required":false,"description":"end time (RFC3339, default: now)","schema":{"type":"string"}},{"name":"page_size","in":"query","required":false,"description":"number of results per page (default and max: 100)","schema":{"type":"integer","default":100,"maximum":100}},{"name":"last_id","in":"query","required":false,"description":"pagination, only needed for next page","schema":{"type":"string"}}],"responses":{"200":{"description":"successful response with wallet PnL","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```

## GET /v2/address/walletinfo

> wallet profit and loss data for all tokens on one chain (5 CU)

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/v2/address/walletinfo":{"get":{"summary":"wallet profit and loss data for all tokens on one chain (5 CU)","parameters":[{"name":"wallet_address","in":"query","required":true,"description":"wallet address","schema":{"type":"string"}},{"name":"chain","in":"query","required":true,"description":"chain name (e.g. 'solana')","schema":{"type":"string"}}],"responses":{"200":{"description":"successful response with wallet info","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```

## GET /v2/address/walletinfo/tokens

> all tokens holding in wallet on one chain (10 CU)

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/v2/address/walletinfo/tokens":{"get":{"summary":"all tokens holding in wallet on one chain (10 CU)","parameters":[{"name":"wallet_address","in":"query","required":true,"description":"wallet address","schema":{"type":"string"}},{"name":"chain","in":"query","required":true,"description":"chain name (e.g. 'solana')","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"sort field (default: last_txn_time, others: total_profit, unrealized_profit, balance_amount, balance_usd)","schema":{"type":"string"}},{"name":"sort_dir","in":"query","required":false,"description":"sort direction (default: desc, other: asc)","schema":{"type":"string"}},{"name":"hide_sold","in":"query","required":false,"description":"hide sold tokens (default: 0, 0 means do not hide)","schema":{"type":"integer"}},{"name":"hide_small","in":"query","required":false,"description":"hide small balances (default: 0, 0 means do not hide)","schema":{"type":"integer"}},{"name":"pageSize","in":"query","required":false,"description":"page size (max 100)","schema":{"type":"integer","maximum":100}},{"name":"pageNO","in":"query","required":false,"description":"page number (start from 1)","schema":{"type":"integer"}}],"responses":{"200":{"description":"successful response with wallet tokens","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```

## GET /v2/address/smart\_wallet/list

> smart wallet list on one chain (5 CU)

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/v2/address/smart_wallet/list":{"get":{"summary":"smart wallet list on one chain (5 CU)","parameters":[{"name":"chain","in":"query","required":true,"description":"chain name (e.g. 'solana')","schema":{"type":"string"}},{"name":"sort_dir","in":"query","required":false,"description":"sort direction (default: desc, other: asc)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"sort field (total_profit, total_profit_rate, total_volume, total_trades, token_profit_rate, last_trade_time)","schema":{"type":"string"}}],"responses":{"200":{"description":"successful response with smart wallet list","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ave-cloud.gitbook.io/data-api/rest/wallets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.