{ "@context": "https://agentflare.org/schema", "type": "Article", "tier": "L2-full", "title": "Using AgentFlare Social, Predictions and Crypto Data", "description": "AgentFlare's social, predictions and crypto .data.json files each cost 0.01 USD per request and are fetched with the X-Crawler-Token header. This guide…", "canonical": "https://agentflare.org/guides/using-agentflare-social-predictions-and-crypto-data.html", "category": "guides", "updated": "2026-10-27", "generated_at": "2026-10-27T00:37:01.404Z", "facts": [ { "label": "Track", "value": "Using AgentFlare data" }, { "label": "Level", "value": "Beginner" }, { "label": "Access", "value": "Free / open" }, { "label": "Updated", "value": "2026-10-27" } ], "data": { "topic": "Using AgentFlare Social, Predictions and Crypto Data", "track": "data", "access": "free", "generated_at": "2026-10-27T00:37:01.404Z", "difficulty": "Beginner", "tldr": "AgentFlare's social, predictions and crypto .data.json files each cost 0.01 USD per request and are fetched with the X-Crawler-Token header. This guide lists the fields in each file and gives fetch examples.", "intro": "This guide is for developers and agent builders who want to pull structured data from three AgentFlare directories: Social Pulse, Predictions and Crypto. You will learn which .data.json files exist, what every field in them holds, what each request costs, and how to fetch a file with the X-Crawler-Token header. You will also read prediction events and coin data in Python, and see how the pricing block inside each response is laid out. The examples use only paths and field names that AgentFlare documents.", "prerequisites": [ "A crawler token to put in the X-Crawler-Token header", "curl and Python 3 installed", "Basic familiarity with reading JSON" ], "steps": [ { "title": "Know which files are paid", "body": "Index pages, .html articles and .md teasers are free (tier L1_free). Every *.data.json and *.full.md file under /social/, /predictions/ and /crypto/ is paid (tier L2_paid) and metered per request at 0.01 USD each. That includes the index.data.json file in each directory. For comparison, the news directory is 0.005 and research and scholar are 0.02. Plan your call count before looping over many files.", "code": null, "sources": [ "S5" ] }, { "title": "Fetch the Social Pulse index", "body": "Request https://agentflare.org/social/index.data.json and send your token in X-Crawler-Token. This header replaces the earlier name X-AISA-Crawler-Token, which older AISA pages still show. Never put the token in Authorization: Bearer, because that header is reserved for the gateway layer. The response holds data.categories[], where each category has id, name, headline, url and a stats object with posts, likes, views, medLikes and verified.", "code": { "lang": "bash", "text": "curl -s 'https://agentflare.org/social/index.data.json' \\\n -H 'X-Crawler-Token: YOUR_CRAWLER_TOKEN'" }, "sources": [ "S1", "S2", "S5" ] }, { "title": "Read prediction events in Python", "body": "The predictions index returns data.count, data.total_volume_usd and data.events[]. Each event carries title, slug, leading, probability, change_pp_30d and volume_usd. The slug points to the per-event file at https://agentflare.org/predictions/.data.json. Each request is billed at 0.01 USD, so fetch the index once and then only the events you need.", "code": { "lang": "python", "text": "import json, urllib.request\n\nurl = 'https://agentflare.org/predictions/index.data.json'\nreq = urllib.request.Request(url, headers={'X-Crawler-Token': 'YOUR_CRAWLER_TOKEN'})\nwith urllib.request.urlopen(req) as r:\n doc = json.load(r)\n\nprint(doc['data']['count'], doc['data']['total_volume_usd'])\nfor e in doc['data']['events']:\n print(e['slug'], e['leading'], e['probability'],\n e['change_pp_30d'], e['volume_usd'])" }, "sources": [ "S1", "S3", "S5" ] }, { "title": "Fetch one event and one coin", "body": "An event file such as bitcoin-above-on-october-10-2026.data.json has data.event, data.slug, data.volume_usd, data.volume_24h_usd, data.end_date, data.markets[] (question, odds, volume_usd) and data.tags. Crypto offers a daily file at YYYY-MM-DD.data.json and per-coin files such as bitcoin.data.json or zcash.data.json. Replace the date with a real date.", "code": { "lang": "bash", "text": "curl -s 'https://agentflare.org/predictions/bitcoin-above-on-october-10-2026.data.json' \\\n -H 'X-Crawler-Token: YOUR_CRAWLER_TOKEN'\n\ncurl -s 'https://agentflare.org/crypto/zcash.data.json' \\\n -H 'X-Crawler-Token: YOUR_CRAWLER_TOKEN'" }, "sources": [ "S1", "S3", "S4" ] }, { "title": "Parse crypto fields and the pricing block", "body": "The crypto index and daily files give data.total_market_cap_usd, data.coin_count, data.advancers_24h, data.stablecoin_share_pct, data.top[] and data.trending[]. A per-coin file adds data.price_usd, data.market_cap_rank, data.fdv_usd, data.change_pct (h24, d7, d30, d90), data.ath_usd, data.atl_usd, data.supply and data.history_90d[]. Every response also ends with a pricing object, which the snippet prints.", "code": { "lang": "python", "text": "import json, urllib.request\n\nurl = 'https://agentflare.org/crypto/zcash.data.json'\nreq = urllib.request.Request(url, headers={'X-Crawler-Token': 'YOUR_CRAWLER_TOKEN'})\nwith urllib.request.urlopen(req) as r:\n doc = json.load(r)\n\nd = doc['data']\nprint(d['symbol'], d['price_usd'], d['market_cap_rank'])\nprint(d['change_pct']['h24'], d['change_pct']['d7'])\nprint(d['supply']['circulating'], d['supply']['max'])\nfor p in d['history_90d'][:3]:\n print(p['date'], p['price'])\nprint(doc['pricing']['price_usd'], doc['pricing']['method'])" }, "sources": [ "S1", "S4", "S5" ] } ], "reference": { "title": "Social, predictions and crypto files", "columns": [ "File", "Key fields", "Price per request" ], "rows": [ [ "/social/index.data.json", "data.categories[] with id, name, headline, url, stats (posts, likes, views, medLikes, verified)", "0.01 USD" ], [ "/predictions/index.data.json", "data.count, data.total_volume_usd, data.events[] (title, slug, leading, probability, change_pp_30d, volume_usd)", "0.01 USD" ], [ "/predictions/.data.json", "data.event, data.volume_usd, data.volume_24h_usd, data.end_date, data.markets[], data.tags", "0.01 USD" ], [ "/crypto/index.data.json", "data.total_market_cap_usd, data.coin_count, data.advancers_24h, data.stablecoin_share_pct, data.top[], data.trending[]", "0.01 USD" ], [ "/crypto/YYYY-MM-DD.data.json", "Same fields as the crypto index, for a given date", "0.01 USD" ], [ "/crypto/.data.json", "data.price_usd, data.market_cap_rank, data.change_pct, data.supply, data.history_90d[], data.faq[], data.newswire[]", "0.01 USD" ] ], "sources": [ "S2", "S3", "S4", "S5" ] }, "pitfalls": [ { "text": "Do not send the crawler token in Authorization: Bearer. That header is reserved for the gateway layer; use X-Crawler-Token instead.", "source": "S1" }, { "text": "Only the .html and .md teasers are free. Every .data.json request, including index.data.json, is metered at 0.01 USD in these three directories.", "source": "S5" }, { "text": "Change fields are named differently: the crypto index uses data.top[].change_24h and change_7d, while a coin file nests them as data.change_pct.h24 and d7.", "source": "S4" }, { "text": "Replace YYYY-MM-DD in file names like atp-fokina-tiafoe-YYYY-MM-DD.data.json with a real date, or the request will not match a file.", "source": "S3" } ], "takeaways": [ "Social, predictions and crypto .data.json files each cost 0.01 USD per request; teasers and index pages in .html or .md are free.", "Authenticate with the X-Crawler-Token header, never with Authorization: Bearer.", "Fetch each directory's index.data.json first, then follow its slugs to per-item files." ], "faq": [ { "q": "How much does an AgentFlare .data.json request cost?", "a": "Social, predictions and crypto are each priced at 0.01 USD per request for .data.json and .full.md files. News is 0.005, and research and scholar are 0.02. Index pages, .html articles and .md teasers are free." }, { "q": "Which header carries the crawler token?", "a": "X-Crawler-Token. It replaces the earlier X-AISA-Crawler-Token still shown on older AISA pages. Do not use Authorization: Bearer, which is reserved for the gateway layer." }, { "q": "What does a prediction event file contain?", "a": "It has data.event, data.slug, data.volume_usd, data.volume_24h_usd, data.end_date, data.tags and data.markets[]. Each market has a question, odds and its own volume_usd." }, { "q": "How do I get 90 days of price history for a coin?", "a": "Fetch the per-coin file, for example https://agentflare.org/crypto/zcash.data.json. Its data.history_90d[] array holds date and price entries, alongside data.ath_usd, data.atl_usd and data.supply." } ], "sources": [ { "title": "Header name: X-Crawler-Token", "url": "https://esa.aisa.one/cdn/open-verify.html", "domain": "esa.aisa.one" }, { "title": "AgentFlare Social Pulse .data.json field reference", "url": "https://agentflare.org/social/index.html", "domain": "agentflare.org" }, { "title": "AgentFlare Predictions .data.json field reference", "url": "https://agentflare.org/predictions/index.html", "domain": "agentflare.org" }, { "title": "AgentFlare Crypto .data.json field reference", "url": "https://agentflare.org/crypto/index.html", "domain": "agentflare.org" }, { "title": "AgentFlare pricing.json (directory price map)", "url": "https://agentflare.org/pricing.json", "domain": "agentflare.org" } ] }, "analysis_md": "AgentFlare's social, predictions and crypto .data.json files each cost 0.01 USD per request and are fetched with the X-Crawler-Token header. This guide lists the fields in each file and gives fetch examples.\n\nThis guide is for developers and agent builders who want to pull structured data from three AgentFlare directories: Social Pulse, Predictions and Crypto. You will learn which .data.json files exist, what every field in them holds, what each request costs, and how to fetch a file with the X-Crawler-Token header. You will also read prediction events and coin data in Python, and see how the pricing block inside each response is laid out. The examples use only paths and field names that AgentFlare documents.\n\n## Before you start\n\n- A crawler token to put in the X-Crawler-Token header\n- curl and Python 3 installed\n- Basic familiarity with reading JSON\n\n## Step by step\n\n### 1. Know which files are paid\n\nIndex pages, .html articles and .md teasers are free (tier L1_free). Every *.data.json and *.full.md file under /social/, /predictions/ and /crypto/ is paid (tier L2_paid) and metered per request at 0.01 USD each. That includes the index.data.json file in each directory. For comparison, the news directory is 0.005 and research and scholar are 0.02. Plan your call count before looping over many files.\n\n### 2. Fetch the Social Pulse index\n\nRequest https://agentflare.org/social/index.data.json and send your token in X-Crawler-Token. This header replaces the earlier name X-AISA-Crawler-Token, which older AISA pages still show. Never put the token in Authorization: Bearer, because that header is reserved for the gateway layer. The response holds data.categories[], where each category has id, name, headline, url and a stats object with posts, likes, views, medLikes and verified.\n\n```bash\ncurl -s 'https://agentflare.org/social/index.data.json' \\\n -H 'X-Crawler-Token: YOUR_CRAWLER_TOKEN'\n```\n\n### 3. Read prediction events in Python\n\nThe predictions index returns data.count, data.total_volume_usd and data.events[]. Each event carries title, slug, leading, probability, change_pp_30d and volume_usd. The slug points to the per-event file at https://agentflare.org/predictions/.data.json. Each request is billed at 0.01 USD, so fetch the index once and then only the events you need.\n\n```python\nimport json, urllib.request\n\nurl = 'https://agentflare.org/predictions/index.data.json'\nreq = urllib.request.Request(url, headers={'X-Crawler-Token': 'YOUR_CRAWLER_TOKEN'})\nwith urllib.request.urlopen(req) as r:\n doc = json.load(r)\n\nprint(doc['data']['count'], doc['data']['total_volume_usd'])\nfor e in doc['data']['events']:\n print(e['slug'], e['leading'], e['probability'],\n e['change_pp_30d'], e['volume_usd'])\n```\n\n### 4. Fetch one event and one coin\n\nAn event file such as bitcoin-above-on-october-10-2026.data.json has data.event, data.slug, data.volume_usd, data.volume_24h_usd, data.end_date, data.markets[] (question, odds, volume_usd) and data.tags. Crypto offers a daily file at YYYY-MM-DD.data.json and per-coin files such as bitcoin.data.json or zcash.data.json. Replace the date with a real date.\n\n```bash\ncurl -s 'https://agentflare.org/predictions/bitcoin-above-on-october-10-2026.data.json' \\\n -H 'X-Crawler-Token: YOUR_CRAWLER_TOKEN'\n\ncurl -s 'https://agentflare.org/crypto/zcash.data.json' \\\n -H 'X-Crawler-Token: YOUR_CRAWLER_TOKEN'\n```\n\n### 5. Parse crypto fields and the pricing block\n\nThe crypto index and daily files give data.total_market_cap_usd, data.coin_count, data.advancers_24h, data.stablecoin_share_pct, data.top[] and data.trending[]. A per-coin file adds data.price_usd, data.market_cap_rank, data.fdv_usd, data.change_pct (h24, d7, d30, d90), data.ath_usd, data.atl_usd, data.supply and data.history_90d[]. Every response also ends with a pricing object, which the snippet prints.\n\n```python\nimport json, urllib.request\n\nurl = 'https://agentflare.org/crypto/zcash.data.json'\nreq = urllib.request.Request(url, headers={'X-Crawler-Token': 'YOUR_CRAWLER_TOKEN'})\nwith urllib.request.urlopen(req) as r:\n doc = json.load(r)\n\nd = doc['data']\nprint(d['symbol'], d['price_usd'], d['market_cap_rank'])\nprint(d['change_pct']['h24'], d['change_pct']['d7'])\nprint(d['supply']['circulating'], d['supply']['max'])\nfor p in d['history_90d'][:3]:\n print(p['date'], p['price'])\nprint(doc['pricing']['price_usd'], doc['pricing']['method'])\n```\n\n## Social, predictions and crypto files\n\n| File | Key fields | Price per request |\n| --- | --- | --- |\n| /social/index.data.json | data.categories[] with id, name, headline, url, stats (posts, likes, views, medLikes, verified) | 0.01 USD |\n| /predictions/index.data.json | data.count, data.total_volume_usd, data.events[] (title, slug, leading, probability, change_pp_30d, volume_usd) | 0.01 USD |\n| /predictions/.data.json | data.event, data.volume_usd, data.volume_24h_usd, data.end_date, data.markets[], data.tags | 0.01 USD |\n| /crypto/index.data.json | data.total_market_cap_usd, data.coin_count, data.advancers_24h, data.stablecoin_share_pct, data.top[], data.trending[] | 0.01 USD |\n| /crypto/YYYY-MM-DD.data.json | Same fields as the crypto index, for a given date | 0.01 USD |\n| /crypto/.data.json | data.price_usd, data.market_cap_rank, data.change_pct, data.supply, data.history_90d[], data.faq[], data.newswire[] | 0.01 USD |\n\n## Common pitfalls\n\n- Do not send the crawler token in Authorization: Bearer. That header is reserved for the gateway layer; use X-Crawler-Token instead.\n- Only the .html and .md teasers are free. Every .data.json request, including index.data.json, is metered at 0.01 USD in these three directories.\n- Change fields are named differently: the crypto index uses data.top[].change_24h and change_7d, while a coin file nests them as data.change_pct.h24 and d7.\n- Replace YYYY-MM-DD in file names like atp-fokina-tiafoe-YYYY-MM-DD.data.json with a real date, or the request will not match a file.\n\n## Key takeaways\n\n- Social, predictions and crypto .data.json files each cost 0.01 USD per request; teasers and index pages in .html or .md are free.\n- Authenticate with the X-Crawler-Token header, never with Authorization: Bearer.\n- Fetch each directory's index.data.json first, then follow its slugs to per-item files.\n\n## FAQ\n\n**How much does an AgentFlare .data.json request cost?**\nSocial, predictions and crypto are each priced at 0.01 USD per request for .data.json and .full.md files. News is 0.005, and research and scholar are 0.02. Index pages, .html articles and .md teasers are free.\n\n**Which header carries the crawler token?**\nX-Crawler-Token. It replaces the earlier X-AISA-Crawler-Token still shown on older AISA pages. Do not use Authorization: Bearer, which is reserved for the gateway layer.\n\n**What does a prediction event file contain?**\nIt has data.event, data.slug, data.volume_usd, data.volume_24h_usd, data.end_date, data.tags and data.markets[]. Each market has a question, odds and its own volume_usd.\n\n**How do I get 90 days of price history for a coin?**\nFetch the per-coin file, for example https://agentflare.org/crypto/zcash.data.json. Its data.history_90d[] array holds date and price entries, alongside data.ath_usd, data.atl_usd and data.supply.\n", "sources": [ { "title": "Header name: X-Crawler-Token", "url": "https://esa.aisa.one/cdn/open-verify.html" }, { "title": "AgentFlare Social Pulse .data.json field reference", "url": "https://agentflare.org/social/index.html" }, { "title": "AgentFlare Predictions .data.json field reference", "url": "https://agentflare.org/predictions/index.html" }, { "title": "AgentFlare Crypto .data.json field reference", "url": "https://agentflare.org/crypto/index.html" }, { "title": "AgentFlare pricing.json (directory price map)", "url": "https://agentflare.org/pricing.json" } ], "related": [ { "name": "Reading .data.json: A Field Guide for Agents", "url": "https://agentflare.org/guides/reading-datajson-a-field-guide-for-agents.html" }, { "name": "Using AgentFlare Newswire and Markets Data", "url": "https://agentflare.org/guides/using-agentflare-newswire-and-markets-data.html" }, { "name": "Using AgentFlare Research and Scholar Data", "url": "https://agentflare.org/guides/using-agentflare-research-and-scholar-data.html" }, { "name": "Getting Started with HTTP 402 Pay-Per-Crawl", "url": "https://agentflare.org/guides/getting-started-with-http-402-pay-per-crawl.html" }, { "name": "Crawler Tokens & Auto-Pay: A How-To", "url": "https://agentflare.org/guides/crawler-tokens-auto-pay-a-how-to.html" }, { "name": "Handling 402 and 403 Responses: An Error Reference for Agents", "url": "https://agentflare.org/guides/handling-402-and-403-responses-an-error-reference-for-agents.html" } ], "pricing": { "price_usd": 0, "method": "402", "endpoint": "https://esa.aisa.one/api/v1/access/verify", "autopay_hint": "set crawlerAutoPrice=true with the X-Crawler-Token header", "onboarding": "https://esa.aisa.one/agent/guide.html" }, "powered_by": "AISA — agent-native search, settlement & delivery (https://aisa.one)" }