{"slug":"agentshelf-syntexa-ch-v1-base-nft-metadata-3752bb","title":"Call when an agent needs parsed ERC-721 metadata for a Base contract and token i","host":"agentshelf.syntexa.ch","method":"POST","resource":"https://agentshelf.syntexa.ch/v1/base-nft-metadata","category":"image","description":"Call when an agent needs parsed ERC-721 metadata for a Base contract and token id. tokenURI is fetched only from fixed IPFS and Arweave gateways. The image field is rewritten to that gateway. A missing token or non-JSON document errors. No arbitrary URL. Send JSON {\"contract\":\"0x11111111111111111111","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":"ERC-721 contract on Base. Example: 0x1111111111111111111111111111111111111111. tokenURI is read-only.","examples":["0x1111111111111111111111111111111111111111"],"type":"string"},"token_id":{"description":"ERC-721 token id as a decimal integer. Example: 1. A JSON number is accepted when it is a safe integer. 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:8453","ok":true,"receipt_id":"rcpt_01EXAMPLE000000000000000","source":"ipfs","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:8453","examples":["eip155:8453"],"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"},"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","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 metadata for a Base contract and token id. tokenURI is fetched only from fixed IPFS and Arweave gateways. The image field is rewritten to that gateway. A missing token or non-JSON document errors. No arbitrary URL. Send JSON {\"contract\":\"0x1111111111111111111111111111111111111111\",\"token_id\":\"1\"}. Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/base-nft-metadata first.","last_updated":"2026-10-19T07:32:02.567Z","schemes":["exact"]}