whatisgithub

What is agorafx?

musaais/agorafx — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · developerComplexity · 4/5Setup · hard

In one sentence

An autonomous AI agent that monitors African FX rates and automatically creates and resolves on-chain prediction markets.

Mindmap

mindmap
  root((repo))
    What it does
      Monitors FX rates
      Opens prediction markets
      Resolves markets automatically
    Tech stack
      Python
      FastAPI
      Solidity
      React
      Groq Llama 3.3
    Use cases
      Bet on Naira rate moves
      Bet on EURC USDC moves
      Study autonomous agent design
    Audience
      Crypto users
      Hackathon judges
    Setup
      pip install deps
      Needs Groq and RPC keys
    Notes
      Runs on Arc Testnet
      Built for a hackathon

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Bet on whether the USDC to Naira rate will move up or down.

USE CASE 2

Bet on EURC to USDC rate momentum using an on-chain market.

USE CASE 3

Study how an AI agent can autonomously open and resolve prediction markets.

USE CASE 4

Run the agent, backend, and contracts locally to extend the hackathon project.

What is it built with?

PythonFastAPISolidityReactGroq

How does it compare?

musaais/agorafx0marildo/imagoagentlexi/agent-lexi
Stars333
LanguagePythonPythonPython
Setup difficultyhardeasymoderate
Complexity4/52/54/5
Audiencedevelopergeneralvibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a deployer wallet key, Groq API key, and Arc Testnet RPC access.

The README does not state license terms.

So what is it?

AgoraFX is a prediction market app focused on African foreign exchange rates, specifically the USDC to Nigerian Naira rate and the EURC to USDC rate. Instead of a person deciding when to open a new betting market, an autonomous AI agent watches these rates around the clock and creates and resolves the markets on its own, without a human stepping in. The agent has three parts that run on a loop. Every 30 seconds it checks the current EURC/USDC rate from OKX and the USDC/NGN rate from Flutterwave. Every 5 minutes it feeds the recent rate history to a Llama 3.3 model running on Groq, which returns a structured decision about whether a new market should open and what its parameters should be, if nothing shows strong momentum and no market is currently active, it falls back to opening a market on a fixed schedule instead. Every 60 seconds it checks whether any open market has expired, and if so it resolves that market using the final observed rate. Users interact with the app by connecting a crypto wallet, choosing YES or NO on a rate prediction, and depositing USDC. If they guess correctly, they receive a proportional payout drawn from the pool of money bet on the losing side. All of this settlement happens on Arc Testnet, a blockchain built by Circle, which the README says offers fast finality and gas fees around one cent, paid in USDC rather than a separate gas token. The project is split into an agent folder for the AI logic, a FastAPI backend, a set of Solidity smart contracts, and a separate React frontend deployed on Vercel, with a live demo linked in the README. Running it locally requires installing several Python packages including web3, FastAPI, and the Groq client, then setting environment variables for the Arc Testnet RPC URL, a deployer wallet key, the deployed contract address, and a Groq API key, with an optional Flutterwave key for the Naira rate feed. The project was built for the Agora Agent Hackathon hosted by The Canteen alongside Arc and Circle.

Copy-paste prompts

Prompt 1
Help me set up the environment variables and run the AgoraFX agent locally.
Prompt 2
Explain how the Rate Monitor, Decision Engine, and Resolver loops work together in AgoraFX.
Prompt 3
Walk me through how AgoraFX uses Llama 3.3 on Groq to decide when to open a market.
Prompt 4
Show me the AgoraFX smart contract addresses and what each one does on Arc Testnet.

Frequently asked questions

What is agorafx?

An autonomous AI agent that monitors African FX rates and automatically creates and resolves on-chain prediction markets.

What language is agorafx written in?

Mainly Python. The stack also includes Python, FastAPI, Solidity.

What license does agorafx use?

The README does not state license terms.

How hard is agorafx to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is agorafx for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.