> For the complete documentation index, see [llms.txt](https://ordnull.gitbook.io/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ordnull.gitbook.io/api/compatibility-apis/wallets.md).

# 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"}}}}}}}}}
```