Flashnet

https://docs.flashnet.xyz/
Admin
Flashnet is a modular exchange stack for Bitcoin, designed to rival TradFi exchange performance...
Tokens:99,028
Snippets:734
Trust Score:6.2
Update:1 month ago
Show doc for...
Tokens:
Raw
### Exact-in source-side affiliate-fee example (solana:SOL -> spark:BTC)

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

Example request for source-side affiliate fees.

```json
{
  "sourceChain": "solana",
  "sourceAsset": "SOL",
  "destinationChain": "spark",
  "destinationAsset": "BTC",
  "amount": "100000000",
  "recipientAddress": "spark1...",
  "appFees": [
    {
      "recipient": "Dtkxt55zEUDj6NTXGRtH8uQsACsTjoSVkXfYBEF8xkkT",
      "fee": 100
    }
  ]
}
```

--------------------------------

### User Summary API Response Example

Source: https://docs.flashnet.xyz/rewards/integrators/api

Example JSON response for the Get User Summary endpoint, detailing a user's financial and rewards status.

```json
{
  "pubkey": "02abc...def",
  "usdbBalance": {
    "raw": "10000000000",
    "display": "10000"
  },
  "volumeUtcToday": {
    "swapSats": 5000000,
    "swapCount": 12
  },
  "rewardsBracket": 3,
  "rewardsPercent": 5.0,
  "estimatedSatsToday": 1370
}
```

--------------------------------

### Get Endorsements API Response Example

Source: https://docs.flashnet.xyz/rewards/integrators/api

Example JSON response for the Get Endorsements endpoint, showing the endorser's public key and a list of recipients with their allocated ratio in basis points.

```json
{
  "endorser": "02abc...def",
  "endorsements": [
    {
      "to": "03fed...cba",
      "ratioBps": 3000
    },
    {
      "to": "02012...999",
      "ratioBps": 2000
    }
  ]
}
```

--------------------------------

### GET /v1/orchestration/estimate Response Example

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

The response object provides details on estimated output, fees, and route information for the requested orchestration.

```json
{
  "estimatedOut": "string",
  "feeAmount": "string",
  "feeBps": 5,
  "totalFeeAmount": "string",
  "feeAsset": "USDC",
  "feeAssetDetails": {
    "chain": "solana",
    "asset": "USDC",
    "decimals": 6
  },
  "feeAmountUsd": "string",
  "totalFeeAmountUsd": "string",
  "route": ["USDC", "USDB", "BTC"],
  "source": {
    "chain": "base",
    "asset": "USDC",
    "chainDisplayName": "Base",
    "chainIcon": "/chain-base.svg",
    "contractAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "decimals": 6,
    "chainId": "8453"
  },
  "destination": {
    "chain": "spark",
    "asset": "BTC",
    "chainDisplayName": "Spark",
    "chainIcon": "/chain-spark.svg",
    "contractAddress": null,
    "decimals": 8,
    "chainId": null
  }
}
```

--------------------------------

### Response structure for GET /v1/orchestration/routes

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

Example JSON response containing a list of routes with source and destination asset details and eligibility flags.

```json
{
  "routes": [
    {
      "sourceChain": "base",
      "sourceAsset": "USDC",
      "destinationChain": "spark",
      "destinationAsset": "BTC",
      "exactOutEligible": false,
      "fixedEligible": true,
      "source": {
        "chain": "base",
        "asset": "USDC",
        "chainDisplayName": "Base",
        "chainIcon": "/chain-base.svg",
        "contractAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "decimals": 6,
        "chainId": "8453"
      },
      "destination": {
        "chain": "spark",
        "asset": "BTC",
        "chainDisplayName": "Spark",
        "chainIcon": "/chain-spark.svg",
        "contractAddress": null,
        "decimals": 8,
        "chainId": null
      }
    },
    {
      "sourceChain": "base",
      "sourceAsset": "USDC",
      "destinationChain": "solana",
      "destinationAsset": "USDT",
      "exactOutEligible": false,
      "fixedEligible": false,
      "source": {
        "chain": "base",
        "asset": "USDC",
        "chainDisplayName": "Base",
        "chainIcon": "/chain-base.svg",
        "contractAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "decimals": 6,
        "chainId": "8453"
      },
      "destination": {
        "chain": "solana",
        "asset": "USDT",
        "chainDisplayName": "Solana",
        "chainIcon": "/chain-solana.svg",
        "contractAddress": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
        "decimals": 6,
        "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
      }
    }
  ]
}
```

