Skip to main content

Inventory

Inventory shows what assets a wallet holds across supported token types (ERC-20, ERC-721, ERC-1155). List holdings, fetch a specific contract’s balance, attach/detach contracts, restore soft-deleted entries, and inspect per-contract transfer history.

List inventory for wallet​

GET /api/v1/wallets/{walletAddress}/inventory

cURL​

curl -s "$FREEQ_API_URL/api/v1/wallets/me/inventory?showDeleted=false" \
  -H "Authorization: Bearer $FREEQ_API_TOKEN"

Get specific contract holding​

GET /api/v1/wallets/{walletAddress}/inventory/{contractAddress}

cURL​

curl -s "$FREEQ_API_URL/api/v1/wallets/me/inventory/0xCONTRACT?tokenType=ERC-721&tokenId=2" \
  -H "Authorization: Bearer $FREEQ_API_TOKEN"

Add / Remove / Restore​

POST /api/v1/wallets/{walletAddress}/inventory/{contractAddress}
DELETE /api/v1/wallets/{walletAddress}/inventory/{contractAddress}
PUT /api/v1/wallets/{walletAddress}/inventory/{contractAddress}/undelete

Transfers​

GET /api/v1/wallets/{walletAddress}/inventory/coin/transactions
GET /api/v1/wallets/{walletAddress}/inventory/{contractAddress}/transactions

Issue to wallet​

POST /api/v1/wallets/{walletAddress}/inventory/{contractAddress}/issue

Native L2 transfer​

POST /api/v1/wallets/inventory/native-transfer

cURL​

curl -s -X POST "$FREEQ_API_URL/api/v1/wallets/inventory/native-transfer" \
  -H "Authorization: Bearer $FREEQ_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"to":"0xTO","amount":"0.01"}'