---
name: darksol-agentbridge
description: Create cross-chain routes through DARKSOL AgentBridge. Use when an agent needs a normalized bridge quote/order/status/receipt flow over DARKSOL's provider-backed bridge surface instead of a spend instrument like a card or gift card.
---

# DARKSOL AgentBridge

AgentBridge is the bridge surface inside DARKSOL SpendHub.

- route id: `bridge.crosschain`
- quote: `POST https://acp.darksol.net/api/spend/quote`
- order: `POST https://acp.darksol.net/api/spend/order`
- status: `GET https://acp.darksol.net/api/spend/status?orderId=<id>`
- receipt: `GET https://acp.darksol.net/api/spend/receipt?orderId=<id>`

## Required body

```json
{
  "route": "bridge.crosschain",
  "tickerFrom": "usdc",
  "networkFrom": "base",
  "tickerTo": "usdt",
  "networkTo": "tron",
  "amount": 100,
  "address": "TYourDestinationAddress"
}
```

Fields:

- `tickerFrom` — source asset ticker
- `networkFrom` — source network
- `tickerTo` — destination asset ticker
- `networkTo` — destination network
- `amount` — requested route amount
- `address` — destination wallet address

Optional:

- `refundAddress`
- `webhook`
- `webhookKey`

## Notes

- AgentBridge includes a **0.6% DARKSOL swap fee** on supported bridge routes; those fees go toward buying and vaulting DARKSOL.
- Provider route availability, timing, and pricing are pair-dependent.
- Order creation returns normalized `orderId`, provider ID, and funding instructions when the upstream provider accepts the pair.
- Use `GET /api/spend/status?orderId=<id>` before telling a user the bridge is complete.
- Use `GET /api/spend/receipt?orderId=<id>` when you need a hashed receipt payload for support, accounting, or agent memory.

## Example

```bash
curl -X POST https://acp.darksol.net/api/spend/order \
  -H "Content-Type: application/json" \
  -d '{
    "route": "bridge.crosschain",
    "tickerFrom": "usdc",
    "networkFrom": "base",
    "tickerTo": "btc",
    "networkTo": "btc",
    "amount": 100,
    "address": "1111111111111111111114oLvT2"
  }'
```