--------------------------------

### GET /v1/orchestration/history response

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

Example JSON response containing a list of orders.

```json
{
  "orders": [{ "id": "ord_...", "status": "completed" }]
}
```

--------------------------------

### GET /v1/affiliates

Source: https://docs.flashnet.xyz/products/orchestration/api/resources

List all affiliate profiles for your partner account.

```bash
curl -sS "https://orchestration.flashnet.xyz/v1/affiliates?includeDisabled=true" \
  -H "Authorization: Bearer fn_..."
```

--------------------------------

### Payout History API Response Example

Source: https://docs.flashnet.xyz/rewards/integrators/api

Example JSON response for the Get Payout History endpoint, detailing past rewards and endorsement payouts for a user.

```json
{
  "pubkey": "02abc...def",
  "payouts": [
    {
      "day": "2026-02-09",
      "usdbBalance": {
        "raw": 10000000000,
        "display": 10000
      },
      "volume": {
        "swapSats": 5000000
      },
      "rewardsBracket": 3,
      "annualRewardsBps": 500,
      "rewardsPayoutSats": 1020,
      "endorsementsPayoutSats": 350,
      "payoutSats": 1370,
      "status": "paid",
      "txId": "abc123...",
      "createdAt": "2026-02-09T00:05:00Z",
      "paidAt": "2026-02-10T00:05:00Z"
    }
  ],
  "pagination": { "total": 45, "limit": 30, "offset": 0 }
}
```

--------------------------------

### GET /v1/orchestration/limits response

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

Example JSON response for a Bitcoin to Solana route, including the limits object and applicable constraints.

```json
{
  "generatedAt": "2026-07-13T12:00:00.000Z",
  "routes": [
    {
      "sourceChain": "bitcoin",
      "sourceAsset": "BTC",
      "destinationChain": "solana",
      "destinationAsset": "USDC",
      "direction": "sell",
      "exactOutEligible": true,
      "fixedEligible": true,
      "source": {
        "chain": "bitcoin",
        "asset": "BTC",
        "chainDisplayName": "Bitcoin",
        "chainIcon": "/btc.svg",
        "contractAddress": null,
        "decimals": 8,
        "chainId": null
      },
      "destination": {
        "chain": "solana",
        "asset": "USDC",
        "chainDisplayName": "Solana",
        "chainIcon": "/chain-solana.svg",
        "contractAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "decimals": 6,
        "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
      },
      "limits": {
        "orderNotionalUsd": {
          "minCents": "80",
          "maxCents": "2000000",
          "source": "runtime_order_bounds"
        },
        "exactIn": {
          "supported": true,
          "requestAmount": {
            "leg": "source",
            "chain": "bitcoin",
            "asset": "BTC",
            "minAmountSmallest": "5149",
            "maxAmountSmallest": null,
            "minUsdCents": "80",
            "maxUsdCents": "2000000"
          },
          "constraints": ["order_notional_usd", "flashnet_btc_swap_input_min"]
        },
        "exactOut": {
          "supported": true,
          "requestAmount": {
            "leg": "destination",
            "chain": "solana",
            "asset": "USDC",
            "minAmountSmallest": null,
            "maxAmountSmallest": null,
            "minUsdCents": "80",
            "maxUsdCents": "2000000"
          },
          "constraints": ["order_notional_usd"]
        },
        "fiatUsd": null,
        "dynamicProviderLimits": {
          "possible": false,
          "components": [],
          "description": null
        },
        "constraints": [
          {
            "id": "order_notional_usd",
            "amountMode": "all",
            "leg": "route",
            "source": "runtime_order_bounds",
            "description": "Runtime USD notional bounds apply to estimate, quote, submit, and onramp when the route amount can be priced.",
            "chain": null,
            "asset": null,
            "minAmountSmallest": null,
            "maxAmountSmallest": null,
            "minUsdCents": "80",
            "maxUsdCents": "2000000"
          },
          {
            "id": "flashnet_btc_swap_input_min",
            "amountMode": "exact_in",
            "leg": "source",
            "source": "flashnet_static_limit",
            "description": "Bitcoin L1 source quotes must leave at least 5000 sats after the static deposit fee.",
            "chain": "bitcoin",
            "asset": "BTC",
            "minAmountSmallest": "5149",
            "maxAmountSmallest": null,
            "minUsdCents": null,
            "maxUsdCents": null
          }
        ]
      }
    }
  ]
}
```

