# Wallets

## Get Wallet Inscriptions

> Returns inscriptions owned by a bitcoin wallet address

```json
{"openapi":"3.0.0","info":{"title":"Ordinals & Runes Compatibility API","version":"3.0"},"servers":[{"url":"https://api.ordnull.site/v3","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-Key"}},"schemas":{"WalletInscriptionInfo":{"type":"object","properties":{"inscription_name":{"type":"string","nullable":true},"inscription_id":{"type":"string"},"inscription_number":{"type":"integer"},"metadata":{"type":"object","nullable":true},"wallet":{"type":"string"},"mime_type":{"type":"string"},"media_length":{"type":"integer"},"genesis_ts":{"type":"integer"},"genesis_height":{"type":"integer"},"genesis_fee":{"type":"integer"},"output_value":{"type":"integer"},"satpoint":{"type":"string"},"last_sale_price":{"type":"integer","nullable":true},"collection_name":{"type":"string","nullable":true},"collection_slug":{"type":"string","nullable":true},"last_transfer_block_height":{"type":"integer"},"utxo":{"type":"string"},"parent_ids":{"type":"array","items":{"type":"string"}},"genesis_block_hash":{"type":"string"},"content_url":{"type":"string"},"bis_url":{"type":"string"},"render_url":{"type":"string","nullable":true},"is_brc20":{"type":"boolean"},"bitmap_number":{"type":"integer","nullable":true},"delegate":{"type":"object","nullable":true,"properties":{"delegate_id":{"type":"string"},"render_url":{"type":"string"},"mime_type":{"type":"string"},"content_url":{"type":"string"},"bis_url":{"type":"string"}}}}},"Error":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}}},"paths":{"/wallet/inscriptions":{"get":{"summary":"Get Wallet Inscriptions","description":"Returns inscriptions owned by a bitcoin wallet address","parameters":[{"name":"order","in":"query","required":true,"schema":{"type":"string","enum":["asc","desc"]},"description":"Sort order"},{"name":"offset","in":"query","required":true,"schema":{"type":"integer","minimum":0},"description":"Starting offset for pagination"},{"name":"count","in":"query","required":true,"schema":{"type":"integer","minimum":20,"maximum":2000},"description":"Number of results to return"},{"name":"address","in":"query","required":true,"schema":{"type":"string"},"description":"Bitcoin wallet address"},{"name":"exclude_brc20","in":"query","required":false,"schema":{"type":"boolean"},"description":"Set to true to exclude BRC-20 inscriptions"},{"name":"cursed_only","in":"query","required":false,"schema":{"type":"boolean"},"description":"Set to true to return only cursed inscriptions"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WalletInscriptionInfo"}},"block_height":{"type":"integer","description":"Current block height"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Get Wallet Historical Balances

> Returns historical balances for a given bitcoin wallet address.

```json
{"openapi":"3.0.0","info":{"title":"Ordinals & Runes Compatibility API","version":"3.0"},"servers":[{"url":"https://api.ordnull.site/v3","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-Key"}},"schemas":{"BalanceTransaction":{"type":"object","properties":{"txid":{"type":"string","description":"Transaction ID"},"block_height":{"type":"integer","description":"Block height of the transaction"},"block_time":{"type":"integer","description":"Timestamp of the transaction"},"block_tx_index":{"type":"integer","description":"Position of the transaction within the block"},"balance_change":{"type":"integer","description":"Change in balance for the transaction (in Satoshis)"},"balance_sats":{"type":"integer","description":"Balance in Satoshis after the transaction"},"balance_usd":{"type":"string","nullable":true,"description":"Balance in USD after the transaction"},"btc_usd_rate":{"type":"string","nullable":true,"description":"USD rate at the time of the transaction"}}},"Error":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}}},"paths":{"/x/wallet/balance_history":{"get":{"summary":"Get Wallet Historical Balances","description":"Returns historical balances for a given bitcoin wallet address.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"},"description":"Bitcoin wallet address"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BalanceTransaction"}},"block_height":{"type":"integer","description":"Current block height"}}}}}},"403":{"description":"Invalid API Key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/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://ordnull.gitbook.io/api/compatibility-apis/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.