{"openapi":"3.1.0","info":{"title":"Flare Builders API","summary":"Public read-only HTTP APIs for the Flare Builders directory and analytics.","description":"Flare Builders exposes unauthenticated JSON feeds for the Flare and Songbird project directory, market ticker, TVL, rich-list lookup, FTSO epoch, and reliability scores. There is no API key, OAuth, or webhook layer today.","version":"1.0.0","contact":{"name":"Flare Builders","email":"hello@flare.builders","url":"https://flare.builders/contact"}},"servers":[{"url":"https://flare.builders","description":"Production"}],"paths":{"/listings.json":{"get":{"operationId":"listProjects","summary":"Flare Builders directory listings","tags":["Flare Builders directory"],"responses":{"200":{"description":"Array of public listing records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingsResponse"}}}}}}},"/api/ticker":{"get":{"operationId":"getTicker","summary":"FLR and SGB USD ticker","tags":["Flare Builders market data"],"responses":{"200":{"description":"CoinGecko market payloads for Flare and Songbird"}}}},"/api/tvl":{"get":{"operationId":"getTvl","summary":"Flare DeFi TVL, stablecoins, and FAssets","tags":["Flare Builders market data"],"responses":{"200":{"description":"Aggregated DefiLlama TVL payload"}}}},"/api/richlist/lookup":{"get":{"operationId":"lookupRichlist","summary":"Look up an address on the FLR or SGB rich list","tags":["Flare Builders analytics"],"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"}},{"name":"network","in":"query","required":true,"schema":{"type":"string","enum":["flare","songbird"]}}],"responses":{"200":{"description":"Rank and balance for the address"}}}},"/api/ftso/current-epoch":{"get":{"operationId":"getCurrentFtsoEpoch","summary":"Current FTSO reward epoch id","tags":["Flare Builders analytics"],"parameters":[{"name":"network","in":"query","required":false,"schema":{"type":"string","enum":["flare","songbird"]}}],"responses":{"200":{"description":"Current rewardEpochId"}}}},"/api/reliability-scores":{"get":{"operationId":"getReliabilityScores","summary":"FTSO and validator reliability scores","tags":["Flare Builders analytics"],"responses":{"200":{"description":"Map of entity reliability scores"}}}},"/llms.txt":{"get":{"operationId":"getLlmsTxt","summary":"Flare Builders llms.txt","tags":["Flare Builders agents"],"responses":{"200":{"description":"text/plain site summary for agents"}}}},"/.well-known/mcp":{"get":{"operationId":"getMcpDiscovery","summary":"MCP discovery handshake for Flare Builders","tags":["Flare Builders agents"],"responses":{"200":{"description":"MCP server metadata"}}}},"/mcp":{"post":{"operationId":"mcpJsonRpc","summary":"Flare Builders MCP Streamable HTTP endpoint","tags":["Flare Builders agents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"JSON-RPC result"}}}}},"components":{"schemas":{"ListingsResponse":{"type":"object","properties":{"name":{"type":"string","example":"Flare Builders"},"listings":{"type":"array","items":{"$ref":"#/components/schemas/Listing"}}}},"Listing":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"url":{"type":"string"},"networks":{"type":"array","items":{"type":"string"}},"href":{"type":"string"}}}}}}