Predict the Future with GFS API
← Back to Home | For Researchers → | For Investors →
Production-ready AI system for forecasting social, geopolitical, and economic events through dream analysis
Key Features
- ✅ Multi-Pass Analysis Pipeline - Advanced LLM processing
- ✅ Real-Time API Access - Fast, reliable endpoints
- ✅ Comprehensive Documentation - Full API reference
- ✅ Free Trial Available - Start testing immediately
What is GFS API?
Powerful Forecasting API
The Global Forecasting System (GFS) API provides programmatic access to our advanced AI-powered forecasting platform. Analyze dream narratives and altered states of consciousness to extract predictive signals about future events.
How It Works:
- Submit Dream Text - Send dream narratives via API
- Multi-Pass Analysis - Advanced AI pipeline processes the input
- Event Extraction - Identifies concrete, real-world events
- Classification - Categorizes into economic/social/geopolitical spheres
- Verification - Validates against real-world evidence
- Results - Returns structured predictions with confidence scores
Key Capabilities:
- Event extraction from dream narratives
- Sphere classification (economic/social/geopolitical)
- Economic mapping to NAICS industries
- News verification with temporal windows
- Similar dreams search
- Causal reasoning
- Fact-checking pipeline
Use Cases {#use-cases}
What Can You Build with GFS?
A. Financial Applications
Stock Market Prediction
- Analyze dreams for market signals
- Get predictions with confidence scores
- Integrate into trading algorithms
- Risk assessment and portfolio management
Investment Strategy Development
- Identify emerging trends
- Market sentiment analysis
- Sector-specific predictions
- Investment decision support
Risk Assessment
- Early warning signals
- Market volatility prediction
- Crisis detection
- Portfolio risk management
Market Trend Analysis
- Long-term trend identification
- Short-term movement prediction
- Sector rotation signals
- Market timing insights
Polymarket Integration & Automated Trading
- Connect Polymarket accounts for automated asset management
- Automated bet placement based on GFS predictions
- Portfolio tracking and performance analytics
- Risk management and position sizing
- Real-time market scanning and opportunity identification
- Secure account connection with OAuth 2.0 authentication
B. Geopolitical Intelligence
Political Event Prediction
- Election outcomes
- Policy changes
- Government transitions
- Political stability assessment
Conflict Forecasting
- International conflicts
- Regional tensions
- War probability assessment
- Peace process monitoring
Policy Impact Analysis
- Policy effectiveness prediction
- Regulatory impact assessment
- International relations changes
- Diplomatic event forecasting
International Relations Monitoring
- Alliance changes
- Trade agreement impacts
- Sanction effects
- Global power shifts
C. Social Analytics
Social Movement Forecasting
- Protest prediction
- Social unrest indicators
- Movement growth patterns
- Public opinion shifts
Public Sentiment Analysis
- Mood tracking
- Opinion trends
- Sentiment shifts
- Cultural changes
Trend Prediction
- Fashion trends
- Cultural movements
- Lifestyle changes
- Generational shifts
Behavioral Analysis
- Consumer behavior
- Social patterns
- Group dynamics
- Collective actions
D. Research Applications
Academic Research
- Hypothesis testing
- Data collection
- Pattern analysis
- Validation studies
Data Analysis
- Large-scale dream analysis
- Correlation studies
- Statistical modeling
- Predictive analytics
Hypothesis Testing
- Research validation
- Theory testing
- Methodology development
- Experimental design
Validation Studies
- Prediction accuracy testing
- Model validation
- Cross-validation
- Replication studies
API Capabilities {#api-capabilities}
API Features & Endpoints
A. Core Endpoints
Full Analysis
POST /analyze
- Complete multi-pass analysis
- Event extraction, classification, mapping, verification
- Response time: 15-25 seconds
- Returns: Events, spheres, industries, evidence, predictions
Quick Events
POST /events
- Fast event extraction only (Pass 1)
- Response time: 3-5 seconds
- Returns: Extracted events with confidence scores
Similar Dreams Search
POST /similar
- Find semantically similar dreams
- Vector-based search (FAISS)
- Response time: 0.5-2 seconds
- Returns: Similar dreams with similarity scores
Prediction Verification
GET /prediction/verify
- Verify predictions against real-world evidence
- Temporal windows, GDELT integration
- Response time: 50-65 seconds
- Returns: Verified predictions with evidence
B. Key Features
Multi-Pass LLM Pipeline
- Pass 1: Event Extraction (PropBank SRL)
- Pass 2: Sphere Classification
- Pass 3: Economic Mapping (NAICS)
- Pass 4: News Verification
- Pass 5: LLM Verification
- Pass 6: Scientific Formatting
- Pass 7: Polymarket Betting & Asset Management
Event Extraction
- PropBank Semantic Role Labeling
- Up to 3 events per dream
- Confidence scoring
- Evidence extraction
Sphere Classification
- Economic events
- Social events
- Geopolitical events
- Multi-sphere support
Economic Mapping
- NAICS taxonomy integration
- Industry codes
- Ticker mapping
- Market sector identification
News Verification
- GDELT integration
- Google CSE search
- NewsAPI integration
- Government sources
- Temporal windows
- Evidence levels (L1/L2/L3)
Causal Reasoning
- Multi-hop causal chains
- Domain agents (Military, Academic, Regulatory, Economic, Financial)
- Knowledge graph (JanusGraph/NetworkX)
- Path finding
Fact-Checking
- 5-stage pipeline
- Hybrid retrieval (FAISS+BM25F)
- NLI verification
- Evidence aggregation
C. Performance
Response Times:
- Quick Events: 3-5 seconds
- Full Analysis: 15-25 seconds
- Verification: 50-65 seconds
- Similar Search: 0.5-2 seconds
Scalability:
- Horizontal scaling supported
- Load balancing
- Caching layers
- Rate limiting
Rate Limits:
- Free tier: 100 requests/day
- Professional tier: 1,000 requests/day
- Enterprise tier: Custom limits
Uptime SLA:
- Free tier: Best effort
- Professional tier: 99% uptime
- Enterprise tier: 99.9% uptime SLA
Quick Start
Get Started in Minutes
Step 1: Sign Up
- Create account at API Portal
- Get your API key
- Free tier available (no credit card required)
- Start with 100 requests/day
Sign Up: Get API Key →
Step 2: Try Demo
Interactive Demo:
- Test API with example dream text
- See real-time analysis results
- Explore response structure
- Understand capabilities
Example Request:
curl -X POST https://api.gfs.asrp.tech/analyze \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"dream_text": "I dreamed about a tech company launching a revolutionary product...",
"search_similar": true,
"similar_k": 10
}'
Example Response:
{
"events": [
{
"event_id": "e1",
"headline": "Tech company launches revolutionary product",
"confidence": 0.85
}
],
"spheres": ["economic"],
"primary_industry": {
"id": "51",
"path": "Information"
},
"verification": {
"status": "verified",
"confidence": 0.75,
"total_evidence": 5
}
}
Step 3: Integrate
SDKs Available:
Python SDK:
from gfs import GFSClient
client = GFSClient(api_key="YOUR_API_KEY")
result = client.analyze(
dream_text="Your dream text here",
search_similar=True
)
print(result.events)
JavaScript SDK:
const { GFSClient } = require('@asrp/gfs-sdk');
const client = new GFSClient({ apiKey: 'YOUR_API_KEY' });
const result = await client.analyze({
dreamText: 'Your dream text here',
searchSimilar: true
});
console.log(result.events);
REST API:
- Standard HTTP requests
- JSON request/response
- Comprehensive error handling
- Webhook support (Enterprise)
Documentation & Resources
Developer Resources
A. Documentation
API Reference:
- Complete endpoint documentation
- Request/response schemas
- Error codes and handling
- Authentication guide
Integration Guides:
- Getting started tutorial
- Best practices
- Common use cases
- Troubleshooting
Code Examples:
- Python examples
- JavaScript examples
- cURL examples
- Real-world scenarios
Best Practices:
- Rate limiting handling
- Error handling
- Caching strategies
- Performance optimization
B. SDKs & Libraries
Python SDK:
- Full API coverage
- Type hints
- Async support
- Comprehensive documentation
JavaScript SDK:
- Node.js and browser support
- TypeScript definitions
- Promise-based API
- Error handling
REST API:
- Standard HTTP/JSON
- Works with any language
- Webhook support
- WebSocket support (coming soon)
Community Libraries:
- Community-contributed wrappers
- Language-specific implementations
- Integration examples
C. Support
Community Forum:
- Ask questions
- Share examples
- Get help from community
- Feature requests
Support Tickets:
- Email support (Professional/Enterprise)
- Priority support (Enterprise)
- Technical assistance
- Bug reports
Email Support:
- api-support@asrp.tech
- Response time: 24-48 hours (Professional), <24 hours (Enterprise)
Office Hours:
- Weekly office hours (Enterprise)
- Direct access to team
- Technical consultations
- Architecture reviews
Pricing
Simple, Transparent Pricing
A. Free Tier
Perfect for Testing
- Requests: 100 requests/day
- Features: Basic analysis, event extraction
- Support: Community forum
- Uptime: Best effort
- Price: Free
Use Cases:
- Testing and evaluation
- Personal projects
- Learning and exploration
- Small-scale research
B. Professional Tier
For Growing Applications
- Requests: 1,000 requests/day
- Features: Full analysis, verification, similar search
- Support: Email support (24-48h response)
- Uptime: 99% SLA
- Price: $99/month
Use Cases:
- Small businesses
- Research projects
- Prototype applications
- Medium-scale integrations
C. Enterprise Tier
For Production Applications
- Requests: Custom limits
- Features: All features, custom integrations
- Support: Priority support (<24h), dedicated account manager
- Uptime: 99.9% SLA
- Price: Custom pricing
Additional Benefits:
- Custom integrations
- White-label options
- Dedicated infrastructure
- SLA guarantees
- Training and onboarding
Use Cases:
- Large enterprises
- Financial institutions
- Government agencies
- High-volume applications
Live Demo
Try GFS Now
Interactive Demo Interface:
Enter your dream text below to see GFS in action:
[Demo Input Field]
Example: "I dreamed about a company launching a new product that changed the industry..."
Analysis Results:
- Extracted events
- Sphere classification
- Industry mapping
- Verification status
- Similar dreams
Try It: Launch Demo →
Success Stories
Who's Using GFS?
Research Institutions:
- Using GFS for academic research
- Validating predictions
- Analyzing dream patterns
- Publishing results
Financial Firms:
- Integrating GFS into trading systems
- Market prediction
- Risk assessment
- Investment strategies
Technology Companies:
- Building forecasting applications
- Integrating GFS API
- Creating new products
- Enhancing existing services
Individual Developers:
- Personal projects
- Experimentation
- Learning AI/ML
- Building prototypes
Polymarket Integration
Automated Prediction Market Trading
GFS provides comprehensive integration with Polymarket, the leading prediction market platform, enabling automated asset management and trading based on GFS forecasts.
Key Features
Account Connection:
- Connect your Polymarket accounts securely
- OAuth-based authentication
- Multiple account support
- Secure credential storage
Automated Trading:
- Automated bet placement based on GFS predictions
- Real-time market scanning for opportunities
- Intelligent position sizing based on confidence scores
- Risk management and stop-loss mechanisms
Asset Management:
- Portfolio tracking and analytics
- Balance monitoring across accounts
- Trade history and performance metrics
- Profit/loss analysis
- Risk assessment and exposure tracking
Market Intelligence:
- Real-time market data access
- Market trend analysis
- Opportunity identification
- Competitive market scanning
How It Works
- Connect Account: Securely link your Polymarket account via API
- Configure Strategy: Set risk parameters, position sizes, and trading rules
- Enable Automation: Activate automated trading based on GFS predictions
- Monitor Performance: Track trades, profits, and portfolio performance
- Optimize: Adjust strategies based on performance data
Security & Privacy
- Secure Authentication: OAuth 2.0 protocol
- Encrypted Storage: All credentials encrypted at rest
- API Key Management: Secure key rotation and management
- Access Control: Role-based permissions
- Audit Logging: Complete transaction history
Use Cases
- Automated Trading: Let GFS place bets automatically based on predictions
- Portfolio Management: Track and optimize your prediction market portfolio
- Risk Management: Set limits and risk parameters for automated trading
- Research & Testing: Test trading strategies with paper trading mode
- Performance Analytics: Analyze trading performance and optimize strategies
API Endpoints
Account Management:
POST /polymarket/accounts/connect- Connect Polymarket accountGET /polymarket/accounts- List connected accountsDELETE /polymarket/accounts/{id}- Disconnect account
Trading:
POST /polymarket/bets/place- Place automated betGET /polymarket/bets- List bets and positionsGET /polymarket/bets/{id}- Get bet details
Portfolio:
GET /polymarket/portfolio- Get portfolio overviewGET /polymarket/balance- Get account balancesGET /polymarket/performance- Get performance metrics
Market Data:
GET /polymarket/markets- Scan available marketsGET /polymarket/markets/{id}- Get market detailsGET /polymarket/trends- Analyze market trends
API Endpoints Reference
Core Analysis Endpoints
POST /analyze
Full multi-pass analysis with optional similar dreams search.
Request:
{
"dream_text": "Your dream narrative...",
"search_similar": true,
"similar_k": 10,
"similar_scope": "global",
"include_news": true
}
Response: Complete analysis with events, spheres, industries, verification, similar dreams.
POST /events
Quick event extraction (Pass 1 only).
Request:
{
"dream_text": "Your dream narrative..."
}
Response: Extracted events with confidence scores.
POST /similar
Similar dreams search.
Request:
{
"text": "Query text...",
"k": 10,
"scope": "global",
"use_pass1": true,
"translate": true
}
Response: Similar dreams with similarity scores.
GET /prediction/verify
Prediction verification with temporal windows.
Query Parameters:
prediction_text: The prediction to verifyprediction_date: Date of predictiontemporal_window_days: Days to search (default: 30)enable_fact_checking: Enable fact-checking (default: false)
Response: Verified predictions with evidence and confidence scores.
Financial Data Endpoints
GET /naics/{code}/tickers
Get tickers for a NAICS industry code.
Response: List of tickers with company information.
GET /quote/{ticker}
Get real-time stock quote.
Response: Current price, volume, market data.
GET /history/{ticker}
Get historical price data.
Query Parameters:
start: Start date (YYYY-MM-DD)end: End date (YYYY-MM-DD)interval: 1d, 1h, etc.
Response: Historical price data.
Code Examples
Python Example
from gfs import GFSClient
# Initialize client
client = GFSClient(api_key="YOUR_API_KEY")
# Analyze a dream
result = client.analyze(
dream_text="""
I dreamed about watching a live presentation where a CEO
unveiled a tiny, glowing chip that could process information
at incredible speeds...
""",
search_similar=True,
similar_k=5
)
# Access results
print(f"Extracted Events: {len(result.events)}")
for event in result.events:
print(f"- {event.headline} (confidence: {event.confidence})")
print(f"Primary Sphere: {result.primary_sphere}")
print(f"Primary Industry: {result.primary_industry}")
if result.verification:
print(f"Verification Status: {result.verification.status}")
print(f"Confidence: {result.verification.confidence}")
JavaScript Example
const { GFSClient } = require('@asrp/gfs-sdk');
// Initialize client
const client = new GFSClient({
apiKey: 'YOUR_API_KEY'
});
// Analyze a dream
const result = await client.analyze({
dreamText: `
I dreamed about watching a live presentation where a CEO
unveiled a tiny, glowing chip that could process information
at incredible speeds...
`,
searchSimilar: true,
similarK: 5
});
// Access results
console.log(`Extracted Events: ${result.events.length}`);
result.events.forEach(event => {
console.log(`- ${event.headline} (confidence: ${event.confidence})`);
});
console.log(`Primary Sphere: ${result.primarySphere}`);
console.log(`Primary Industry: ${result.primaryIndustry}`);
if (result.verification) {
console.log(`Verification Status: ${result.verification.status}`);
console.log(`Confidence: ${result.verification.confidence}`);
}
cURL Example
# Full analysis
curl -X POST https://api.gfs.asrp.tech/analyze \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"dream_text": "I dreamed about a tech launch...",
"search_similar": true,
"similar_k": 10
}'
# Quick events only
curl -X POST https://api.gfs.asrp.tech/events \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"dream_text": "I dreamed about a tech launch..."
}'
# Similar dreams search
curl -X POST https://api.gfs.asrp.tech/similar \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Tech company launch",
"k": 10
}'
Contact & Support {#contact}
Get Help
API Support:
Email: api-support@asrp.tech
Sales Inquiries:
Email: sales@asrp.tech
General Questions:
Email: info@asrp.tech
Response Times:
- Free tier: Community forum
- Professional tier: 24-48 hours
- Enterprise tier: <24 hours
Sign Up Form
Start Free Trial
- Email address
- Use case description
- Company (optional)
- Expected usage
Get Started: Sign Up →
Additional Resources
Documentation Links
- Full API Documentation - Complete technical reference
- GFS Comprehensive Analysis - Full system overview
- Research Papers - Scientific foundation
- Technology Overview - Technical architecture
Links
- For Researchers - Scientific collaboration
- For Investors - Investment opportunities
- Back to Home - Main landing page
© 2023-2026 ASRP LLC. All Rights Reserved.
Predicting the Future Through Advanced AI Technology