--------------------------------

### GET /v1/orchestration/limits request

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

Example cURL request to fetch limits for a specific Bitcoin to Solana route.

```bash
curl -sS "https://orchestration.flashnet.xyz/v1/orchestration/limits?sourceChain=bitcoin&sourceAsset=BTC&destinationChain=solana&destinationAsset=USDC"
```

--------------------------------

### Rewards Leaderboard API Response Example

Source: https://docs.flashnet.xyz/rewards/integrators/api

Example JSON response for the Get Rewards Leaderboard endpoint, showing user rewards data including balance, today's volume, rewards bracket, and percentage.

```json
{
  "rewards": [
    {
      "pubkey": "02abc...def",
      "usdbBalance": {
        "raw": "10000000000",
        "display": "10000"
      },
      "volumeUtcToday": {
        "swapSats": 5000000,
        "swapCount": 12
      },
      "rewardsBracket": 3,
      "rewardsPercent": 5.0,
      "estimatedSatsToday": 1370
    }
  ],
  "meta": {
    "total": 830,
    "limit": 100,
    "offset": 0
  }
}
```

--------------------------------

### GET /v1/liquidation-addresses

Source: https://docs.flashnet.xyz/products/orchestration/api/resources

List all enabled liquidation addresses.

```bash
curl -sS "https://orchestration.flashnet.xyz/v1/liquidation-addresses" \
  -H "Authorization: Bearer fn_..."
```

--------------------------------

### Verify attestation with JavaScript

Source: https://docs.flashnet.xyz/products/orchestration/tee-attestation

This example demonstrates how to fetch, decode, and verify the attestation document using the cborg library.

```javascript
import { decode } from "cborg";

const nonce = crypto.randomUUID();
const resp = await fetch(
  `https://orchestration.flashnet.xyz/v1/attestation?nonce=${nonce}`
);
const { document } = await resp.json();

// Decode base64 -> COSE_Sign1 -> payload
const raw = Uint8Array.from(atob(document), (c) => c.charCodeAt(0));
const cose = decode(raw, { useMaps: true });
const payload = decode(cose[2], { useMaps: true });

// Convert to object
const doc = Object.fromEntries(
  [...payload.entries()].map(([k, v]) => [String(k), v])
);

// Verify nonce matches
const returnedNonce = new TextDecoder().decode(doc.nonce);
console.assert(returnedNonce === nonce, "Nonce mismatch");

// Read PCR0 (enclave image hash)
const pcr0 = Array.from(doc.pcrs.get(0))
  .map((b) => b.toString(16).padStart(2, "0"))
  .join("");
console.log("PCR0:", pcr0);

