{
  "x402Version": 2,
  "id": 72091,
  "slug": "saylorinnovations-api-hn-top",
  "resource": "https://saylorinnovations.com/api/hn/top",
  "description": "Hacker News front page - current top, new, Ask HN or Show HN stories with rank, points, comments and links",
  "type": "http",
  "serviceName": "Saylor Innovations Data Desk",
  "mimeType": "application/json",
  "resourceType": "API",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:137",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:42161",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "So11111111111111111111111111111111111111112",
      "amount": "95877",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    }
  ],
  "outputSchema": {
    "type": "object",
    "properties": {
      "kind": {
        "type": "string",
        "description": "Kind of record"
      },
      "returned": {
        "type": "number",
        "description": "Number of items in this response"
      },
      "stories": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "rank": {
              "type": "number",
              "description": "Rank, 1 is highest"
            },
            "title": {
              "type": [
                "string",
                "null"
              ],
              "description": "Title"
            },
            "url": {
              "type": [
                "string",
                "null"
              ],
              "description": "Canonical URL"
            },
            "points": {
              "type": [
                "number",
                "null"
              ]
            },
            "comments": {
              "type": [
                "number",
                "null"
              ]
            },
            "hn_url": {
              "type": "string",
              "description": "Hn URL"
            },
            "author": {
              "description": "Author name"
            },
            "created_at": {
              "description": "Created at (UTC unless a time zone is given)"
            }
          }
        }
      },
      "source": {
        "type": [
          "string",
          "null"
        ],
        "description": "Data source the values come from"
      },
      "checked_at": {
        "type": [
          "string",
          "null"
        ],
        "description": "Time the check was run (UTC)"
      }
    },
    "required": [
      "kind",
      "stories"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "kind": "top",
            "limit": "10"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "kind": "top",
            "returned": 10,
            "stories": [
              {
                "rank": 1,
                "title": "Muse Wonder",
                "url": "https://research.meta.ai/blog/muse-wonder",
                "points": 482,
                "comments": 257,
                "author": "meetpateltech",
                "created_at": "2026-10-12T16:48:01Z",
                "hn_url": "https://news.ycombinator.com/item?id=50059115"
              },
              {
                "rank": 2,
                "title": "Codex CLI installs a persistent, self-updating background daemon by default",
                "url": "https://github.com/openai/codex/issues/48195",
                "points": 399,
                "comments": 217,
                "author": "whimblepop",
                "created_at": "2026-10-12T18:29:04Z",
                "hn_url": "https://news.ycombinator.com/item?id=50060694"
              },
              {
                "rank": 3,
                "title": "GLM-Legal",
                "url": "https://z.ai/blog/glm-legal",
                "points": 380,
                "comments": 217,
                "author": "ilreb",
                "created_at": "2026-10-12T16:11:45Z",
                "hn_url": "https://news.ycombinator.com/item?id=50058507"
              }
            ],
            "source": "Hacker News via Algolia"
          }
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "type": "string",
                "enum": [
                  "GET"
                ]
              },
              "queryParams": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "description": "optional top (default), new, ask or show"
                  },
                  "limit": {
                    "type": "string",
                    "description": "optional 1-30, default 15"
                  }
                }
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "description": "Kind of record"
                  },
                  "returned": {
                    "type": "number",
                    "description": "Number of items in this response"
                  },
                  "stories": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "rank": {
                          "type": "number",
                          "description": "Rank, 1 is highest"
                        },
                        "title": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Title"
                        },
                        "url": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Canonical URL"
                        },
                        "points": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "comments": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "hn_url": {
                          "type": "string",
                          "description": "Hn URL"
                        },
                        "author": {
                          "description": "Author name"
                        },
                        "created_at": {
                          "description": "Created at (UTC unless a time zone is given)"
                        }
                      }
                    }
                  },
                  "source": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Data source the values come from"
                  },
                  "checked_at": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Time the check was run (UTC)"
                  }
                },
                "required": [
                  "kind",
                  "stories"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "hacker news",
    "front page",
    "top stories",
    "trending tech",
    "ask hn show hn"
  ],
  "sourceHost": "saylorinnovations.com",
  "lastUpdated": "2026-10-26T22:14:01.846Z",
  "quality": {},
  "metadata": {
    "serviceName": "Saylor Innovations Data Desk",
    "method": "GET",
    "mimeType": "application/json",
    "inputSchema": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "description": "optional top (default), new, ask or show"
        },
        "limit": {
          "type": "string",
          "description": "optional 1-30, default 15"
        }
      },
      "required": []
    },
    "exampleResponse": {
      "kind": "top",
      "returned": 10,
      "stories": [
        {
          "rank": 1,
          "title": "Muse Wonder",
          "url": "https://research.meta.ai/blog/muse-wonder",
          "points": 482,
          "comments": 257,
          "author": "meetpateltech",
          "created_at": "2026-10-12T16:48:01Z",
          "hn_url": "https://news.ycombinator.com/item?id=50059115"
        },
        {
          "rank": 2,
          "title": "Codex CLI installs a persistent, self-updating background daemon by default",
          "url": "https://github.com/openai/codex/issues/48195",
          "points": 399,
          "comments": 217,
          "author": "whimblepop",
          "created_at": "2026-10-12T18:29:04Z",
          "hn_url": "https://news.ycombinator.com/item?id=50060694"
        },
        {
          "rank": 3,
          "title": "GLM-Legal",
          "url": "https://z.ai/blog/glm-legal",
          "points": 380,
          "comments": 217,
          "author": "ilreb",
          "created_at": "2026-10-12T16:11:45Z",
          "hn_url": "https://news.ycombinator.com/item?id=50058507"
        }
      ],
      "source": "Hacker News via Algolia"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "kind": "top",
              "limit": "10"
            }
          },
          "output": {
            "type": "json",
            "example": {
              "kind": "top",
              "returned": 10,
              "stories": [
                {
                  "rank": 1,
                  "title": "Muse Wonder",
                  "url": "https://research.meta.ai/blog/muse-wonder",
                  "points": 482,
                  "comments": 257,
                  "author": "meetpateltech",
                  "created_at": "2026-10-12T16:48:01Z",
                  "hn_url": "https://news.ycombinator.com/item?id=50059115"
                },
                {
                  "rank": 2,
                  "title": "Codex CLI installs a persistent, self-updating background daemon by default",
                  "url": "https://github.com/openai/codex/issues/48195",
                  "points": 399,
                  "comments": 217,
                  "author": "whimblepop",
                  "created_at": "2026-10-12T18:29:04Z",
                  "hn_url": "https://news.ycombinator.com/item?id=50060694"
                },
                {
                  "rank": 3,
                  "title": "GLM-Legal",
                  "url": "https://z.ai/blog/glm-legal",
                  "points": 380,
                  "comments": 217,
                  "author": "ilreb",
                  "created_at": "2026-10-12T16:11:45Z",
                  "hn_url": "https://news.ycombinator.com/item?id=50058507"
                }
              ],
              "source": "Hacker News via Algolia"
            }
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "input": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "http"
                },
                "method": {
                  "type": "string",
                  "enum": [
                    "GET"
                  ]
                },
                "queryParams": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "description": "optional top (default), new, ask or show"
                    },
                    "limit": {
                      "type": "string",
                      "description": "optional 1-30, default 15"
                    }
                  }
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "description": "Kind of record"
                    },
                    "returned": {
                      "type": "number",
                      "description": "Number of items in this response"
                    },
                    "stories": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "rank": {
                            "type": "number",
                            "description": "Rank, 1 is highest"
                          },
                          "title": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Title"
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Canonical URL"
                          },
                          "points": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "comments": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "hn_url": {
                            "type": "string",
                            "description": "Hn URL"
                          },
                          "author": {
                            "description": "Author name"
                          },
                          "created_at": {
                            "description": "Created at (UTC unless a time zone is given)"
                          }
                        }
                      }
                    },
                    "source": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Data source the values come from"
                    },
                    "checked_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Time the check was run (UTC)"
                    }
                  },
                  "required": [
                    "kind",
                    "stories"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/hn/top?kind=top&limit=10",
        "expectedStatus": 402
      }
    ],
    "cacheTtlSeconds": 0,
    "capabilities": [],
    "noAccountRequired": true,
    "noApiKeyRequired": true,
    "sideEffects": "Paid calls settle the advertised payment; see the provider contract for execution behavior.",
    "payment": {
      "protocol": "x402",
      "settlement": "direct-to-provider"
    },
    "provider": {
      "name": "Saylor Innovations",
      "host": "saylorinnovations.com",
      "manifestUrl": "https://saylorinnovations.com/.well-known/x402.json"
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": true,
  "featured": false,
  "provider": {
    "host": "saylorinnovations.com",
    "manifest_name": "Saylor Innovations Knowledge Base",
    "source": "submitted",
    "source_manifest_url": "https://saylorinnovations.com/.well-known/x402.json",
    "submitted_at": "2026-10-26T05:52:02.113Z"
  },
  "exampleResponse": {
    "kind": "string",
    "returned": 0,
    "stories": [
      {
        "rank": 0,
        "title": "string",
        "url": "string",
        "points": 0,
        "comments": 0,
        "hn_url": "string",
        "author": null,
        "created_at": null
      }
    ],
    "source": "string",
    "checked_at": "string"
  }
}