How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Mango Markets

Mango v4 Fills Feed

Low-latency WebSocket feed (service-mango-fills) that parses Mango V4 Perp and Openbook event queues and emits individual fill events as they are processed by the validator. Supports getMarkets discovery, subscribe / unsubscribe by marketIds or by Mango account, and an optional headUpdates mode that emits event-queue head pointer updates. Fill events that occurred on a fork are revoked via a status='revoke' message.

Documentation Provider Profile APIs.io AsyncAPI GitHub

Mango v4 Fills Feed is one of 2 APIs that Mango Markets publishes on the APIs.io network, described by an AsyncAPI event-driven specification.

Tagged areas include WebSocket, Fills, Market Data, Perpetuals, and Spot. The published artifact set on APIs.io includes API documentation and an AsyncAPI specification.

This event API exposes 4 operations across 2 channels, and defines 28 schemas. It is described by AsyncAPI 2.6.0, at version 1.0.0.

The API connects through 2 servers: fills.mngo.cloud (wss), orderbook.mngo.cloud (wss).

4 operations 2 channels 28 schemas

Metadata

The identity and technical contract details declared by the specification.

Specification
AsyncAPI 2.6.0
API Version
1.0.0
Base URL
wss://fills.mngo.cloud
Contact
Blockworks Foundation
License
AGPL-3.0
Resource Areas
1

Channels & Operations 4

Across 2 channels, the API surfaces 4 operations. Each is listed below with its action, channel, parameters, and response codes.

Channels 4
SUB
/fills
Receive fill events and control responses from the Fills Feed
receiveFillsEvents body
PUB
/fills
Send a command to the Fills Feed server
sendFillsCommand body
SUB
/orderbook
Receive orderbook checkpoints and updates from the Orderbook Feed
receiveOrderbookEvents body
PUB
/orderbook
Send a command to the Orderbook Feed server
sendOrderbookCommand body

Messages & Schemas 28

The contract defines 28 schemas that model the data carried by its messages. The most detailed are FillEvent (12 properties), HeadUpdate (9 properties), FillEventUpdate (6 properties), FillsSubscribeCommand (6 properties). Each schema is shown below with its type and property counts.

GetMarketsCommand
message
Request the list of markets the server currently supports.
FillsSubscribeCommand
message
Subscribe to fill events. Per the service-mango-fills README a client can subscribe by marketIds or by Mango account. The TypeScript client additionally docume…
FillsUnsubscribeCommand
message
Unsubscribe from fill events for a given marketId.
OrderbookSubscribeCommand
message
Subscribe to orderbook updates for a market. subscriptionType=level yields L2 checkpoint plus per-side L2 deltas; subscriptionType=book yields L3 checkpoint pl…
OrderbookUnsubscribeCommand
message
Unsubscribe from orderbook updates for a given marketId.
MarketsList
message
Map of market pubkey - market name returned in response to getMarkets.
SubscriptionAck
message
Server acknowledgement of a subscribe/unsubscribe command.
FillEventUpdate
message
Individual fill event for a Mango V4 Perp or Openbook market. status is 'new' for confirmed fills and 'revoke' when a fill that previously occurred on a fork i…
HeadUpdate
message
Event-queue head pointer update, emitted when the client subscribed with headUpdates=true.
OrderbookL2Checkpoint
message
Initial L2 snapshot delivered immediately after an L2 subscription is accepted. Contains both sides of the book as [price, quantity] pairs.
OrderbookL2Update
message
Per-side L2 delta. Each entry in update is [price, quantity] where a quantity of 0 indicates a level removal.
OrderbookL3Checkpoint
message
Initial L3 snapshot delivered immediately after an L3 subscription is accepted. ownerPubkey is a Mango account for perp markets and an open orders account for…
OrderbookL3Update
message
Per-side L3 delta containing arrays of added and removed orders for a single side of the book.
GetMarketsCommand
object
1 property 1 required
FillsSubscribeCommand
object
6 properties 1 required
OrderbookSubscribeCommand
object
4 properties 3 required
UnsubscribeCommand
object
2 properties 2 required
MarketsList
object
Map of market pubkey - market name.
SubscriptionAck
object
2 properties 2 required
FillEventUpdate
object
6 properties 6 required
FillEvent
object
12 properties 12 required
HeadUpdate
object
9 properties 9 required
PriceLevel
array
[price, quantity] tuple. quantity 0 indicates a level removal.
Order
object
3 properties 3 required
OrderbookL2Checkpoint
object
5 properties 5 required
OrderbookL2Update
object
5 properties 5 required
OrderbookL3Checkpoint
object
5 properties 5 required
OrderbookL3Update
object
6 properties 6 required

Specification

The full machine-readable AsyncAPI contract behind this narrative.

Source

mango-markets-feeds-asyncapi.yml Raw ↑

Other APIs Mango Markets publishes across the network.

Mango v4 Orderbook Feed
AE Profile APIs.io
#WebSocket#Fills#Market Data#Perpetuals#Spot#Solana
← Back to M APIs
API Details
ID
mango-markets:fills-feed
Base URL
wss://fills.mngo.cloud
Docs
https://github.com/blockworks-foundation/mango-feeds/tree/lou/l3-feed/service-mango-fills
Provider
Mango Markets
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=fills-feed&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/fills-feed"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Mango v4 Fills Feed, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.