{"openapi":"3.1.0","info":{"title":"Fishing Tackle API","version":"1.0.0","description":"Angling and tackle maths as an API, computed locally and deterministically — the three numbers that decide how a reel is spooled and a lure is fished. The line-capacity endpoint works out how much line of a different diameter a reel will hold: line lies on the spool by cross-sectional area, so capacity scales with the inverse square of diameter — a reel rated for 100 yards of 0.30 mm holds about 73.5 yards of thicker 0.35 mm, or nearly 140 yards of a thinner 0.011-inch braid. The sink-time endpoint gives the countdown to fish a lure at depth: time = depth ÷ sink rate, so a minnow that sinks a foot a second reaches ten feet on a count of ten. The drag endpoint sets the reel: about 25–33 % of the line's breaking strength measured at the rod tip — a 20-pound line wants roughly 5 to 6.6 pounds of drag, enough to let a fish run before anything snaps. Everything is computed locally and deterministically, so it is instant and private. Ideal for fishing and tackle apps, reel-spooling and gear-shop tools, angler trip-planners, and learning sites. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 compute endpoints. Unit-agnostic — keep your units consistent; rules of thumb, conditions vary.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/fishing-api","description":"oanor gateway"}],"tags":[{"name":"Fishing"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/drag":{"get":{"operationId":"get_v1_drag","tags":["Fishing"],"summary":"Drag setting from line strength","description":"","parameters":[{"name":"line_test","in":"query","required":true,"description":"Line breaking strength (lb or kg)","schema":{"type":"string"},"example":"20"},{"name":"percent","in":"query","required":false,"description":"Custom drag percent","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Set the drag to about 25–33 % of the line's breaking strength — measured at the reel with a scale, with line off the rod tip, not at the spool. That lets a fish run before anything snaps while still tiring it. Braid can take the higher end; a stretchy mono or a fragile knot, the lower. Back off the drag when a big fish is close to the boat.","inputs":{"line_test":20},"percent":30,"drag_max":6.6,"drag_min":5,"drag_at_percent":6},"meta":{"timestamp":"2026-06-06T15:30:42.228Z","request_id":"9d9a655a-10f1-4d07-9816-d06fd4dafd56"},"status":"ok","message":"Drag setting","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/line-capacity":{"get":{"operationId":"get_v1_line_capacity","tags":["Fishing"],"summary":"Reel capacity at a new line diameter","description":"","parameters":[{"name":"rated_capacity","in":"query","required":true,"description":"Rated capacity (yards or metres)","schema":{"type":"string"},"example":"100"},{"name":"rated_diameter","in":"query","required":true,"description":"Rated line diameter","schema":{"type":"string"},"example":"0.30"},{"name":"new_diameter","in":"query","required":true,"description":"New line diameter (same unit)","schema":{"type":"string"},"example":"0.35"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Line lies on the spool by cross-sectional area, so capacity scales with the inverse square of diameter: new capacity = rated × (rated diameter ÷ new diameter)². A thinner line packs more on, a thicker one less. Use the same unit for both diameters (mm or inches) and the capacity comes out in the rated unit (yards or metres).","inputs":{"new_diameter":0.35,"rated_capacity":100,"rated_diameter":0.3},"new_capacity":73.5,"capacity_ratio":0.735},"meta":{"timestamp":"2026-06-06T15:30:42.322Z","request_id":"f9ff79fd-516a-4614-9f7b-ea6612150a1d"},"status":"ok","message":"Line capacity","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/sink-time":{"get":{"operationId":"get_v1_sink_time","tags":["Fishing"],"summary":"Lure countdown to a depth","description":"","parameters":[{"name":"depth","in":"query","required":true,"description":"Target depth","schema":{"type":"string"},"example":"30"},{"name":"sink_rate","in":"query","required":true,"description":"Sink rate (depth units per second)","schema":{"type":"string"},"example":"1.5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Countdown time = depth ÷ sink rate. Cast, let the lure sink while you count, then retrieve at that depth — a typical countdown minnow sinks about a foot a second, so a 'count of ten' fishes around ten feet. Sink rate drops with line drag, current and lighter line; calibrate by counting until you tick bottom at a known depth.","inputs":{"depth":30,"sink_rate":1.5},"sink_seconds":20},"meta":{"timestamp":"2026-06-06T15:30:42.422Z","request_id":"4b822322-0712-4064-9330-7747d34291e2"},"status":"ok","message":"Sink time","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"notes":"Capacity = rated × (rated dia ÷ new dia)²; countdown = depth ÷ sink rate; drag ≈ 25–33 % of line test. Unit-agnostic — keep your units consistent. Rules of thumb; conditions vary.","service":"fishing-api","endpoints":{"GET /v1/drag":"Recommended drag setting (25–33 %) for a line's breaking strength.","GET /v1/meta":"This document.","GET /v1/sink-time":"Countdown time for a lure to reach a depth at its sink rate.","GET /v1/line-capacity":"New spool capacity when you change line diameter (inverse-square)."},"description":"Angling / tackle maths: reel line capacity when the line diameter changes, lure sink time to a depth, and the drag setting for a line's breaking strength."},"meta":{"timestamp":"2026-06-06T15:30:42.513Z","request_id":"455aed27-a6e8-409b-8591-7c96d7009457"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":4500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":375,"monthly_call_quota":70000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1210,"monthly_call_quota":300000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3680,"monthly_call_quota":1400000,"rps_limit":48,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/fishing-api"}