Documentation

MilyPay API

Pay-per-call Australian data for AI agents, settled in AUD stablecoins on the x402 rail. Five services: business identity, company register, address, super funds, and weather. Responses are JSON. No API keys.

Base URL https://api.milypay.xyz

Catalog pay.sh · namespace milysec/*

Agent guide: /agents.md · Try it: /demo

Payments (x402)

The API host charges per call over the x402 protocol, settled in AUDD on Solana via the PayAI facilitator. An unpaid request returns 402 with a base64 PAYMENT-REQUIRED challenge (price, asset, network, pay-to). An x402-aware client pays and retries with a PAYMENT-SIGNATURE header; the data returns in the same round-trip.

The same endpoints on the website host https://milypay.xyz/api/... and the live demo are free and per-IP rate limited, so you can try every service without paying. To run the real paid round-trip with a Solana wallet, see /pay.

# Paid (agents): returns 402, then pay + retry
curl https://api.milypay.xyz/au-business/abn/33051775556
 
# Free (try it): same data, no payment
curl https://milypay.xyz/api/au-business/abn/33051775556

Business identity

milysec/au-business · Australian Business Register (ATO)

Look up Australian businesses by ABN, ACN, or name.

GET /au-business/abn/{abn}

Entity name, status, type, ACN, GST, business names, and location for an 11-digit ABN.

Request

curl https://api.milypay.xyz/au-business/abn/33051775556

Response

{
  "abn": "33051775556",
  "abnStatus": "Active",
  "acn": "051775556",
  "entityName": "TELSTRA CORPORATION LIMITED",
  "entityType": "Australian Public Company",
  "businessNames": ["YELLOW PAGES", "WHEREIS", "..."],
  "gstRegistered": true,
  "state": "VIC",
  "postcode": "3000"
}
GET /au-business/acn/{acn}

Same entity record, resolved from a 9-digit ACN.

Request

curl https://api.milypay.xyz/au-business/acn/051775556

Response

{ "abn": "33051775556", "entityName": "TELSTRA CORPORATION LIMITED", "...": "..." }
GET /au-business/search?name={name}

Matching ABNs for a business or entity name. Optional maxResults (default 10).

Request

curl "https://api.milypay.xyz/au-business/search?name=woolworths"

Response

{
  "matches": [
    { "abn": "88000014675", "name": "WOOLWORTHS", "nameType": "Business Name",
      "abnStatus": "Active", "state": "NSW", "postcode": "2153", "score": 99 }
  ]
}

Company register

milysec/au-company · ASIC Company Register (data.gov.au)

ASIC company records: status, type, class, registration dates, and former names.

GET /au-company/acn/{acn}

Company details for an ACN, including former names.

Request

curl https://api.milypay.xyz/au-company/acn/000014675

Response

{
  "acn": "000014675",
  "abn": "88000014675",
  "name": "Woolworths Group Limited",
  "status": "Registered",
  "type": "Australian public company",
  "class": "Limited by shares",
  "registrationDate": "1924-09-22",
  "deregistrationDate": null,
  "formerNames": ["Woolworths Ltd"]
}
GET /au-company/search?name={name}

Companies matching a name, across current and former names.

Request

curl "https://api.milypay.xyz/au-company/search?name=commonwealth bank"

Response

{
  "matches": [
    { "acn": "123123124", "name": "Commonwealth Bank Of Australia",
      "status": "Registered", "formerName": false }
  ]
}

Address

milysec/au-address · G-NAF (Geoscape Australia)

Validate, search, and geocode any Australian address from the 16.9M-record G-NAF.

GET /au-address/validate?q={address}

Best canonical match for a freeform address, with GNAF PID and geocode.

Request

curl "https://api.milypay.xyz/au-address/validate?q=1 bligh st sydney"

Response

{
  "valid": true,
  "match": {
    "address": "1 Bligh Street, Sydney NSW 2000",
    "gnafPid": "GANSW717886958",
    "locality": "Sydney", "state": "NSW", "postcode": "2000",
    "lat": -33.86486428, "lng": 151.2105094
  }
}
GET /au-address/search?q={address}

Ranked address matches for autocomplete. Optional limit (default 8).

Request

curl "https://api.milypay.xyz/au-address/search?q=120 collins st melbourne"

Response

{ "count": 1, "results": [ { "address": "120 Collins Street, Melbourne VIC 3000", "...": "..." } ] }
GET /au-address/geocode?q={address}

Latitude and longitude for the best-matching address.

Request

curl "https://api.milypay.xyz/au-address/geocode?q=200 adelaide st brisbane"

Response

{ "found": true, "lat": -27.46831, "lng": 153.02356,
  "address": "200 Adelaide Street, Brisbane City QLD 4000", "gnafPid": "GAQLD..." }

Super funds

milysec/au-super · Super Fund Lookup (ATO)

Verify any Australian superannuation fund by ABN.

GET /au-super/abn/{abn}

Fund name, status, type, complying status, and USIs/products.

Request

curl https://api.milypay.xyz/au-super/abn/65714394898

Response

{
  "abn": "65714394898",
  "abnStatus": "Active",
  "fundName": "The Trustee for AUSTRALIANSUPER",
  "fundType": "APRA Regulated Public Offer Fund",
  "complyingStatus": "APRA Registered",
  "state": "VIC", "postcode": "3000",
  "products": [ { "usi": "STA0100AU", "productName": "AustralianSuper", "contributionsRestricted": false } ]
}

Weather

milysec/au-weather · Open-Meteo (BOM ACCESS-G)

Current conditions and forecast for any Australian address or coordinate.

GET /au-weather?q={address} · ?lat={lat}&lng={lng}

Geocodes the address (via G-NAF) then returns current conditions and a daily forecast. Optional days (default 7).

Request

curl "https://api.milypay.xyz/au-weather?q=120 collins st melbourne&days=3"

Response

{
  "location": { "address": "120 Collins Street, Melbourne VIC 3000", "lat": -37.81, "lng": 144.97 },
  "current": { "temperature": 15.4, "apparentTemperature": 13.9, "humidity": 78,
    "windSpeed": 15, "weather": "Mainly clear" },
  "daily": [ { "date": "2026-06-02", "tempMax": 16, "tempMin": 11, "weather": "Drizzle" } ]
}

Postage

milysec/au-postage · Australia Post (Postage Assessment Calculator)

Australia Post parcel rates and service options between postcodes, domestic or international.

GET /au-postage?from={pc}&to={pc}&weight={kg}

Domestic parcel services and prices. Optional length/width/height in cm.

Request

curl "https://api.milypay.xyz/au-postage?from=3000&to=2000&weight=2"

Response

{
  "from": "3000", "to": "2000",
  "services": [
    { "code": "AUS_PARCEL_REGULAR", "name": "Parcel Post", "price": 19.30 },
    { "code": "AUS_PARCEL_EXPRESS", "name": "Express Post", "price": 23.80 }
  ]
}
GET /au-postage?country={cc}&weight={kg}

International parcel services for a 2-letter country code.

Request

curl "https://api.milypay.xyz/au-postage?country=US&weight=1"

Response

{ "country": "US", "services": [ { "code": "...", "name": "...", "price": 0 } ] }

Market data (third-party)

milysec/markets · Birdeye (birdeye/data on pay.sh), resold by MilyPay

Solana and multi-chain DeFi data - token prices, overviews, security, holders, trending. You pay MilyPay in AUDD; MilyPay pays Birdeye in USDC. Paid-only (no free tier, since each call costs us upstream). Path maps to Birdeye's /x402/* endpoints (47 available).

GET /markets/defi/price?address={mint}&chain=solana

Real-time token price.

Request

curl "https://api.milypay.xyz/markets/defi/price?address=So11111111111111111111111111111111111111112&chain=solana"

Response

{ "success": true, "data": { "value": 67.94, "priceChange24h": -5.98, "updateUnixTime": 1780611789 } }
GET /markets/defi/token_overview?address={mint}&chain=solana

Full token snapshot: price, volume, liquidity, market cap, metadata.

Request

curl "https://api.milypay.xyz/markets/defi/token_overview?address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&chain=solana"

Response

{ "data": { "name": "Bonk", "price": 0.0000047, "liquidity": 2397911, "marketCap": 391882289 } }
GET /markets/defi/token_security?address={mint}&chain=solana

Security and rug-risk indicators for a token.

Request

curl "https://api.milypay.xyz/markets/defi/token_security?address={mint}&chain=solana"

Response

{ "data": { "...": "security analysis" } }

Data & attribution

  • Business and super: Australian Business Register and Super Fund Lookup, Australian Taxation Office.
  • Company: ASIC Company Register, published open on data.gov.au.
  • Address: Incorporates G-NAF © Geoscape Australia, open G-NAF licence. Per-call lookups only.
  • Weather: Open-Meteo.com (CC BY 4.0), Australian model BOM ACCESS-G.

Rate limits apply on the free host (per IP). Government data is provided as-is; verify against primary sources where required.