// Certificate chain depth
console.log("Cert chain:", doc.cabundle.length, "certificates");
```

--------------------------------

### PUT /v1/affiliates/:affiliateId Request Body Example

Source: https://docs.flashnet.xyz/products/orchestration/api/resources

Example JSON request body for an EVM USDC payout destination.

```json
{
  "feeBps": 50,
  "payoutChain": "base",
  "payoutAsset": "USDC",
  "payoutAddress": "0xYourBaseUsdcAddress"
}
```

--------------------------------

### Pay Link URL example

Source: https://docs.flashnet.xyz/products/orchestration/pay-links

A sample Pay Link URL that redirects to a Lightning-compatible payment app.

```text
https://orchestration.flashnet.xyz/pay/DNHKySOZ
```

--------------------------------

### Exact-in with multiple affiliates (spark:BTC -> solana:USDC)

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

Example request specifying multiple affiliate IDs.

```json
{
  "sourceChain": "spark",
  "sourceAsset": "BTC",
  "destinationChain": "solana",
  "destinationAsset": "USDC",
  "amount": "100000",
  "recipientAddress": "So1RecipientAddress...",
  "affiliateIds": ["referrer-alice", "platform-fee"]
}
```

--------------------------------

### POST /v1/liquidation-addresses response

Source: https://docs.flashnet.xyz/products/orchestration/api/resources

Example response from creating a liquidation address, showing the frozen fee plan.

```json
{
  "liquidationAddressId": "liq_...",
  "sparkAddress": "spark1...",
  "l1DepositAddress": "bc1...",
  "destination": { "chain": "ethereum", "asset": "USDC", "address": "0x..." },
  "feeBps": 5,
  "slippageBps": 50,
  "enabled": true,
  "createdAt": "2026-02-04T01:00:00.000Z",
  "appFees": [
    {
      "affiliateId": "platform-fee",
      "recipient": "So1PlatformPayoutAddress...",
      "feeBps": 25
    }
  ]
}
```

--------------------------------

### GET /v1/orchestration/estimate JSON Response

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

Example JSON response structure for the estimate endpoint, including fee details, app fee breakdowns, and source/destination chain information.

```json
{
  "estimatedOut": "string",
  "feeAmount": "string",
  "feeBps": 5,
  "totalFeeAmount": "string",
  "appFeeAmount": "string",
  "appFeePlatformCutAmount": "string",
  "appFees": [
    {
      "recipient": "So1AffiliateOne...",
      "feeBps": 100,
      "amount": "string",
      "platformCutAmount": "string",
      "recipientAmount": "string"
    }
  ],
  "feeAsset": "USDC",
  "route": ["USDC", "USDB", "BTC"],
  "source": { "chain": "base", "asset": "USDC", "chainDisplayName": "Base", "chainIcon": "/chain-base.svg", "contractAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6, "chainId": "8453" },
  "destination": { "chain": "spark", "asset": "BTC", "chainDisplayName": "Spark", "chainIcon": "/chain-spark.svg", "contractAddress": null, "decimals": 8, "chainId": null }
}
```

--------------------------------

### Fixed Delivery and Affiliate Configuration

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

Examples of request bodies for quote and order operations, demonstrating fixed delivery modes and various affiliate fee structures.

```APIDOC
## Fixed Delivery and Affiliate Configuration

### Description
This section provides examples for configuring quote and order requests, including exact-out payment intents, Lightning network transactions, and various affiliate fee structures such as app fees, affiliate IDs, and fee basis point overrides.

### Request Body Examples

**Exact-out payment-intent example:**
```json
{
  "sourceChain": "bitcoin",
  "sourceAsset": "BTC",
  "destinationChain": "base",
  "destinationAsset": "USDC",
  "amount": "100000000",
  "amountMode": "exact_out",
  "recipientAddress": "0xYourBaseUsdcAddress",
  "refundAddress": "bc1qyourrefundaddress...",
  "slippageBps": 0
}
```

**Exact-in affiliate-fee example:**
```json
{
  "sourceChain": "spark",
  "sourceAsset": "BTC",
  "destinationChain": "solana",
  "destinationAsset": "USDC",
  "amount": "100000",
  "recipientAddress": "So1RecipientAddress...",
  "appFees": [
    {
      "recipient": "So1AffiliateOne...",
      "fee": 100
    },
    {
      "recipient": "So1AffiliateTwo...",
      "fee": 50
    }
  ]
}
```

**Exact-in with per-quote feeBps override:**
```json
{
  "sourceChain": "spark",
  "sourceAsset": "BTC",
  "destinationChain": "solana",
  "destinationAsset": "USDC",
  "amount": "100000",
  "recipientAddress": "So1RecipientAddress...",
  "affiliateIds": [
    "referrer-alice",
    { "affiliateId": "platform-fee", "feeBps": 25 }
  ]
}
```
```

--------------------------------

### GET /v1/affiliates

Source: https://docs.flashnet.xyz/products/orchestration/api/resources

List all affiliate profiles associated with the partner.

```APIDOC
## GET /v1/affiliates

### Description
List affiliate profiles for your partner.

### Method
GET

### Endpoint
/v1/affiliates

### Parameters
#### Query Parameters
- **includeDisabled** (boolean) - Optional - Whether to include disabled profiles (default: false).
- **limit** (integer) - Optional - Max results to return (default: 200, max: 1000).
- **offset** (integer) - Optional - Number of records to skip (default: 0).
```

--------------------------------

### GET /v1/orchestration/estimate

Source: https://docs.flashnet.xyz/products/orchestration/general-swaps

Preview the price for a cross-chain swap between a source asset and a destination asset.

```APIDOC
## GET /v1/orchestration/estimate

### Description
Previews the price for a swap, returning execution metadata including the route.

### Method
GET

### Endpoint
https://orchestration.flashnet.xyz/v1/orchestration/estimate

### Parameters
#### Query Parameters
- **sourceChain** (string) - Required - The source blockchain network.
- **sourceAsset** (string) - Required - The asset to be swapped.
- **destinationChain** (string) - Required - The target blockchain network.
- **destinationAsset** (string) - Required - The target asset to receive.
- **amount** (string) - Required - The amount of the source asset to swap, denominated in wei.
```

--------------------------------

### GET /v1/orchestration/estimate

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

A lightweight, stateless request to preview prices without creating a durable order or allocating a deposit address.

```bash
curl -sS "https://orchestration.flashnet.xyz/v1/orchestration/estimate?sourceChain=base&sourceAsset=USDC&destinationChain=spark&destinationAsset=BTC&amount=100000000"
```

--------------------------------

### GET /v1/affiliate-dashboard/payout-destinations

Source: https://docs.flashnet.xyz/products/orchestration/api/resources

Retrieve a list of all supported (chain, asset) tuples for payout destinations.

```bash
curl -sS "https://orchestration.flashnet.xyz/v1/affiliate-dashboard/payout-destinations" \
  -H "Authorization: Bearer fn_..."
```

--------------------------------

### GET /v1/affiliate-dashboard/payout-destinations

Source: https://docs.flashnet.xyz/products/orchestration/api/resources

List all supported (chain, asset) tuples for payouts.

```APIDOC
## GET /v1/affiliate-dashboard/payout-destinations

### Description
List every (chain, asset) tuple supported as a payout destination.

### Method
GET

### Endpoint
/v1/affiliate-dashboard/payout-destinations

### Response
#### Success Response (200)
- **destinations** (array) - A list of supported chain and asset objects.
```

--------------------------------

### GET /v1/affiliates/:affiliateId/claims

Source: https://docs.flashnet.xyz/products/orchestration/api/resources

List claims associated with a specific affiliate profile.

```bash
curl -sS "https://orchestration.flashnet.xyz/v1/affiliates/flashpartner/claims?limit=50" \
  -H "Authorization: Bearer fn_..."
```

--------------------------------

### Submit Order Request via cURL

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

Example of submitting an order using a POST request with the required Authorization and Idempotency-Key headers.

```bash
curl -sS -X POST "https://orchestration.flashnet.xyz/v1/orchestration/submit" \
  -H "Authorization: Bearer fn_..." \
  -H "X-Idempotency-Key: submit:$(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "quoteId": "q_...",
    "txHash": "0x..."
  }'
