cURL
curl --fail-with-body -sS 'https://api-testnet.lumeus.dev/v1/plans'// Node 18+ (ES module)
const res = await fetch('https://api-testnet.lumeus.dev/v1/plans', {
method: 'GET',
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));import json
import requests
res = requests.get(
"https://api-testnet.lumeus.dev/v1/plans",
timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2)){
"catalog_state": "legacy_reference",
"credit_formula": "credits = max(base_weight × ceil(rows / 100), ceil(response_bytes / 64 KiB)), minimum 1 block",
"credit_weights": {
"account": 1,
"activity": 10,
"asset": 5,
"assets-account": 1,
"assets-history": 5,
"assets-holder": 2,
"assets-holders": 5,
"assets-holdings": 1,
"assets-registry": 1,
"assets-snapshot": 50,
"contract": 5,
"rpc": 1,
"transaction": 1,
"tx-activity": 1,
"webhooks": 1
},
"funded_purchases_enabled": false,
"plans": [
{
"name": "free",
"monthly_fee_cents": 0,
"included_credits": 250000,
"rate_per_minute": 60,
"max_page_size": 200,
"account_max_page_size": 1000,
"deep_history": true,
"hard_cap": true,
"overage_per_1k_cents": 0,
"subscribable": false,
"custom": false,
"rpc_enabled": true,
"rpc_rate_per_minute": 30,
"rpc_method_credits": {
"getEvents": 2,
"getFeeStats": 1,
"getHealth": 1,
"getLatestLedger": 1,
"getLedgerEntries": 2,
"getLedgers": 2,
"getNetwork": 1,
"getTransaction": 1,
"getTransactions": 2,
"getVersionInfo": 1,
"sendTransaction": 2,
"simulateTransaction": 5
},
"rpc_response_bytes_per_credit": 65536,
"max_webhook_endpoints": 1,
"free_testnet_webhooks": 1,
"free_testnet_daily_deliveries": 1000,
"testnet_free": true,
"testnet_daily_requests": 10000
},
{
"name": "starter",
"monthly_fee_cents": 2900,
"included_credits": 3000000,
"rate_per_minute": 600,
"max_page_size": 200,
"account_max_page_size": 1000,
"deep_history": true,
"hard_cap": false,
"overage_per_1k_cents": 1,
"subscribable": false,
"custom": false,
"rpc_enabled": true,
"rpc_rate_per_minute": 300,
"rpc_method_credits": {
"getEvents": 2,
"getFeeStats": 1,
"getHealth": 1,
"getLatestLedger": 1,
"getLedgerEntries": 2,
"getLedgers": 2,
"getNetwork": 1,
"getTransaction": 1,
"getTransactions": 2,
"getVersionInfo": 1,
"sendTransaction": 2,
"simulateTransaction": 5
},
"rpc_response_bytes_per_credit": 65536,
"max_webhook_endpoints": 10,
"free_testnet_webhooks": 0,
"free_testnet_daily_deliveries": 0,
"testnet_free": true,
"testnet_daily_requests": 10000
},
{
"name": "growth",
"monthly_fee_cents": 9900,
"included_credits": 12000000,
"rate_per_minute": 3000,
"max_page_size": 200,
"account_max_page_size": 1000,
"deep_history": true,
"hard_cap": false,
"overage_per_1k_cents": 1,
"subscribable": false,
"custom": false,
"rpc_enabled": true,
"rpc_rate_per_minute": 600,
"rpc_method_credits": {
"getEvents": 2,
"getFeeStats": 1,
"getHealth": 1,
"getLatestLedger": 1,
"getLedgerEntries": 2,
"getLedgers": 2,
"getNetwork": 1,
"getTransaction": 1,
"getTransactions": 2,
"getVersionInfo": 1,
"sendTransaction": 2,
"simulateTransaction": 5
},
"rpc_response_bytes_per_credit": 65536,
"max_webhook_endpoints": 50,
"free_testnet_webhooks": 0,
"free_testnet_daily_deliveries": 0,
"testnet_free": true,
"testnet_daily_requests": 10000
},
{
"name": "scale",
"monthly_fee_cents": 49900,
"included_credits": 64000000,
"rate_per_minute": 6000,
"max_page_size": 200,
"account_max_page_size": 1000,
"deep_history": true,
"hard_cap": false,
"overage_per_1k_cents": 1,
"subscribable": false,
"custom": false,
"rpc_enabled": true,
"rpc_rate_per_minute": 1200,
"rpc_method_credits": {
"getEvents": 2,
"getFeeStats": 1,
"getHealth": 1,
"getLatestLedger": 1,
"getLedgerEntries": 2,
"getLedgers": 2,
"getNetwork": 1,
"getTransaction": 1,
"getTransactions": 2,
"getVersionInfo": 1,
"sendTransaction": 2,
"simulateTransaction": 5
},
"rpc_response_bytes_per_credit": 65536,
"max_webhook_endpoints": 250,
"free_testnet_webhooks": 0,
"free_testnet_daily_deliveries": 0,
"testnet_free": true,
"testnet_daily_requests": 10000
},
{
"name": "enterprise",
"monthly_fee_cents": 0,
"included_credits": 0,
"rate_per_minute": 30000,
"max_page_size": 200,
"account_max_page_size": 1000,
"deep_history": true,
"hard_cap": false,
"overage_per_1k_cents": 0,
"subscribable": false,
"custom": true,
"rpc_enabled": true,
"rpc_rate_per_minute": 10000,
"rpc_method_credits": {
"getEvents": 2,
"getFeeStats": 1,
"getHealth": 1,
"getLatestLedger": 1,
"getLedgerEntries": 2,
"getLedgers": 2,
"getNetwork": 1,
"getTransaction": 1,
"getTransactions": 2,
"getVersionInfo": 1,
"sendTransaction": 2,
"simulateTransaction": 5
},
"rpc_response_bytes_per_credit": 65536,
"max_webhook_endpoints": 0,
"free_testnet_webhooks": 0,
"free_testnet_daily_deliveries": 0,
"testnet_free": true,
"testnet_daily_requests": null
}
]
}{
"code": "method_not_allowed",
"error": "method POST is not allowed on /v1/plans; allowed: GET, HEAD",
"request_id": "req_6f1c2a9b0e4d4c7a8b3f5e21"
}{
"code": "rate_limited",
"error": "rate limit exceeded",
"request_id": "req_6f1c2a9b0e4d4c7a8b3f5e21"
}Get the plan catalog
Returns the current public plan catalog: prices, included (Mainnet) credits, the daily free Testnet request cap, rate limits, page sizes, RPC method credits, webhook endpoint caps and the credit weight of every route class. No authentication. catalog_state is self_serve when plans with subscribable true can be bought through POST /billing/checkout on this host, else legacy_reference (prices for reference only). Mainnet and Testnet report their own state.
GET
/
v1
/
plans
cURL
curl --fail-with-body -sS 'https://api-testnet.lumeus.dev/v1/plans'// Node 18+ (ES module)
const res = await fetch('https://api-testnet.lumeus.dev/v1/plans', {
method: 'GET',
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));import json
import requests
res = requests.get(
"https://api-testnet.lumeus.dev/v1/plans",
timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2)){
"catalog_state": "legacy_reference",
"credit_formula": "credits = max(base_weight × ceil(rows / 100), ceil(response_bytes / 64 KiB)), minimum 1 block",
"credit_weights": {
"account": 1,
"activity": 10,
"asset": 5,
"assets-account": 1,
"assets-history": 5,
"assets-holder": 2,
"assets-holders": 5,
"assets-holdings": 1,
"assets-registry": 1,
"assets-snapshot": 50,
"contract": 5,
"rpc": 1,
"transaction": 1,
"tx-activity": 1,
"webhooks": 1
},
"funded_purchases_enabled": false,
"plans": [
{
"name": "free",
"monthly_fee_cents": 0,
"included_credits": 250000,
"rate_per_minute": 60,
"max_page_size": 200,
"account_max_page_size": 1000,
"deep_history": true,
"hard_cap": true,
"overage_per_1k_cents": 0,
"subscribable": false,
"custom": false,
"rpc_enabled": true,
"rpc_rate_per_minute": 30,
"rpc_method_credits": {
"getEvents": 2,
"getFeeStats": 1,
"getHealth": 1,
"getLatestLedger": 1,
"getLedgerEntries": 2,
"getLedgers": 2,
"getNetwork": 1,
"getTransaction": 1,
"getTransactions": 2,
"getVersionInfo": 1,
"sendTransaction": 2,
"simulateTransaction": 5
},
"rpc_response_bytes_per_credit": 65536,
"max_webhook_endpoints": 1,
"free_testnet_webhooks": 1,
"free_testnet_daily_deliveries": 1000,
"testnet_free": true,
"testnet_daily_requests": 10000
},
{
"name": "starter",
"monthly_fee_cents": 2900,
"included_credits": 3000000,
"rate_per_minute": 600,
"max_page_size": 200,
"account_max_page_size": 1000,
"deep_history": true,
"hard_cap": false,
"overage_per_1k_cents": 1,
"subscribable": false,
"custom": false,
"rpc_enabled": true,
"rpc_rate_per_minute": 300,
"rpc_method_credits": {
"getEvents": 2,
"getFeeStats": 1,
"getHealth": 1,
"getLatestLedger": 1,
"getLedgerEntries": 2,
"getLedgers": 2,
"getNetwork": 1,
"getTransaction": 1,
"getTransactions": 2,
"getVersionInfo": 1,
"sendTransaction": 2,
"simulateTransaction": 5
},
"rpc_response_bytes_per_credit": 65536,
"max_webhook_endpoints": 10,
"free_testnet_webhooks": 0,
"free_testnet_daily_deliveries": 0,
"testnet_free": true,
"testnet_daily_requests": 10000
},
{
"name": "growth",
"monthly_fee_cents": 9900,
"included_credits": 12000000,
"rate_per_minute": 3000,
"max_page_size": 200,
"account_max_page_size": 1000,
"deep_history": true,
"hard_cap": false,
"overage_per_1k_cents": 1,
"subscribable": false,
"custom": false,
"rpc_enabled": true,
"rpc_rate_per_minute": 600,
"rpc_method_credits": {
"getEvents": 2,
"getFeeStats": 1,
"getHealth": 1,
"getLatestLedger": 1,
"getLedgerEntries": 2,
"getLedgers": 2,
"getNetwork": 1,
"getTransaction": 1,
"getTransactions": 2,
"getVersionInfo": 1,
"sendTransaction": 2,
"simulateTransaction": 5
},
"rpc_response_bytes_per_credit": 65536,
"max_webhook_endpoints": 50,
"free_testnet_webhooks": 0,
"free_testnet_daily_deliveries": 0,
"testnet_free": true,
"testnet_daily_requests": 10000
},
{
"name": "scale",
"monthly_fee_cents": 49900,
"included_credits": 64000000,
"rate_per_minute": 6000,
"max_page_size": 200,
"account_max_page_size": 1000,
"deep_history": true,
"hard_cap": false,
"overage_per_1k_cents": 1,
"subscribable": false,
"custom": false,
"rpc_enabled": true,
"rpc_rate_per_minute": 1200,
"rpc_method_credits": {
"getEvents": 2,
"getFeeStats": 1,
"getHealth": 1,
"getLatestLedger": 1,
"getLedgerEntries": 2,
"getLedgers": 2,
"getNetwork": 1,
"getTransaction": 1,
"getTransactions": 2,
"getVersionInfo": 1,
"sendTransaction": 2,
"simulateTransaction": 5
},
"rpc_response_bytes_per_credit": 65536,
"max_webhook_endpoints": 250,
"free_testnet_webhooks": 0,
"free_testnet_daily_deliveries": 0,
"testnet_free": true,
"testnet_daily_requests": 10000
},
{
"name": "enterprise",
"monthly_fee_cents": 0,
"included_credits": 0,
"rate_per_minute": 30000,
"max_page_size": 200,
"account_max_page_size": 1000,
"deep_history": true,
"hard_cap": false,
"overage_per_1k_cents": 0,
"subscribable": false,
"custom": true,
"rpc_enabled": true,
"rpc_rate_per_minute": 10000,
"rpc_method_credits": {
"getEvents": 2,
"getFeeStats": 1,
"getHealth": 1,
"getLatestLedger": 1,
"getLedgerEntries": 2,
"getLedgers": 2,
"getNetwork": 1,
"getTransaction": 1,
"getTransactions": 2,
"getVersionInfo": 1,
"sendTransaction": 2,
"simulateTransaction": 5
},
"rpc_response_bytes_per_credit": 65536,
"max_webhook_endpoints": 0,
"free_testnet_webhooks": 0,
"free_testnet_daily_deliveries": 0,
"testnet_free": true,
"testnet_daily_requests": null
}
]
}{
"code": "method_not_allowed",
"error": "method POST is not allowed on /v1/plans; allowed: GET, HEAD",
"request_id": "req_6f1c2a9b0e4d4c7a8b3f5e21"
}{
"code": "rate_limited",
"error": "rate limit exceeded",
"request_id": "req_6f1c2a9b0e4d4c7a8b3f5e21"
}Response
Plans, prices, limits and credit weights.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
self_serve: at least one plan can be bought through POST /billing/checkout on this host. legacy_reference: no self-serve checkout on this host; prices are for reference.
Available options:
self_serve, legacy_reference Prepaid offers through POST /billing/purchases are open on this host.