1 · Create an orderPOST /api/v1/agent/orders
curl -X POST https://nano-seo.com/api/v1/agent/orders \
-H 'content-type: application/json' \
-H 'Idempotency-Key: 7d444840-9dc0-11e8-8443-0242ac110002' \
-d '{
"package_id": "site-10",
"target_url": "https://example.com",
"category_id": "general",
"scan_mode": "auto",
"payin_currency": "XNO",
"terms_accepted": true
}'
2 · Follow the response201 Created · example values
{
"schema_version": "1.2",
"order_id": "0f31c8a5...",
"channel": "agent",
"status": "pending_payment",
"demo": false,
"plan": { "id": "site-10", "name": "Site Audit", "page_limit": 10 },
"target_url": "https://example.com/",
"category_id": "general",
"scan": { "mode": "auto", "selected_urls": [] },
"amount": { "cents": 200, "currency": "USD", "display": "2.00" },
"payment": {
"provider": "nanswap",
"demo": false,
"status": "waiting",
"invoice_id": "inv_example",
"payin_currency": "XNO",
"currency_to_send": "XNO",
"amount_to_send": 0.125,
"amount_to_send_exact": "0.125",
"do_not_round": true,
"expected_amount_from": 0.125,
"deposit_address": "nano_example",
"deposit_tag": null,
"price_amount": 2,
"price_currency": "USD",
"fiat_price_amount": 2,
"fiat_price_currency": "USD",
"payment_url": "https://pay.example/invoice",
"expires_at": "2026-11-08T12:05:00.000Z"
},
"urls": {
"status": "https://nano-seo.com/api/v1/agent/orders/0f31c8a5...",
"report": "https://nano-seo.com/audit/0f31c8a5...",
"report_api": "https://nano-seo.com/api/v1/audits/0f31c8a5...",
"csv_export": "https://nano-seo.com/api/v1/audits/0f31c8a5.../export?format=csv",
"json_export": "https://nano-seo.com/api/v1/audits/0f31c8a5.../export?format=json"
},
"next_action": {
"action": "pay",
"method": "GET",
"status_url": "https://nano-seo.com/api/v1/agent/orders/0f31c8a5...",
"payment_url": "https://pay.example/invoice",
"invoice_id": "inv_example",
"deposit_address": "nano_example",
"deposit_tag": null,
"amount_to_send": 0.125,
"amount_to_send_exact": "0.125",
"do_not_round": true,
"currency_to_send": "XNO",
"expires_at": "2026-11-08T12:05:00.000Z",
"instruction": "Fetch this status again immediately before sending. Send exactly 0.125 XNO."
},
"polling": {
"interval_seconds": 3,
"stop_when": ["complete", "failed"],
"stop_when_actions": ["contact_support", "fetch_report"]
},
"created_at": "2026-11-08T12:00:00.000Z",
"updated_at": "2026-11-08T12:00:00.000Z"
}
Example response only. Live prices, addresses, IDs and amounts come from the API. Never send price_amount as crypto.