> For the complete documentation index, see [llms.txt](https://docs.getshio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getshio.com/archived-searcher-guides/connect-to-shio-feed/auctionstarted-event.md).

# auctionStarted Event

{% hint style="danger" %}
Shio permanently shut down on 12 May 2026. This page is kept as a historical reference only; the Shio feed, bidding APIs, explorer, and RPC endpoints are no longer active.
{% endhint %}

Shio partnered with order flow originators to conduct auctions on incoming transactions before they were seen by others or included. An opportunity transaction was qualified when:

* The transaction contains at least one shared object as input.
* The transaction mutated at least one shared object.
* The transaction passes dry-run against the current world state.

Upon such opportunity transaction, an auction would start, with an `auctionStarted` event emitted and broadcasted. Shio did not reveal the content of the transaction, only its side effects from execution, including events and objects that had been created or mutated. Full content of all mutated or created objects was provided so that a searcher could know how the world state would change by executing that opportunity transaction.

An example event:

```json
{
  "auctionStarted": {
    "txDigest": "E72mG9GCroPgaw9uoeGiKLzAfd9CZq82iGDjypKdzYG7",
    "gasPrice": 1000,
    "deadlineTimestampMs": 1724407712127,
    "sideEffects": {
      "events": [
        {
          "id": {
            "txDigest": "Fwk579gVYwgFzzatLoMArrcsUDUC1MfZY3KKDiu8kgYv",
            "eventSeq": "0"
          },
          "packageId": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1",
          "transactionModule": "swap_router",
          "sender": "0x95467064654beef88fe614c64fde3442e9ea1fe588f5dc6a34ded901f912a521",
          "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::SwapEvent",
          "parsedJson": {
            "a_to_b": true,
            "amount_a": "100000000",
            "amount_b": "84567",
            "fee_amount": "300000",
            "is_exact_in": true,
            "liquidity": "2260963199258975",
            "pool": "0x5eb2dfcdd1b15d2021328258f6d5ec081e9a0cdcfa9e13a0eaeb9b5f7505ca78",
            "protocol_fee": "90000",
            "recipient": "0x95467064654beef88fe614c64fde3442e9ea1fe588f5dc6a34ded901f912a521",
            "sqrt_price": "537247640199413000",
            "tick_current_index": {
              "bits": 4294896568
            },
            "tick_pre_index": {
              "bits": 4294896568
            }
          },
          "bcs": "3QNkC7BY24vRTkQLNuStgph6rJoueLph5XBahSy5PAjZfJGPd8qcGAFA1dqaFW5CfeH12kX9bK2fBVGjhdRXqS65YDzRtonmwmFvFUpgT34uZn5iSwpQMGLhEx7wVAwDs3bg5hVEPKFbdSjDnxhxYK8M82rVuQ24GA6XV3ermPYWBdS5B8Qobv5scyFV2"
        }
      ],
      "createdObjects": [],
      "mutatedObjects": [
        {
          "id": "0x5eb2dfcdd1b15d2021328258f6d5ec081e9a0cdcfa9e13a0eaeb9b5f7505ca78",
          "objectType": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::Pool<0x2::sui::SUI, 0x5d4b302506645c37ff133b98c4b50a5ae14841659738d6d733d59d0d217a93bf::coin::COIN, 0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::fee3000bps::FEE3000BPS>",
          "owner": {
            "Shared": {
              "initial_shared_version": 1731023
            }
          },
          "content": {
            "dataType": "moveObject",
            "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::Pool<0x2::sui::SUI, 0x5d4b302506645c37ff133b98c4b50a5ae14841659738d6d733d59d0d217a93bf::coin::COIN, 0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::fee3000bps::FEE3000BPS>",
            "hasPublicTransfer": true,
            "fields": {
              "coin_a": "2346002989765222",
              "coin_b": "817618609593",
              "deploy_time_ms": "1683216776913",
              "fee": 3000,
              "fee_growth_global_a": "62310876755876845895",
              "fee_growth_global_b": "54918657491646434",
              "fee_protocol": 300000,
              "id": {
                "id": "0x5eb2dfcdd1b15d2021328258f6d5ec081e9a0cdcfa9e13a0eaeb9b5f7505ca78"
              },
              "liquidity": "2260963199258975",
              "max_liquidity_per_tick": "23012265295255187899058267899625901",
              "protocol_fees_a": "43074990201088",
              "protocol_fees_b": "36455103885",
              "reward_infos": [
                {
                  "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::PoolRewardInfo",
                  "fields": {
                    "emissions_per_second": "0",
                    "growth_global": "7236466772288572909907",
                    "id": {
                      "id": "0x3002004301f7e490b3bb8501444bf732a8a05174c673840d87e1651669a6944c"
                    },
                    "manager": "0x0a475e3bd09b7e38ef8e200dcf81b55630f7f8c93f4465005316002184051ea2",
                    "vault": "0x40610ed06fb4a1c327eb2e393d6bc9105067b47d6ba3ce521b685fa2caf81cd6",
                    "vault_coin_type": "5d1f47ea69bb0de31c313d7acf89b890dbb8991ea8e03c6c355171f84bb1ba4a::turbos::TURBOS"
                  }
                },
                {
                  "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::PoolRewardInfo",
                  "fields": {
                    "emissions_per_second": "566470899603562006612803584",
                    "growth_global": "73856427630746155393",
                    "id": {
                      "id": "0xe663f51dfb74a6594da5e4958dd1c2a2c52bb916f319b329f2730cc4e3d86071"
                    },
                    "manager": "0x0a475e3bd09b7e38ef8e200dcf81b55630f7f8c93f4465005316002184051ea2",
                    "vault": "0x197289658606f39bc61f1ce1c61d56c237bc9eb392538afb6f95272e197f0c41",
                    "vault_coin_type": "0000000000000000000000000000000000000000000000000000000000000002::sui::SUI"
                  }
                },
                {
                  "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::PoolRewardInfo",
                  "fields": {
                    "emissions_per_second": "0",
                    "growth_global": "371156063495608078676",
                    "id": {
                      "id": "0x2a0d34f24d7b685b4b7f68724fb759e467a2563f356f7869677f1b0dc3085af9"
                    },
                    "manager": "0x0a475e3bd09b7e38ef8e200dcf81b55630f7f8c93f4465005316002184051ea2",
                    "vault": "0x8e18933f656dbec6482593025c110430f102e1fa54db06b04059ccaf0fcceca9",
                    "vault_coin_type": "5d1f47ea69bb0de31c313d7acf89b890dbb8991ea8e03c6c355171f84bb1ba4a::turbos::TURBOS"
                  }
                }
              ],
              "reward_last_updated_time_ms": "1724043071740",
              "sqrt_price": "537247640199413000",
              "tick_current_index": {
                "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::i32::I32",
                "fields": {
                  "bits": 4294896568
                }
              },
              "tick_map": {
                "type": "0x2::table::Table<0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::i32::I32, u256>",
                "fields": {
                  "id": {
                    "id": "0xd836ea2a159743a568fe29e8f42672a1b88414ab21be5411f8f6331e66b218d3"
                  },
                  "size": "16"
                }
              },
              "tick_spacing": 60,
              "unlocked": true
            }
          },
          "rawContent": "XrLfzdGxXSAhMoJY9tXsCB6aDNz6nhOg6uubX3UFynhm0thirVUIALnl3V2+AAAAAFl9LS0nAACNveR8CAAAAAi9gN7hr3QHAAAAAAAAAAC46/7/PAAAAK0B9ejQ34Ckdil3n5duBAC4CwAA4JMEAAFHGS+1RbS8YAMAAAAAAAAA4rdUXzocwwAAAAAAAAAAAF+RV4RVCAgAAAAAAAAAAADYNuoqFZdDpWj+Kej0JnKhuIQUqyG+VBH49jMeZrIY0xAAAAAAAAAA0b6J54cBAAADMAIAQwH35JCzu4UBREv3MqigUXTGc4QNh+FlFmmmlExAYQ7Qb7ShwyfrLjk9a8kQUGe0fWujzlIbaF+iyvgc1lA1ZDFmNDdlYTY5YmIwZGUzMWMzMTNkN2FjZjg5Yjg5MGRiYjg5OTFlYThlMDNjNmMzNTUxNzFmODRiYjFiYTRhOjp0dXJib3M6OlRVUkJPUwAAAAAAAAAAAAAAAAAAAABTafLJ83wmSogBAAAAAAAACkdeO9CbfjjvjiANz4G1VjD3+Mk/RGUAUxYAIYQFHqLmY/Ud+3SmWU2l5JWN0cKixSu5FvMZsynycwzE49hgcRlyiWWGBvObxh8c4cYdVsI3vJ6zklOK+2+VJy4ZfwxBSjAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDI6OnN1aTo6U1VJAAAAAAAAAADhktQBAAAAAIE5+D2fvfYABAAAAAAAAAAKR1470Jt+OO+OIA3PgbVWMPf4yT9EZQBTFgAhhAUeoioNNPJNe2hbS39ock+3WeRnolY/NW94aWd/Gw3DCFr5jhiTP2VtvsZIJZMCXBEEMPEC4fpU2wawQFnMrw/M7KlQNWQxZjQ3ZWE2OWJiMGRlMzFjMzEzZDdhY2Y4OWI4OTBkYmI4OTkxZWE4ZTAzYzZjMzU1MTcxZjg0YmIxYmE0YTo6dHVyYm9zOjpUVVJCT1MAAAAAAAAAAAAAAAAAAAAAVBEMuEc50x4UAAAAAAAAAApHXjvQm344744gDc+BtVYw9/jJP0RlAFMWACGEBR6i/JD5aJEBAAA="
        }
      ],
      "gasUsage": 14523600
    }
  }
}
```

* `events`: Events emitted from executing the transaction.
* `mutatedObjects` / `createdObjects`:
  * Objects that has been mutated by the opportunity transaction. Each object will carry all its fields (regardless the field has changed or not).
  * `rawContent`is the serialized representation of the object, which can be used as an alternative to JSON representation for faster parsing.
  * Object with content larger than 4KB will be omitted from transmission.

Historically, searchers could use [wscat](https://github.com/websockets/wscat) or similar tools to connect to the Feed. This WebSocket endpoint is no longer active.

```bash
wscat --connect wss://rpc.getshio.com/feed
```

Note that because `wscat` do not respond to PingMessage, you connection will only be maintained for a couple of minutes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getshio.com/archived-searcher-guides/connect-to-shio-feed/auctionstarted-event.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.