```

--------------------------------

### BTC to USDC with affiliate registry

Source: https://docs.flashnet.xyz/products/orchestration/btc-to-stablecoin

Example request for swapping BTC to USDC on Solana using a registered affiliate ID.

```json
{
  "sourceChain": "spark",
  "sourceAsset": "BTC",
  "destinationChain": "solana",
  "destinationAsset": "USDC",
  "amount": "100000",
  "recipientAddress": "So1RecipientAddress...",
  "affiliateId": "flashpartner"
}
```

--------------------------------

### GET /v1/liquidation-addresses/orders

Source: https://docs.flashnet.xyz/products/orchestration/api/resources

List orders associated with a specific liquidation address using an ID.

```bash
curl -sS "https://orchestration.flashnet.xyz/v1/liquidation-addresses/orders?id=liq_...&limit=50" \
  -H "Authorization: Bearer fn_..."
```

--------------------------------

### Create Pay Link with affiliateId

Source: https://docs.flashnet.xyz/products/orchestration/pay-links

Example JSON payload for creating a Pay Link that references an affiliate ID.

```json
{
  "destinationChain": "solana",
  "destinationAsset": "USDC",
  "recipientAddress": "So1...",
  "amountOut": "50000000",
  "affiliateId": "my-partner"
}
```

--------------------------------

### GET /v1/liquidation-addresses/:id

Source: https://docs.flashnet.xyz/products/orchestration/api/resources

Retrieve details for a specific liquidation address by ID.

```bash
curl -sS "https://orchestration.flashnet.xyz/v1/liquidation-addresses/liq_..." \
  -H "Authorization: Bearer fn_..."
