Mango Markets

aid: mango-markets
url: https://raw.githubusercontent.com/api-evangelist/mango-markets/refs/heads/main/apis.yml
name: Mango Markets
kind: company
description: >-
  Mango Markets is a decentralized derivatives exchange and money market
  built on Solana, operated by the Blockworks Foundation. Mango v4 introduces
  unified margin accounts that combine spot trading, perpetual futures, and
  borrow/lend in a single risk engine, settled by the on-chain Mango v4
  program. Beyond the on-chain program and the TypeScript client, the project
  exposes low-latency public market-data feeds through the mango-feeds geyser
  services - the Fills Feed (service-mango-fills, fills.mngo.cloud) and the
  Orderbook Feed (service-mango-orderbook, orderbook.mngo.cloud) - which
  stream fill events and L2/L3 orderbook state for Mango V4 Perp markets and
  Openbook spot markets over WebSocket.
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
tags:
  - Cryptocurrency
  - DeFi
  - Decentralized Exchange
  - Perpetual Futures
  - Spot
  - Margin
  - Orderbook
  - Fills
  - Market Data
  - WebSocket
  - Solana
  - Mango v4
created: '2026-05-30'
modified: '2026-05-30'
specificationVersion: '0.20'
x-category: Cryptocurrency
x-tier: 1
x-type: company
apis:
  - aid: mango-markets:fills-feed
    name: Mango v4 Fills Feed
    description: >-
      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.
    humanURL: https://github.com/blockworks-foundation/mango-feeds/tree/lou/l3-feed/service-mango-fills
    baseURL: wss://fills.mngo.cloud
    tags:
      - WebSocket
      - Fills
      - Market Data
      - Perpetuals
      - Spot
      - Solana
    properties:
      - type: Documentation
        url: https://github.com/blockworks-foundation/mango-feeds/blob/lou/l3-feed/service-mango-fills/README.md
      - type: AsyncAPI
        url: asyncapi/mango-markets-feeds-asyncapi.yml
      - type: SourceCode
        title: service-mango-fills (Rust)
        url: https://github.com/blockworks-foundation/mango-feeds/tree/lou/l3-feed/service-mango-fills
      - type: SDK
        title: '@blockworks-foundation/mango-feeds-client (TypeScript)'
        url: https://github.com/blockworks-foundation/mango-feeds/tree/main/ts/client
      - type: PublicAPI
        title: Public Fills API entrypoint
        url: https://api.mngo.cloud/fills/v1/
  - aid: mango-markets:orderbook-feed
    name: Mango v4 Orderbook Feed
    description: >-
      Low-latency WebSocket feed (service-mango-orderbook) that parses
      Mango V4 Perp and Openbook spot bookside accounts and emits L2 (price /
      quantity) and L3 (per-order) checkpoints and per-side delta updates.
      Clients subscribe with subscriptionType=level for L2 or
      subscriptionType=book for L3; the server returns an initial checkpoint
      followed by streaming per-side updates with slot and writeVersion for
      ordering.
    humanURL: https://github.com/blockworks-foundation/mango-feeds/tree/lou/l3-feed/service-mango-orderbook
    baseURL: wss://orderbook.mngo.cloud
    tags:
      - WebSocket
      - Orderbook
      - L2
      - L3
      - Market Data
      - Perpetuals
      - Spot
      - Solana
    properties:
      - type: Documentation
        url: https://github.com/blockworks-foundation/mango-feeds/blob/lou/l3-feed/service-mango-orderbook/README.md
      - type: AsyncAPI
        url: asyncapi/mango-markets-feeds-asyncapi.yml
      - type: SourceCode
        title: service-mango-orderbook (Rust)
        url: https://github.com/blockworks-foundation/mango-feeds/tree/lou/l3-feed/service-mango-orderbook
      - type: SDK
        title: '@blockworks-foundation/mango-feeds-client (TypeScript)'
        url: https://github.com/blockworks-foundation/mango-feeds/tree/main/ts/client
      - type: PublicAPI
        title: Public Orderbook API entrypoint
        url: https://api.mngo.cloud/orderbook/v1/
common:
  - type: Website
    url: https://mango.markets
  - type: Documentation
    url: https://docs.mango.markets
  - type: GitHubOrganization
    url: https://github.com/blockworks-foundation
  - type: SourceCode
    title: mango-feeds
    url: https://github.com/blockworks-foundation/mango-feeds
maintainers:
  - FN: Kin Lane
    email: [email protected]