API ReferenceBeta

CoinsFlow API

REST API for querying Litecoin blockchain data. Returns JSON. No SDK required.

RESTJSONAPI Key AuthLitecoinPaymentsFree

For AI Agents & LLM Integrations

Base URL: https://api.coinsflow.net

Auth: Header X-API-Key: cf_live_... — get a key at https://coinsflow.net/apis/dashboard

Rate limits: Unlimited (beta). Returns 429 if exceeded.

Endpoints: GET /v1/address/ltc/{address} · GET /v1/tx/ltc/{txid} · GET /v1/block/ltc/{hash} · GET /v1/blocks/ltc · GET /v1/price/ltc · POST /invoices/create · GET /balance · POST /payout

Machine-readable spec: /openapi.json (OpenAPI 3.1) · /llms.txt

Getting Started

The CoinsFlow API gives you programmatic access to Litecoin blockchain data including addresses, transactions, blocks, and live price. All responses are JSON.

1Create a free account and generate your API key from the dashboard.
2Include your key in the X-API-Key request header.
3Make a request to any endpoint. All responses are JSON with consistent error shapes.

curl https://api.coinsflow.net/v1/price/ltc \
  -H "X-API-Key: cf_live_your_key_here"

Authentication

Every request must include your API key in the X-API-Key HTTP header. Keys begin with the prefix cf_live_.

bash

# Pass your key in the request header
curl https://api.coinsflow.net/v1/address/ltc/LXqvJaXc9xC8...   -H "X-API-Key: cf_live_a1b2c3d4e5f6..."

Security note: Never expose your API key in client-side code, public repositories, or frontend JavaScript. Always make API calls from a server or backend environment.

Base URL

All endpoints are served from:

text

https://api.coinsflow.net

All API responses include a Content-Type: application/json header.

Rate Limits

Beta access: Unlimited requests while the platform is in beta. Fair-use policy applies — avoid excessive automated scraping.

Plan	Requests / Day	Status
FreeBeta	Unlimited	Active

When a rate limit is exceeded, the API returns 429 Too Many Requests.

Error Codes

All errors return a JSON body with an error field describing what went wrong.

json

{
  "error": "Invalid or missing API key"
}

Status	Meaning
`200`	OK — request succeeded
`400`	Bad Request — invalid parameters
`401`	Unauthorized — missing or invalid API key
`404`	Not Found — resource does not exist on chain
`429`	Too Many Requests — rate limit exceeded
`500`	Internal Server Error — contact support

GET/v1/address/ltc/{address}

Address Lookup

Returns balance, transaction count, total received, and total sent for any Litecoin address.

Parameters

Name	Type	Description
`address`req	string	A valid Litecoin address (L/M/ltc1 format).
`page`	integer	Page number for transaction history. Default: 1.
`limit`	integer	Transactions per page (max 50). Default: 25.

Request

curl https://api.coinsflow.net/v1/address/ltc/LXqvJaXc9xC8UjFEDRTDjzD8bNHzMpBMQJ \
  -H "X-API-Key: cf_live_your_key_here"

Response

json

{
  "address": "LXqvJaXc9xC8UjFEDRTDjzD8bNHzMpBMQJ",
  "balance": 4.72819341,
  "total_received": 48.00000000,
  "total_sent": 43.27180659,
  "tx_count": 217,
  "chain": "litecoin",
  "transactions": [
    {
      "txid": "a3f9c12b...",
      "amount": 1.50000000,
      "confirmations": 4812,
      "timestamp": 1714003201
    }
  ]
}

GET/v1/tx/ltc/{txid}

Transaction Detail

Returns full transaction detail including inputs, outputs, fees, block height, and confirmation count.

Parameters

Name	Type	Description
`txid`req	string	The 64-character hexadecimal transaction ID.

Request

curl https://api.coinsflow.net/v1/tx/ltc/a3f9c12b4e7d8291f6e05b3a7d4c9182 \
  -H "X-API-Key: cf_live_your_key_here"

Response

json

{
  "txid": "a3f9c12b4e7d...",
  "block_height": 2831047,
  "confirmations": 4812,
  "fee": 0.00004200,
  "size": 226,
  "timestamp": 1714003201,
  "inputs": [
    { "address": "LXqvJaXc9x...", "value": 2.00000000 }
  ],
  "outputs": [
    { "address": "LRk7fBWt3q...", "value": 1.50000000 },
    { "address": "LXqvJaXc9x...", "value": 0.49995800 }
  ]
}

GET/v1/block/ltc/{hash}

Block Detail

Returns block header data, transaction IDs, miner coinbase, and difficulty for a given block hash or height.

