{"uid":"cap_UXWw6285VAmW90O4ZongE","slug":"mangrove-signal-match-5f2a3d8a","name":"Mangrove Signal Match","description":"Developer references for Mangrove Agent, API contracts, MCP and AI integrations.","url":"https://api.mangrovedeveloper.ai/api/v1/signals/match?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"role":{"enum":["TRIGGER","FILTER"],"type":"string","example":"TRIGGER","description":"Signal role"},"top_k":{"type":"integer","default":5,"description":"Number of matches to return"},"description":{"type":"string","description":"Natural language description of the desired signal/rule"},"user_intent":{"type":"object","description":"Optional intent dict (e.g., from intent extractor)"},"regime_direction":{"type":"string","description":"Market regime band"},"similarity_threshold":{"type":"number","default":0.3,"description":"Minimum similarity score to include"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bC5m-1Hi5n06bj7MhJPmG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds the top-k matching trading signals or rules from a library based on a natural language description, optional intent context, and market regime direction.","exampleAgentPrompt":"Find me the top 5 TRIGGER signals in Mangrove that most closely match a momentum breakout strategy in a bullish market regime, using a similarity threshold of 0.4.","exampleUseCases":[{"title":"Momentum entry signal discovery","prompt":"Search Mangrove's signal library for the top 3 TRIGGER signals that best match 'buy when price breaks above 20-day high with strong volume' in a bullish regime, with a minimum similarity of 0.5."},{"title":"Risk filter signal for bearish markets","prompt":"Find me the top 5 FILTER signals that match 'reduce position size when volatility spikes and trend is down' in a bearish market regime — I want to wire them into my risk management agent."},{"title":"Intent-driven signal routing for agent","prompt":"I have an extracted user intent for a mean reversion strategy — can you match it against Mangrove's signal library as a TRIGGER with top_k set to 7 and similarity threshold of 0.35, so my agent knows which signals to activate?"}],"resultDescription":"Returns a ranked list of up to top_k matching signals (TRIGGER or FILTER type), each with a similarity score and signal metadata, filtered to those exceeding the similarity_threshold. Useful for routing agent decisions to the most relevant pre-defined trading signals or rules.","failureModes":["No matches found if similarity_threshold is set too high relative to available signals","Invalid role enum value (must be TRIGGER or FILTER) causes validation error","Empty or vague description may return low-quality or zero matches","Malformed user_intent object may be ignored or cause a 400 error","top_k exceeding available signals returns fewer results without error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to map a natural language trading strategy or rule description to a pre-existing library of signals, particularly when the agent must dynamically select which Mangrove triggers or filters to activate based on user intent or market regime. Prefer this over manual signal selection when the signal space is large and fuzzy matching is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:36:14.480Z","isFirstParty":false,"canonicalSlug":"mangrove-signal-match-5f2a3d8a"}