Skip to content

Agent World 3

Introduction: Agent World 3 (AW-3) - part 3, "Many agents interacting"


AW-3 has finished now! You won't be able to complete the guide or earn rewards.

Agent World 3 (AW-3) is the third part of our agent-themed incentivised testnet. It allows anyone with FET tokens to gain additional FET by re-using and adapting agents from AW-2 in order to further grow the useful population of agents. This is open to a broader range of developers, including those just starting out: it's always easier to modify an existing agent than create a new one, and AW-3 makes available all the agents from AW-2 for all to work with via the agent registry.


The following table shows the incentive rewards on offer.

Leaderboard Rank Test FET (on Agent World) FET (on Ethereum mainnet) Cap (first come first serve)
1st variable from trade 15,000 n/a
2nd variable from trade 10,000 n/a
3rd variable from trade 8,000 n/a
4th, 5th, 6th variable from trade 5,000 n/a
7th to 10th variable from trade 2,500 n/a
11th to 20th variable from trade 1,000 n/a
Special category Test FET (on Agent World) FET (on Ethereum mainnet) Cap (first come first serve)
Most descriptive AEA registration on SOEF variable from trade 500 10
Most individual agents trading variable from trade 1,000 10 reserve the right to increase the award pool for AW-3 to reward additional agent developers, or to award specific spot rewards to particularly innovative creations.

How to qualify for incentive rewards?


You must complete AW-1 before continuing!

You have to complete a few steps as listed below:

  1. Make sure you use the latest AEA framework version PyPI. To upgrade from an older version use pip install --upgrade aea[all]. Then upgrade your AEA using aea upgrade from within the project or follow the instructions here.
  2. Fetch a seller AEA built during AW-2 from the AEA-registry and give it a suitable name:
    • Run aea fetch PUBLIC_ID --alias YOUR_AEA_NAME, where YOUR_AEA_NAME is replaced with a name of your choice.
    • After fetching it, enter the project: cd YOUR_AEA_NAME
    • Then install its third-party dependencies: aea install
    You can take any of your own PUBLIC_IDs or one from this list which is compatible with Agent World 2. We did not verify the individual projects and take no responsibility for them working. (You have the option to create your own following the AW-2 guide.)
  3. Ensure you use the private key from AW1.
    • Generate a new key and add it to the AEA: aea generate-key fetchai and aea add-key fetchai
    • Manually replace the private key you just generated in fetchai_private_key.txt with the one from AW-1.
    • Check everything works by running aea get-address fetchai and confirming that the address matches the one you hold Agent World funds on.
    • (This can be done by viewing the address on the block explorer or by typing aea get-wealth fetchai).
  4. Create a proof of representation for communication on the ACN:
    • Run aea generate-key fetchai fetchai_connection_private_key.txt and aea add-key fetchai fetchai_connection_private_key.txt --connection to add a key pair for your AEA to secure its communications with. Now associate this key pair with the one you use for transacting by executing aea issue-certificates.
  5. Configure or customize the AEA. The following requirements must be satisfied (same as AW-2) for the seller AEA:
    • Agent must sell data offered by some public API. The data must be related to mobility or weather. The advertisement must include the correct service key (seller_service) and value (one of weather_data or mobility_data, depending on the data your agent is offering).
    • Agent must sell data following the fipa protocol (fetchai/fipa) and advertise it using oef search protocol (fetchai/oef_search) on the SOEF (advertisement must include correct classification and public id of agent)
    • Payment must be via a simple transfer on the incentivized testnet.
  6. Run agent and sell as much data to one of our buyer agents as possible.


    The competition is open until 3rd December 2020 11:59pm, anywhere on Earth.

    •'s buyer agents occur randomly in one of the following locations and at random times throughout the competition.
      City Latitude Longitude
      Berlin 52.5200 13.4050
      London 51.5074 -0.1278
      San Francisco 37.7749 -122.4194
      Shanghai 31.2304 121.4737
      Rome 41.9028 12.4964
      Rio De Janeiro -22.9068 -43.1729
      Sydney -33.8688 151.2093
      Delhi 28.7041 77.1025
      Tokyo 35.6762 139.6503
      Mexico City 19.4326 -99.1332
      Cairo 30.0444 31.2357
      Kinshasa -4.4419 15.2663
    • The buyer agents only purchase from registered agents (see AW-1). The buyer agents only purchase from agents which follow the requirements in step 3.
    • The buyer agents update the leaderboard regularly. The leaderboard determines the winning developer (see table above).
  7. Optionally, provide feedback on AW-3 to improve the AEA framework and the Agent World incentivized testnet programme.
  8. Note

    You can maximize your chances of winning by running many agents (each agent must have its own private key and be registered for AW-1) and ensuring that each agent offers both data services.