{
  "openapi": "3.1.0",
  "info": {
    "title": "MoneyTools Agent Guide data",
    "version": "2026-11-03",
    "description": "Read-only JSON files. Contains referral links: MoneyTools earns a commission when you sign up or pay through them. Not investment, financial or legal advice. Region restrictions apply (e.g. United States) - follow each venue's terms and your local law. Fee data is copied from official docs on the stated date; unknowns are null, never estimated; order is by objective fee."
  },
  "servers": [
    {
      "url": "https://moneytools.dev"
    }
  ],
  "paths": {
    "/fees.json": {
      "get": {
        "operationId": "getFees",
        "summary": "Perp DEX fee comparison (contains referral links)",
        "description": "Venues sorted by entry-tier taker then maker fee; unconfirmed last. ourReferral.link is a tracked redirect (/go/<id>) to ourReferral.destination when MoneyTools holds an active referral link; MoneyTools earns a commission on fees paid through it. Not investment advice; region restrictions per venue.",
        "responses": {
          "200": {
            "description": "Fee dataset",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "checked": {
                      "type": "string",
                      "format": "date"
                    },
                    "disclosure": {
                      "type": "string"
                    },
                    "sortRule": {
                      "type": "string"
                    },
                    "sortedOrder": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "venues": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "rank": {
                            "type": "integer"
                          },
                          "id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "entryTier": {
                            "type": "string"
                          },
                          "takerPct": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "makerPct": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "feeSource": {
                            "type": "string",
                            "format": "uri"
                          },
                          "feeNotes": {
                            "type": "string"
                          },
                          "refereeBenefit": {
                            "type": "string"
                          },
                          "referrerReward": {
                            "type": "string"
                          },
                          "referralSource": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "ourReferral": {
                            "type": "object",
                            "properties": {
                              "status": {
                                "type": "string"
                              },
                              "link": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "destination": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "code": {
                                "type": "string"
                              },
                              "note": {
                                "type": "string"
                              }
                            }
                          },
                          "restrictions": {
                            "type": "string"
                          },
                          "restrictionsSource": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/health": {
      "get": {
        "operationId": "health",
        "summary": "Liveness",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "ok": true,
                  "service": "agent-guide"
                }
              }
            }
          }
        }
      }
    },
    "/index.json": {
      "get": {
        "operationId": "getIndex",
        "summary": "MoneyTools x402 services, referral program and affiliate list (contains referral links)",
        "responses": {
          "200": {
            "description": "Directory JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/go/{id}": {
      "get": {
        "operationId": "followReferral",
        "summary": "302 redirect to a referral link (counts clicks; stores no personal data)",
        "description": "Contains referral link; MoneyTools earns a commission. Only aggregate daily counts are stored (link id, coarse client category, status, source tag from ?src= / ?utm_source= / ?ref=); no IP or raw user agent.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "lighter"
              ]
            }
          }
        ],
        "responses": {
          "302": {
            "description": "Redirect to the venue"
          },
          "404": {
            "description": "Unknown id"
          }
        }
      }
    }
  }
}