{"openapi":"3.1.0","info":{"title":"Kiln (BYOK) API","version":"0.1.0","description":"Kiln (BYOK) lets an AI assistant read your own Kiln data through the Kiln API with a key you supply (Kiln API token). Read-only: 12 tools (get_eth_network_stats, get_eth_kiln_stats, get_sol_network_stats, get_ada_network_stats, get_atom_network_stats, get_tia_network_stats, get_near_network_stats, get_sui_network_stats, get_ton_network_stats, get_trx_network_stats, get_xtz_network_stats,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-kiln.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-kiln/docs"},"termsOfService":"https://connectorbay.com/byok-kiln/terms"},"servers":[{"url":"https://byok-kiln.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-kiln/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_eth_network_stats":{"post":{"operationId":"get_eth_network_stats","summary":"Get Ethereum staking network statistics from Kiln: gross APY, staked share, validator count, ETH price, entry, exit and ","description":"Get Ethereum staking network statistics from Kiln: gross APY, staked share, validator count, ETH price, entry, exit and withdrawal time estimates and request fees. Use for \"What is the Ethereum staking APY and how long is the validator entry queue\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_eth_network_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_eth_kiln_stats":{"post":{"operationId":"get_eth_kiln_stats","summary":"Get the gross APY of Kiln's own Ethereum staking over the last day, week and month. Use for \"What gross APY has Kiln's E","description":"Get the gross APY of Kiln's own Ethereum staking over the last day, week and month. Use for \"What gross APY has Kiln's Ethereum staking earned over 30 days\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_eth_kiln_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_sol_network_stats":{"post":{"operationId":"get_sol_network_stats","summary":"Get current Solana staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, vali","description":"Get current Solana staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, validator count and the token price in USD. Use for \"What is the current Solana staking APY and how much of the supply is staked\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_sol_network_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_ada_network_stats":{"post":{"operationId":"get_ada_network_stats","summary":"Get current Cardano staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, val","description":"Get current Cardano staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, validator count and the token price in USD. Use for \"What is the current Cardano staking APY and how much of the supply is staked\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_ada_network_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_atom_network_stats":{"post":{"operationId":"get_atom_network_stats","summary":"Get current Cosmos Hub staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, ","description":"Get current Cosmos Hub staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, validator count and the token price in USD. Use for \"What is the current Cosmos Hub staking APY and how much of the supply is staked\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_atom_network_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_tia_network_stats":{"post":{"operationId":"get_tia_network_stats","summary":"Get current Celestia staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, va","description":"Get current Celestia staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, validator count and the token price in USD. Use for \"What is the current Celestia staking APY and how much of the supply is staked\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_tia_network_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_near_network_stats":{"post":{"operationId":"get_near_network_stats","summary":"Get current NEAR staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, valida","description":"Get current NEAR staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, validator count and the token price in USD. Use for \"What is the current NEAR staking APY and how much of the supply is staked\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_near_network_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_sui_network_stats":{"post":{"operationId":"get_sui_network_stats","summary":"Get current Sui staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, validat","description":"Get current Sui staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, validator count and the token price in USD. Use for \"What is the current Sui staking APY and how much of the supply is staked\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_sui_network_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_ton_network_stats":{"post":{"operationId":"get_ton_network_stats","summary":"Get current TON staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, validat","description":"Get current TON staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, validator count and the token price in USD. Use for \"What is the current TON staking APY and how much of the supply is staked\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_ton_network_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_trx_network_stats":{"post":{"operationId":"get_trx_network_stats","summary":"Get current TRON staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, valida","description":"Get current TRON staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, validator count and the token price in USD. Use for \"What is the current TRON staking APY and how much of the supply is staked\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_trx_network_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_xtz_network_stats":{"post":{"operationId":"get_xtz_network_stats","summary":"Get current Tezos staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, valid","description":"Get current Tezos staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, validator count and the token price in USD. Use for \"What is the current Tezos staking APY and how much of the supply is staked\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_xtz_network_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_pol_network_stats":{"post":{"operationId":"get_pol_network_stats","summary":"Get current Polygon (POL) staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rat","description":"Get current Polygon (POL) staking network statistics from Kiln: gross staking APY, share of supply staked, inflation rate, validator count and the token price in USD. Use for \"What is the current Polygon (POL) staking APY and how much of the supply is staked\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_pol_network_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}