Parameters

Name	Type	Description
`hash`req	string	Block hash (64-char hex) or block height (integer).

Request

curl https://api.coinsflow.net/v1/block/ltc/2831047 \
  -H "X-API-Key: cf_live_your_key_here"

Response

json

{
  "hash": "0000000000000...",
  "height": 2831047,
  "timestamp": 1714003201,
  "tx_count": 83,
  "size": 48291,
  "difficulty": 18273648.394,
  "miner": "LPool",
  "transactions": ["a3f9c12b...", "7b2d4f1a..."]
}

GET/v1/blocks/ltc

Latest Blocks

Returns the 10 most recently confirmed blocks on the Litecoin chain.

Request

curl https://api.coinsflow.net/v1/blocks/ltc \
  -H "X-API-Key: cf_live_your_key_here"

Response

json

{
  "blocks": [
    {
      "hash": "0000000000000...",
      "height": 2831047,
      "timestamp": 1714003201,
      "tx_count": 83,
      "size": 48291
    }
  ]
}

GET/v1/price/ltc

Live Price

Returns the current LTC/USD price with 24-hour percentage change. Cached for up to 60 seconds.

Request

curl https://api.coinsflow.net/v1/price/ltc \
  -H "X-API-Key: cf_live_your_key_here"

Response

json

{
  "coin": "litecoin",
  "symbol": "LTC",
  "price_usd": 87.43,
  "change_24h": -2.14,
  "updated_at": 1714003260
}

Payment Gateway

Accept Litecoin payments directly into your balance. Create invoices, track payment status in real time, and withdraw to any LTC address.

POST/invoices/create

Create Invoice

Generate a new Litecoin payment invoice with a unique deposit address. Set amount_ltc for a fixed-price invoice, or omit it to create an open invoice that accepts any amount.

Parameters

Name	Type	Description
`amount_ltc`	number	Optional fixed amount in LTC. Leave empty to create an open invoice.
`expires_in_minutes`	integer	Minutes until invoice expires. Default: 60.
`description`	string	Optional description shown on the hosted invoice page.
`tolerance_percent`	number	Underpayment tolerance %. Default: 2.

Request

curl -X POST https://api.coinsflow.net/invoices/create \
  -H "X-API-Key: cf_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"amount_ltc":0.01,"expires_in_minutes":60,"description":"Order #1234"}'

Response

json

{
  "invoice_id": "1cd4fbb8-9468-4685-b03e-ae22975e771e",
  "ltc_address": "LSngLEpvKjCiKkggXrtEJrrddWgiDhHxLB",
  "amount_ltc": 0.01,
  "tolerance_percent": 2,
  "status": "pending",
  "expires_at": "2024-04-26T17:50:52.82+00:00",
  "created_at": "2024-04-26T16:50:52.95+00:00",
  "invoice_url": "https://www.coinsflow.net/invoice/1cd4fbb8-..."
}

GET/balance

Get Balance

Returns your current confirmed LTC balance and its USD equivalent. Balance is credited automatically when invoices reach confirmed status.

Request

curl https://api.coinsflow.net/balance \
  -H "X-API-Key: cf_live_your_key_here"

Response

json

{
  "balance_ltc": 0.05241800,
  "balance_usd": 4.58,
  "updated_at": "2024-04-26T18:03:14+00:00"
}

POST/payout

Send Payout

Withdraw LTC from your balance to any Litecoin address. CoinsFlow keeps a 0.5% service fee, and network fee is also deducted from the payout amount (not paid by CoinsFlow).

Parameters

Name	Type	Description
`to_address`req	string	Destination Litecoin address (L/M/ltc1 format).
`amount_ltc`req	number	Amount in LTC to send. Must not exceed your balance.

Request

curl -X POST https://api.coinsflow.net/payout \
  -H "X-API-Key: cf_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"to_address":"LXqvJaXc9xC8UjFEDRTDjzD8bNHzMpBMQJ","amount_ltc":0.005}'

Response

json

{
  "payout_id": "a7f3c9e2-1b4d-4c8a-9d2f-3e7b1a5f8c4d",
  "tx_hash": "4a2d9f1e3c8b7a6d...",
  "requested_amount_ltc": 0.005,
  "sent_amount_ltc": 0.004947,
  "service_fee_ltc": 0.000025,
  "fee_ltc": 0.000028,
  "total_fees_ltc": 0.000053,
  "to_address": "LXqvJaXc9xC8UjFEDRTDjzD8bNHzMpBMQJ",
  "new_balance_ltc": 0.047365,
  "status": "sent"
}

Missing something? Contact support or visit your dashboard.