{"openapi":"3.1.0","info":{"title":"NOWPayments (BYOK) API","version":"0.1.0","description":"NOWPayments (BYOK) lets an AI assistant read your own NOWPayments data through the NOWPayments API with a key you supply (NOWPayments API key). Read-only: 8 tools (get_api_status, list_currencies, list_full_currencies, list_merchant_coins, get_min_amount, get_estimated_price, list_subscription_plans, get_subscription_plan). The BYOK key travels with each request, is used for that one call only...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-nowpayments.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-nowpayments/docs"},"termsOfService":"https://connectorbay.com/byok-nowpayments/terms"},"servers":[{"url":"https://byok-nowpayments.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-nowpayments/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_api_status":{"post":{"operationId":"get_api_status","summary":"Check whether the NOWPayments API is up: returns the message OK when it is working. Use for \"Is the NOWPayments API up\".","description":"Check whether the NOWPayments API is up: returns the message OK when it is working. Use for \"Is the NOWPayments API up\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_api_statusArguments","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/list_currencies":{"post":{"operationId":"list_currencies","summary":"List the crypto currency codes available for payments on this account setup, optionally only those that support fixed-ra","description":"List the crypto currency codes available for payments on this account setup, optionally only those that support fixed-rate payments. Use for \"Which coins can I accept through NOWPayments\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"fixed_rate":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to list only currencies that support fixed-rate payments.","title":"Fixed Rate"}},"title":"list_currenciesArguments","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/list_full_currencies":{"post":{"operationId":"list_full_currencies","summary":"List every supported crypto currency with code, name, network, whether it is enabled, address format check and whether a","description":"List every supported crypto currency with code, name, network, whether it is enabled, address format check and whether a memo or extra id is needed. Use for \"Show details of all coins and networks NOWPayments supports\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_full_currenciesArguments","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/list_merchant_coins":{"post":{"operationId":"list_merchant_coins","summary":"List the currencies the merchant switched on in the store's coin settings (a subset of what exists). Use for \"Which coin","description":"List the currencies the merchant switched on in the store's coin settings (a subset of what exists). Use for \"Which coins did I enable in my NOWPayments store settings\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_merchant_coinsArguments","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_min_amount":{"post":{"operationId":"get_min_amount","summary":"Get the smallest payment amount accepted for a currency pair, optionally with its fiat equivalent and fixed-rate or fee-","description":"Get the smallest payment amount accepted for a currency pair, optionally with its fiat equivalent and fixed-rate or fee-paid-by-user variants. Use for \"What is the minimum ETH to TRX payment on NOWPayments\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"currency_from":{"description":"Currency the customer pays in, lowercase code such as 'eth'.","maxLength":20,"title":"Currency From","type":"string"},"currency_to":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Currency you receive, lowercase code such as 'trx'.","title":"Currency To"},"fiat_equivalent":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Fiat code (for example 'usd') to also return the minimum as fiat.","title":"Fiat Equivalent"},"is_fixed_rate":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to compute the minimum for a fixed-rate payment.","title":"Is Fixed Rate"},"is_fee_paid_by_user":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to compute the minimum when the customer pays the fee.","title":"Is Fee Paid By User"}},"required":["currency_from"],"title":"get_min_amountArguments","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_estimated_price":{"post":{"operationId":"get_estimated_price","summary":"Estimate how much crypto a fiat amount is worth right now (before fees). Indicative only; the final amount can differ. U","description":"Estimate how much crypto a fiat amount is worth right now (before fees). Indicative only; the final amount can differ. Use for \"How much BTC is 3999.50 USD on NOWPayments\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"amount":{"description":"Amount in the source currency, for example 3999.5.","title":"Amount","type":"number"},"currency_from":{"description":"Source currency code, for example 'usd'.","maxLength":20,"title":"Currency From","type":"string"},"currency_to":{"description":"Target crypto code, for example 'btc'.","maxLength":20,"title":"Currency To","type":"string"}},"required":["amount","currency_from","currency_to"],"title":"get_estimated_priceArguments","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/list_subscription_plans":{"post":{"operationId":"list_subscription_plans","summary":"List the recurring-payment plans you created with title, billing interval in days, amount and currency. Paged. Use for \"","description":"List the recurring-payment plans you created with title, billing interval in days, amount and currency. Paged. Use for \"Which subscription plans do I have in NOWPayments\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many plans to return (1 to 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many plans to skip.","title":"Offset"}},"title":"list_subscription_plansArguments","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_subscription_plan":{"post":{"operationId":"get_subscription_plan","summary":"Get one recurring-payment plan by id: title, billing interval in days, amount, currency and dates. Use for \"Show NOWPaym","description":"Get one recurring-payment plan by id: title, billing interval in days, amount, currency and dates. Use for \"Show NOWPayments subscription plan 76215585\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"plan_id":{"description":"Subscription plan id, for example '76215585'.","maxLength":200,"title":"Plan Id","type":"string"}},"required":["plan_id"],"title":"get_subscription_planArguments","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}}}}