{"slug":"agentshelf-syntexa-ch-v1-eth-nft-metadata-758055","title":"Call when an agent needs parsed ERC-721 or ERC-1155 metadata for an Ethereum con","host":"agentshelf.syntexa.ch","method":"POST","resource":"https://agentshelf.syntexa.ch/v1/eth-nft-metadata","category":"code","description":"Call when an agent needs parsed ERC-721 or ERC-1155 metadata for an Ethereum contract and token id. The URI is fetched only from fixed IPFS and Arweave gateways, or parsed from a data JSON URI. ERC-1155 substitutes {id}. No arbitrary URL. Send JSON {\"contract\":\"0x111111111111111111111111111111111111","price_listed":0.005,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"contract":"0x1111111111111111111111111111111111111111","token_id":"1"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"examples":[{"contract":"0x1111111111111111111111111111111111111111","token_id":"1"}],"properties":{"contract":{"description":"NFT contract on Ethereum mainnet. Example: 0x1111111111111111111111111111111111111111. tokenURI or uri is read-only.","examples":["0x1111111111111111111111111111111111111111"],"type":"string"},"standard":{"default":"erc721","description":"Token standard. erc721 (default) uses ownerOf or tokenURI. erc1155 uses balanceOf(owner, id) or uri(id) with {id} substitution.","enum":["erc721","erc1155"],"type":"string"},"token_id":{"description":"Token id as a decimal integer. Example: 1. ERC-1155 substitutes this id into {id} in the URI. A missing token errors.","examples":["1"],"pattern":"^(0|[1-9]\\d*)$","type":"string"}},"required":["contract","token_id"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"examples":[{"billed":true,"contract":"0x1111111111111111111111111111111111111111","image":"https://ipfs.io/ipfs/QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG","metadata":{"image":"https://ipfs.io/ipfs/QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG","name":"Example"},"network":"eip155:1","ok":true,"receipt_id":"rcpt_01EXAMPLE000000000000000","source":"ipfs","standard":"erc721","token_id":"1","token_uri":"https://ipfs.io/ipfs/QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG","warnings":[]}],"properties":{"billed":{"examples":[true],"type":"boolean"},"contract":{"examples":["0x1111111111111111111111111111111111111111"],"type":"string"},"image":{"examples":["https://ipfs.io/ipfs/QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG"],"type":["string","null"]},"metadata":{"additionalProperties":{},"examples":[{"image":"https://ipfs.io/ipfs/QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG","name":"Example"}],"type":"object"},"network":{"const":"eip155:1","examples":["eip155:1"],"type":"string"},"ok":{"const":true,"examples":[true],"type":"boolean"},"receipt_id":{"examples":["rcpt_01EXAMPLE000000000000000"],"type":"string"},"source":{"enum":["ipfs","arweave","data"],"examples":["ipfs"],"type":"string"},"standard":{"enum":["erc721","erc1155"],"examples":["erc721"],"type":"string"},"token_id":{"examples":["1"],"type":"string"},"token_uri":{"examples":["https://ipfs.io/ipfs/QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG"],"type":["string","null"]},"warnings":{"default":[],"examples":[[]],"items":{"type":"string"},"type":"array"}},"required":["ok","receipt_id","billed","network","contract","token_id","standard","source","token_uri","image","metadata"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Call when an agent needs parsed ERC-721 or ERC-1155 metadata for an Ethereum contract and token id. The URI is fetched only from fixed IPFS and Arweave gateways, or parsed from a data JSON URI. ERC-1155 substitutes {id}. No arbitrary URL. Send JSON {\"contract\":\"0x1111111111111111111111111111111111111111\",\"token_id\":\"1\"}. Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/eth-nft-metadata first.","last_updated":"2026-10-20T07:39:12.041Z","schemes":["exact"]}