```

--------------------------------

### Get User Points

Source: https://docs.flashnet.xyz/rewards/integrators/api

Fetches the Flashpoints balance, rank, and projected daily earnings for a specific user identified by their public key.

```bash
GET /v1/points/:pubkey
```

```json
{
  "pubkey": "02abc...def",
  "currentPoints": 1250000,
  "lifetimePoints": 1500000,
  "rank": 42,
  "projectedDailyPoints": 1236,
  "volumeUtcToday": {
    "swapSats": 5000000,
    "liquiditySats": 0
  }
}
```

--------------------------------

### BTC to USDT on Tron

Source: https://docs.flashnet.xyz/products/orchestration/btc-to-stablecoin

Example request for swapping BTC to USDT on the Tron network, including a slippageBps parameter.

```json
{
  "sourceChain": "spark",
  "sourceAsset": "BTC",
  "destinationChain": "tron",
  "destinationAsset": "USDT",
  "amount": "100000",
  "recipientAddress": "TYourTronAddress...",
  "slippageBps": 50
}
```

--------------------------------

### POST /v1/orchestration/zeroconf/accept

Source: https://docs.flashnet.xyz/products/orchestration/api/approval-flows

Accept a pending ZeroConf offer to initiate the instant-credit claim process. The request requires an idempotency key and the order ID.

```bash
curl -sS -X POST "https://orchestration.flashnet.xyz/v1/orchestration/zeroconf/accept" \
  -H "Authorization: Bearer fn_..." \
  -H "X-Idempotency-Key: zeroconf-accept:$(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "orderId": "ord_..."
  }'
```

```json
{
  "orderId": "ord_...",
  "status": "processing"
}
```

--------------------------------

### POST /v1/orchestration/zeroconf/accept

Source: https://docs.flashnet.xyz/products/orchestration/api/approval-flows

Accepts a zeroconf offer to receive instant credit.

```APIDOC
## POST /v1/orchestration/zeroconf/accept

### Description
Accepts a pending zeroconf offer to receive instant credit for the order.

### Method
POST

### Endpoint
/v1/orchestration/zeroconf/accept
```

--------------------------------

### Onramp Response Example

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

The response object containing order and quote IDs, payment links, and estimated output details.

```json
{
  "orderId": "ord_...",
  "quoteId": "q_...",
  "depositAddress": "lnbc1000n1pj...",
  "paymentLinks": {
    "cashApp": "https://cash.app/launch/lightning/lnbc1000n1pj...",
    "shortUrl": "https://orchestration.flashnet.xyz/pay/a3xKm2Rq"
  },
  "amountIn": "100000",
  "estimatedOut": "96543210",
  "feeAmount": "38536",
  "feeBps": 40,
  "totalFeeAmount": "38536",
  "feeAsset": "USDC",
  "route": ["BTC", "USDB", "USDC"],
  "expiresAt": "2026-01-15T12:04:00.000Z"
}
```

--------------------------------

### GET /v1/orchestration/routes

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

Retrieves a list of all supported trading pairs available for orchestration. This endpoint does not require authentication.

```APIDOC
## GET /v1/orchestration/routes

### Description
List all supported trading pairs. No authentication required.

### Method
GET

### Endpoint
/v1/orchestration/routes

### Response
#### Success Response (200)
- **routes** (array) - A list of supported trading pair objects.

#### Response Example
{
  "routes": [
    {
      "sourceChain": "base",
      "sourceAsset": "USDC",
      "destinationChain": "spark",
      "destinationAsset": "BTC",
      "exactOutEligible": false,
      "fixedEligible": true,
      "source": {
        "chain": "base",
        "asset": "USDC",
        "chainDisplayName": "Base",
        "chainIcon": "/chain-base.svg",
        "contractAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "decimals": 6,
        "chainId": "8453"
      },
      "destination": {
        "chain": "spark",
        "asset": "BTC",
        "chainDisplayName": "Spark",
        "chainIcon": "/chain-spark.svg",
        "contractAddress": null,
        "decimals": 8,
        "chainId": null
      }
    }
  ]
}
```

--------------------------------

### Accept a ZeroConf offer via cURL

Source: https://docs.flashnet.xyz/products/orchestration/zeroconf

Use this endpoint to accept a ZeroConf offer for instant credit. Ensure the order status is 'pending' and use a stable idempotency key.

```bash
curl -sS -X POST "https://orchestration.flashnet.xyz/v1/orchestration/zeroconf/accept" \
  -H "Authorization: Bearer fn_..." \
  -H "X-Idempotency-Key: zeroconf:accept:YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId": "ord_..."}'
