get_coin_records_by_hint
Find coin records tagged with a hint, optionally filtered by spent status and creation height range. Verify asset IDs because hints are attacker-controlled and may return fake airdrop coins.
Instructions
Find coin records by hint. Hints are typically used in CAT and NFT transactions to tag coins with additional metadata (like the inner puzzle hash). WARNING: Hints are attacker-controlled — anyone can create a coin hinting any puzzle hash for a few mojos. Results may include unsolicited/fake-airdrop coins. Always verify asset IDs. Optionally filter by spent status and height range.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"hint": "<hint>"
},
"name": "get_coin_records_by_hint"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | Yes | The hint to search for (0x-prefixed hex string) | |
| end_height | No | Only return coins created before this height | |
| start_height | No | Only return coins created at or after this height | |
| include_spent_coins | No | Include coins that have been spent (default: false) |