```

--------------------------------

### POST /v1/affiliates/:affiliateId/claim

Source: https://docs.flashnet.xyz/products/orchestration/api/resources

Create a claim for the full available affiliate fee balance. Minimum claim amount is $1 USDC.

```bash
curl -sS -X POST "https://orchestration.flashnet.xyz/v1/affiliates/flashpartner/claim" \
  -H "Authorization: Bearer fn_..." \
  -H "X-Idempotency-Key: claim:$(uuidgen)"
```

--------------------------------

### Exact-in source-side appFees quote response

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

Example of an exact-in quote response featuring source-side application fees.

```json
{
  "quoteId": "q_...",
  "depositAddress": "So1DepositAddress...",
  "amountIn": "100000000",
  "estimatedOut": "11643",
  "feeAmount": "7893",
  "totalFeeAmount": "86749",
  "appFeeAmount": "78856",
  "appFeePlatformCutAmount": "15771",
  "appFees": [
    {
      "recipient": "Dtkxt55zEUDj6NTXGRtH8uQsACsTjoSVkXfYBEF8xkkT",
      "feeBps": 50,
      "amount": "78856",
      "platformCutAmount": "15771",
      "recipientAmount": "63085"
    }
  ],
  "feeAsset": "USDC",
  "feeBps": 5,
  "route": ["SOL", "USDC", "USDB", "BTC"],
  "expiresAt": "2026-02-11T23:55:36.296Z"
}
```

--------------------------------

### POST /v1/liquidation-addresses with inline app fees

Source: https://docs.flashnet.xyz/products/orchestration/api/resources

Create a liquidation address using inline app fee recipients.

```bash
curl -sS -X POST "https://orchestration.flashnet.xyz/v1/liquidation-addresses" \
  -H "Authorization: Bearer fn_..." \
  -H "X-Idempotency-Key: liquidation:$(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "optional",
    "destinationChain": "ethereum",
    "destinationAsset": "USDC",
    "destinationAddress": "0x...",
    "slippageBps": 50,
    "feeBps": 5,
    "appFees": [
      { "recipient": "So1FeeRecipient...", "fee": 50 }
    ]
  }'
```

--------------------------------

### Exact-in with appFees quote response

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

Example of an exact-in quote response containing multiple application fees and affiliate details.

```json
{
  "quoteId": "q_...",
  "depositAddress": "spark1...",
  "amountIn": "100000",
  "estimatedOut": "24825000",
  "feeAmount": "25000",
  "totalFeeAmount": "62125",
  "appFeeAmount": "37125",
  "appFeePlatformCutAmount": "7425",
  "appFees": [
    {
      "affiliateId": "flashpartner",
      "recipient": "So1AffiliateOne...",
      "feeBps": 50,
      "amount": "24750",
      "platformCutAmount": "4950",
      "recipientAmount": "19800"
    },
    {
      "recipient": "So1AffiliateTwo...",
      "feeBps": 50,
      "amount": "12375",
      "platformCutAmount": "2475",
      "recipientAmount": "9900"
    }
  ],
  "feeAsset": "USDC",
  "feeBps": 5,
  "route": ["BTC", "USDB", "USDC"],
  "expiresAt": "2026-02-04T02:00:00.000Z"
}
```

--------------------------------

### Exact-in with per-quote feeBps override (spark:BTC -> solana:USDC)

Source: https://docs.flashnet.xyz/products/orchestration/api/quotes-and-orders

Example request showing how to override feeBps for a specific affiliate in a single quote.

```json
{
  "sourceChain": "spark",
  "sourceAsset": "BTC",
  "destinationChain": "solana",
  "destinationAsset": "USDC",
  "amount": "100000",
  "recipientAddress": "So1RecipientAddress...",
  "affiliateIds": [
    "referrer-alice",
    { "affiliateId": "platform-fee", "feeBps": 25 }
  ]
}
```
Tokens:
Raw